Cette page vous aide lorsqu’un appareil est connecté (ou sa passerelle l’est) mais que ses mesures n’apparaissent pas dans son onglet Telemetry, ou seulement certaines d’entre elles. Si l’appareil ne se connecte pas du tout, commencez par Un appareil ne se connecte pas.
Comment une mesure est stockée
Device → broker or HTTP API (rate limits, size, quarantine)
→ the device's root flow (profile root, or the organisation's root)
→ Alarm rules → Save telemetry (key rules, time rules, key cap)
→ the telemetry store → Telemetry tab, dashboards, API
Un relevé peut être perdu à chaque étape. Les contrôles ci-dessous suivent cet ordre.
Rien du tout n’est stocké
| Vérification | Comment | Correctif |
|---|---|---|
| L’appareil n’est pas en quarantaine | La liste des appareils affiche Quarantined | Un appareil en quarantaine se connecte, mais ses données de télémétrie et ses attributs sont acquittés et rejetés jusqu’à ce qu’un administrateur sélectionne Activer. Voir Quarantaine. |
| L’appareil n’est pas désactivé | Page de l’appareil | Activez-le |
| Il publie sur le bon topic | L’onglet Log de l’appareil ; la référence des topics | Les mesures vont sur v1/telemetry (ou sur les topics personnalisés de votre profil). Un topic inconnu sous v1/ est rejeté avec unknown_reserved_topic. Voir Référence des topics MQTT et des charges utiles. |
| Un flux racine est en cours d’exécution sur l’hôte IoT | Automation, filtre IoT | Un flux racine doit être Running. Un bandeau « No worker is running the IoT host right now… » signifie que le traitement est arrêté : contactez le support. |
| L’arrêt d’urgence est désactivé | Automation, bandeau « Emergency stop: n flows are paused… » | Reprenez les flux |
| Le profil de l’appareil a son propre flux racine | La liste des flux affiche des badges Root avec le nom du profil | C’est ce flux racine, et non celui de l’organisation, qui traite l’appareil : il doit contenir Save telemetry |
| Les messages atteignent Save telemetry | Le panneau Activity du flux racine : Debug, Errors, les compteurs de messages sur les liens | Corrigez le chemin ; gardez Alarm rules, Save telemetry et Save client attributes dessus |
| L’automatisation IoT est disponible pour votre organisation | Sans elle, aucune donnée d’appareil n’est stockée | Contactez le support |
Voir Hôtes, flux racine et flux racines de profil.
Certaines clés ou certaines mesures manquent
Save telemetry indique pourquoi il a écarté une valeur. Ouvrez Activity > Runs ou Errors du flux racine :
| Code | Cause | Correctif |
|---|---|---|
key_invalid | Un caractère hors de A–Z a–z 0–9 _ . -, ou une clé vide | Renommez la clé sur l’appareil ou dans le flux |
key_too_long | Plus de 64 caractères, préfixe de topic compris | Clés plus courtes |
key_reserved | Commence par _, fw_, current_fw_ ou cfg. | Ces préfixes sont réservés aux attributs et à la plateforme. Voir Clés et attributs réservés. |
string_too_long | Texte de plus de 1 024 caractères | Envoyez un texte plus court, ou stockez-le comme attribut |
value_too_large | JSON de plus de 4 KiB, raw au-delà de sa limite, ou un nombre non fini (NaN, Infinity) | Découpez la valeur ; envoyez des nombres |
bad_form | Pas une forme lisible par le stockage, ou plus de 1 000 points clé-valeur dans un message | Envoyez un objet plat, {"ts": …, "values": {…}} ou un tableau de ceux-ci ; découpez les gros lots |
bad_ts | Un horodatage non exprimé en millisecondes epoch, plus de 10 minutes dans le futur, ou plus ancien que Oldest accepted reading (days) | Voir Horodatages erronés et trous |
too_old | Plus ancien que la durée de conservation de votre classe de rétention pour les données brutes (7 à 90 jours) | Envoyer les données mises en mémoire tampon plus tôt |
key_limit | Une nouvelle clé au-delà du plafond de clés de mesures de votre forfait (250, 400 ou 2 050 selon le palier) | Supprimez les clés inutiles avant Save telemetry, ou changez de forfait |
no_values | Rien de l’enregistrement n’a pu être stocké | Voir les codes de ses valeurs |
Le reste du message est tout de même stocké lorsqu’une clé est refusée.
La charge utile n’est pas ce qu’Hermetry attend
| Symptôme | Cause |
|---|---|
Tout est stocké sous une seule clé raw | Le corps n’est pas un objet JSON (binaire, texte brut, scalaire ou tableau sur un topic personnalisé). Décodez-le dans le flux racine, utilisez un codec LoRaWAN, ou envoyez du JSON. |
| Un nombre est listé comme Text | L’appareil l’envoie entre guillemets ("21.5"). Envoyez un nombre, ou convertissez avec number(...) dans un bloc Calculate. |
| Les valeurs apparaissent sous un nom imbriqué | L’option Prefix keys with the topic du profil stocke les données d’un topic personnalisé sous <topic>.<key> |
| Rien pour un enfant de passerelle | La passerelle doit envoyer v1/gw/connect pour l’enfant et utiliser la forme v1/gw/telemetry. Voir Appareils derrière une passerelle. |
Les messages sont rejetés par une limite
| Limite | Valeur par défaut | Ce qui se passe | Où regarder |
|---|---|---|---|
| Messages de mesures par appareil | 10 par seconde et 300 par minute | Acquittés et rejetés ; les propriétaires et administrateurs reçoivent une notification par appareil et par heure | Les Limits du profil |
| Points de données par appareil | 200 par seconde et 6 000 par minute | Idem | Idem |
| Mises à jour d’attributs par appareil | 5 par seconde et 60 par minute | Idem | Idem |
| Taille du message | 64 KiB | Le message est rejeté en entier ; la connexion reste ouverte | Max message payload (bytes) du profil |
| Mesures rejouées (mises en tampon) | La moitié du nombre de mesures par seconde | Les enregistrements plus anciens envoyés après une panne doivent respecter Replay messages per second | Les Limits du profil |
| Organisation entière | 10, 15 ou 70 messages par seconde et 6 000, 9 000 ou 42 000 points de données par minute, selon le palier | Acquittés et rejetés ; HTTP répond 429 avec Retry-After ; une notification par heure | Forfaits et option IoT |
| Enfants de passerelle | Par enfant et pour l’ensemble du message de la passerelle | Un enfant dépassant ses propres limites ne perd que ses enregistrements (child_rate_limited) | Appareils derrière une passerelle |
Un appareil qui continue à dépasser sa limite (plus de trois fois son quota par minute rejetées en une minute) voit sa session fermée. Voir Profils d’appareils.
Batch les mesures au lieu d’envoyer un message par valeur : un message contenant 50 enregistrements horodatés est un seul message.
Le quota mensuel de messages
Le quota mensuel de messages IoT n’arrête jamais les données. Au-delà, Hermetry continue d’accepter, de stocker et de traiter vos messages ; le dépassement est facturé. Si les données s’arrêtent, cherchez l’une des causes ci-dessus, pas le quota. Voir Quota de messages et utilisation.
Elle est stockée, mais vous ne la voyez pas
| Symptôme | Cause |
|---|---|
| L’onglet Telemetry l’affiche, un tableau de bord non | Voir Un tableau de bord n’affiche aucune donnée |
| Une carte de valeur l’affiche, un graphique indique No values in this window | La clé est du texte ou vrai/faux : elles n’ont pas d’historique de graphique. Stockez une copie numérique. Voir Nombres, texte et valeurs vrai/faux. |
| Un graphique sur une longue fenêtre accuse un retard d’une minute ou deux | Les fenêtres de plus de 24 heures lisent des résumés par minute, remplis chaque minute |
| La dernière valeur ne change pas | Les nouvelles mesures portent un horodatage plus ancien ou égal à celui déjà stocké |
Par type de connexion
| Connexion | Autres vérifications |
|---|---|
| LoRaWAN | Dépannage des liaisons montantes et descendantes, le Frames log et le codec |
| SNMP et autres appareils interrogés | Interrogation des appareils en SNMP : chaque interrogation écrit un message ; un appareil en échec est temporisé |
| API HTTP de l’appareil | 400 charge invalide, 413 corps trop volumineux, 429 limite de débit. Voir API HTTP de l’appareil. |

