Chaque page d’appareil comporte un onglet Telemetry. C’est le moyen le plus rapide de vérifier qu’un appareil envoie ce que vous attendez : il liste chaque clé que l’appareil a envoyée, avec sa dernière valeur et l’heure de réception, et trace une tendance des clés numériques que vous choisissez.
Ouvrir l’onglet
- Ouvrez Devices et sélectionnez l’appareil.
- Sélectionnez l’onglet Telemetry.
Il vous faut la permission Read telemetry readings (tous les rôles de membre l’ont par défaut) et l’accès à l’appareil.
Le tableau des dernières valeurs
Le tableau, intitulé Latest values, comporte une ligne par clé envoyée par l’appareil :
| Colonne | Affiche |
|---|---|
| Name | Le Label de la clé défini dans le profil d’appareil, ou la clé elle-même lorsque le profil ne la nomme pas |
| Value | La dernière valeur. Nombres au format de votre langue (jusqu’à 3 décimales) avec l’Unit du profil ; true/false affichés On / Off ; JSON raccourci à 120 caractères |
| Type | Number, On / off, Text ou JSON (masqué sur les petits écrans) |
| Updated | Il y a combien de temps la valeur est arrivée ; survolez pour la date et l’heure |
- Search keys filtre par libellé et par clé.
- Le filtre Type affiche un seul type de valeur.
- Les colonnes se trient en cliquant sur leur en-tête.
Mises à jour en direct
L’étiquette au-dessus du graphique indique Live lorsque la page reçoit les valeurs au fur et à mesure de leur enregistrement, ou Updates every 30 s lorsqu’une connexion en direct n’est pas disponible et que le tableau est relu toutes les 30 secondes. Une valeur se met à jour sur place ; une clé envoyée pour la première fois par l’appareil rejoint le tableau.
Une valeur n’apparaît ici qu’après que le root flow l’a enregistrée. Une clé que l’appareil envoie mais que le root flow ne stocke pas n’apparaît jamais.
La tendance
Au-dessus du tableau, le graphique Trend trace les clés numériques sur une fenêtre :
- Cochez jusqu’à 4 clés numériques dans le tableau. Au départ, le graphique affiche la clé numérique qui a changé le plus récemment.
- Choisissez la Window : Last hour, Last 6 hours (par défaut), Last 24 hours ou Last 7 days.
Le graphique est relu toutes les minutes. Les fenêtres allant jusqu’à 24 heures affichent chaque mesure enregistrée ; Last 7 days affiche des moyennes horaires (7 jours contiennent plus de 10 000 minutes, donc le niveau horaire est utilisé). Voir Aggregates and rollups.
Seules les clés numériques peuvent être cochées (« Only a numeric key can be charted. »). Les clés de type texte, On / off et JSON affichent uniquement leur dernière valeur. Voir Numbers, text and true/false values.
Messages que vous pouvez voir
| Message | Signification |
|---|---|
| « This device has not sent any telemetry yet. » | Aucune valeur de cet appareil n’a été enregistrée. Vérifiez la connexion, puis le root flow. |
| « Tick up to 4 numeric keys in the table to chart them. » | Aucune clé n’est cochée, ou l’appareil n’a aucune clé numérique. |
| « No values in this window. » | Les clés cochées n’ont aucune mesure dans la fenêtre choisie. Choisissez une fenêtre plus longue. |
| « At most 4 keys at a time. » | Vous avez coché plus de 4 clés ; seules 4 sont tracées. |
| « Could not load the telemetry. » / « Could not load the chart. » | La lecture a échoué. Rechargez la page ; si le problème persiste, vérifiez vos permissions. |
Ce que l’onglet ne fait pas
- Il n’a pas de bouton de téléchargement. Pour télécharger les mesures, utilisez une carte de tableau ou de graphique de tableau de bord avec Download data (CSV), ou l’API d’historique. Voir Exporting data.
- Il n’affiche que les clés propres à l’appareil, pas les attributs. Les attributs se trouvent dans l’onglet Attributes de l’appareil. Voir Attributes.
- Il ne modifie pas les données enregistrées.
Dépannage
| Symptôme | Vérification |
|---|---|
| L’appareil apparaît en ligne mais l’onglet est vide | Le root flow n’enregistre pas les données : son bloc Save telemetry est absent, un root de profil sans ce bloc dessert cet appareil, ou les flows sont arrêtés. Voir Hosts, the root flow and profile root flows. |
| Une clé manque | Elle enfreint une règle de nommage, est réservée, ou la limite de clés de votre offre est atteinte. Voir Telemetry keys. |
| Updated affiche une heure ancienne alors que l’appareil envoie des données | L’appareil envoie un ts ancien ou figé. Voir Timestamps, late and duplicate readings. |
| Une clé contenant des nombres est listée comme Text | L’appareil envoie les nombres entre guillemets. |