Afficher les statistiques sur le serveur à l'aide des API de surveillance REST

Objectif

URI

http://<IP-noeud-final-admin:Port>/ima/v1/monitor/Server

Remarques

• La commande doit être entrée avec des majuscules, comme illustré.
• Cette commande renvoie les statistiques suivantes pour tous les noeuds finaux actifs :

  Active connections

  Nombre actuel de connexions ouvertes.

  Total connections

  Nombre total de connexions qui ont été acceptées par IBM IoT MessageSight depuis que le serveur a été démarré.

  MsgRead

  Nombre de messages entrants sur toutes les connexions.

  MsgWrite

  Nombre de messages sortants sur toutes les connexions.

  BytesRead

  Nombre d'octets de données entrantes sur toutes les connexions.

  BytesWrite

  Nombre d'octets de données sortantes sur toutes les connexions.

  BadConnCount

  Nombre de connexions client sur lesquelles une connexion physique est établie mais où les messages ne peuvent pas être envoyés ou reçus. Cette statistique inclut les connexions sur lesquelles :

  • La connexion expire sans recevoir de données.
  • La connexion sécurisée SSL/TLS ne peut pas être établie.
  • Le protocole n'est pas connu.
  • Le protocole n'est pas admis pour le noeud final.
  • Un nom d'utilisateur et un mot de passe est requis, mais aucun n'a été spécifié.
  • L'utilisateur ne peut pas être authentifié.
  • L'utilisateur n'est pas autorisé à se connecter.

  TotalEndpoints

  Nombre de noeud finaux actifs.

  BufferedMessages

  Cette statistique fournit un comptage approximatif du nombre de messages (y compris les messages en cours) qui sont actuellement en mémoire tampon dans des files d'attentes et des abonnements sur le serveur IBM IoT MessageSight.

  Vous pouvez utiliser ces informations pour comprendre :

  • Si le nombre de messages en mémoire tampon augmente, diminue ou est constant au fil du temps.
  • Si le nombre de messages en mémoire tampon est plus élevé que prévu pour votre système à un moment donné.
  • Si votre système peut traiter le nombre de messages qui sont transmis par son intermédiaire.

  Vous pouvez aussi utiliser cette statistique en conjonction avec les statistiques d'utilisation de la mémoire du serveur sur le tableau de bord de l'interface utilisateur Web d'IBM IoT MessageSight afin de planifier la capacité. Servez-vous de ces informations pour savoir quel est le nombre de messages qui peuvent être placés en mémoire tampon sur votre serveur. Par exemple, l'utilisation de la mémoire du serveur peut être de 50 % avec 4 millions de messages en mémoire tampon, et de 60 % avec 8 millions de messages en mémoire tampon.

  RetainedMessages

  Cette statistique fournit un comptage approximatif du nombre de messages conservés (y compris les messages en cours) qui attendent dans des rubriques sur le serveur IBM IoT MessageSight. Les messages attendent d'être distribués à de nouveaux abonnés dans ces rubriques lorsque leur abonnement est créé pour la première fois.

  La statistique RetainedMessages ne représente pas le nombre de rubriques associées à un message conservé, car une rubrique unique peut être associée à plusieurs messages conservés qui sont en cours.

  Vous pouvez utiliser ces informations pour comprendre :

  • Si le nombre de messages conservés augmente, diminue ou est constant au fil du temps.
  • Si le nombre de messages conservés est plus élevé que prévu pour votre système à un moment donné.
  • Si votre système peut traiter le nombre de messages qui sont transmis par son intermédiaire.

  Vous pouvez aussi utiliser cette statistique en conjonction avec les statistiques d'utilisation de la mémoire du serveur sur le tableau de bord de l'interface utilisateur Web d'IBM IoT MessageSight afin de planifier la capacité. Servez-vous de ces informations pour savoir quel est le nombre de messages qui peuvent être conservés sur le serveur. Par exemple, l'utilisation de la mémoire du serveur peut être de 50 % avec 4 millions de messages conservés, et de 60 % avec 8 millions de messages conservés.

  ExpiredMessages

  Cette statistique fournit un comptage du nombre de messages arrivés à expiration dans des files d'attentes et des abonnements sur le serveur IBM IoT MessageSight.

  Vous pouvez utiliser ces informations pour comprendre :

  • Si le nombre de messages arrivés à expiration augmente, diminue ou est constant au fil du temps.
  • Si le nombre de messages arrivés à expiration est plus élevé que prévu pour votre système à un moment donné.
  • Si votre système peut traiter le nombre de messages qui sont transmis par son intermédiaire.

  Vous pouvez aussi utiliser cette statistique en conjonction avec les statistiques d'utilisation de la mémoire du serveur sur le tableau de bord de l'interface utilisateur Web d'IBM IoT MessageSight afin de planifier la capacité.

Commandes connexes

• Afficher les statistiques liées aux rubriques à l'aide des API de surveillance REST

Exemple

L'exemple suivant utilise cURL pour indiquer comment une méthode GET est utilisée afin d'afficher des informations statistiques sur les connexions au serveur :

curl -X GET http://127.0.0.1:9089/ima/v1/monitor/Server
 
 

Le code ci-dessous est un exemple de réponse indiquant la réussite à la méthode GET qui a été utilisée pour créer des informations statistiques sur les connexions au serveur :

{ "Version":"v1", "Server":  {"ActiveConnections":0,"TotalConnections":0,"MsgRead":0,"MsgWrite":0,"BytesRead":0,"BytesWrite":0,"BadConnCount":0,
"TotalEndpoints":3, "BufferedMessages":0,"RetainedMessages":0,"ExpiredMessages":0 }}