Affichage de statistiques de niveau connexion à l'aide des API de surveillance REST
Les administrateurs système peuvent afficher les statistiques de surveillance de niveau de connexion à l'aide des API de surveillance REST.
Pourquoi et quand exécuter cette tâche
Les administrateurs système peuvent afficher des statistiques de niveau connexion à l'aide d'une API de surveillance REST ou de l'interface utilisateur Web d'IBM® IoT MessageSight. Pour plus d'informations sur l'utilisation de l'interface utilisateur Web d'IBM IoT MessageSight pour l'affichage de statistiques de niveau connexion, voir Affichage de statistiques de niveau connexion à l'aide de l'interface graphique.
Procédure
Les statistiques de surveillance de niveau connexion peuvent être créées à l'aide d'une API de surveillance REST. Les données de surveillance de connexion sont régulièrement connectées et mises en cache. Le cache des données de surveillance de connexion est mis à jour toutes les 60 secondes. Par conséquent, les statistiques qui sont produites peuvent être obsolètes de 60 secondes et ne sont pas forcément immédiatement disponibles si la commande est émise à l'heure de début du serveur IBM IoT MessageSight. Pour créer des statistiques de surveillance de niveau connexion, procédez comme suit :
Résultats
-
- Name
- Chaîne
- Nom de la connexion. Le CientId est couramment utilisé.
-
- Protocol
- Chaîne
- Nom du protocole.
-
- ClientAddr
- Chaîne
- Adresse IP du client.
-
- UserId
- Chaîne
- ID utilisateur principal.
-
- Endpoint
- Chaîne
- Nom du noeud final.
-
- Port
- Nombre
- Port du serveur IBM IoT MessageSight.
-
- ConnectTime
- Nombre
- Indique le nombre de microsecondes écoulées depuis l'époque unix.
- Heure à laquelle la connexion est créée.
-
- Duration
- Nombre
- Durée de la connexion en nanosecondes.
-
- ReadBytes
- Nombre
- Nombre d'octets lus depuis l'heure de connexion.
-
- ReadMsg
- Nombre
- Nombre de messages lus depuis l'heure de connexion.
-
- WriteBytes
- Nombre
- Nombre d'octets écrits depuis l'heure de connexion.
-
- WriteMsg
- Nombre
- Nombre de messages écrits depuis l'heure de connexion.
Exemple
L'exemple suivant utilise cURL pour indiquer comment utiliser une méthode GET afin de créer des statistiques sur les connexions classées par rapport au débit de messages le plus élevé :
curl -X GET http://127.0.0.1:9089/ima/v1/monitor/Connection?Endpoint=DemoEndpoint%26StatType=HighestThroughputMsgs
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 statistiques sur les noeuds finaux ayant le débit de messages le plus élevé.
{ "Version":"v1", "Connection": [ { "Name":"DemoClientId","Protocol":"mqtt","ClientAddr":"9.20.230.65","UserId":"",
"Endpoint":"DemoEndpoint","Port":16102,"ConnectTime":1446728129213566618,"Duration":160676522991,"ReadBytes":39,"ReadMsg":0,
"WriteBytes":14,"WriteMsg":0} } ] }