Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Les données n’arrivent pas

Trouvez pourquoi les mesures d'un appareil connecté ne sont pas enregistrées ou pourquoi certaines clés manquent : flux racine, forme de la charge utile, règles de clés, limites de débit, quarantaine et quotas.

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érificationCommentCorrectif
L’appareil n’est pas en quarantaineLa liste des appareils affiche QuarantinedUn 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’appareilActivez-le
Il publie sur le bon topicL’onglet Log de l’appareil ; la référence des topicsLes 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 IoTAutomation, filtre IoTUn 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 racineLa liste des flux affiche des badges Root avec le nom du profilC’est ce flux racine, et non celui de l’organisation, qui traite l’appareil : il doit contenir Save telemetry
Les messages atteignent Save telemetryLe panneau Activity du flux racine : Debug, Errors, les compteurs de messages sur les liensCorrigez le chemin ; gardez Alarm rules, Save telemetry et Save client attributes dessus
L’automatisation IoT est disponible pour votre organisationSans elle, aucune donnée d’appareil n’est stockéeContactez 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 :

CodeCauseCorrectif
key_invalidUn caractère hors de A–Z a–z 0–9 _ . -, ou une clé videRenommez la clé sur l’appareil ou dans le flux
key_too_longPlus de 64 caractères, préfixe de topic comprisClés plus courtes
key_reservedCommence 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_longTexte de plus de 1 024 caractèresEnvoyez un texte plus court, ou stockez-le comme attribut
value_too_largeJSON 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_formPas une forme lisible par le stockage, ou plus de 1 000 points clé-valeur dans un messageEnvoyez un objet plat, {"ts": …, "values": {…}} ou un tableau de ceux-ci ; découpez les gros lots
bad_tsUn 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_oldPlus 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_limitUne 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_valuesRien 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ômeCause
Tout est stocké sous une seule clé rawLe 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 TextL’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 passerelleLa 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

LimiteValeur par défautCe qui se passeOù regarder
Messages de mesures par appareil10 par seconde et 300 par minuteAcquittés et rejetés ; les propriétaires et administrateurs reçoivent une notification par appareil et par heureLes Limits du profil
Points de données par appareil200 par seconde et 6 000 par minuteIdemIdem
Mises à jour d’attributs par appareil5 par seconde et 60 par minuteIdemIdem
Taille du message64 KiBLe message est rejeté en entier ; la connexion reste ouverteMax message payload (bytes) du profil
Mesures rejouées (mises en tampon)La moitié du nombre de mesures par secondeLes enregistrements plus anciens envoyés après une panne doivent respecter Replay messages per secondLes Limits du profil
Organisation entière10, 15 ou 70 messages par seconde et 6 000, 9 000 ou 42 000 points de données par minute, selon le palierAcquittés et rejetés ; HTTP répond 429 avec Retry-After ; une notification par heureForfaits et option IoT
Enfants de passerellePar enfant et pour l’ensemble du message de la passerelleUn 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ômeCause
L’onglet Telemetry l’affiche, un tableau de bord nonVoir Un tableau de bord n’affiche aucune donnée
Une carte de valeur l’affiche, un graphique indique No values in this windowLa 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 deuxLes fenêtres de plus de 24 heures lisent des résumés par minute, remplis chaque minute
La dernière valeur ne change pasLes nouvelles mesures portent un horodatage plus ancien ou égal à celui déjà stocké

Par type de connexion

ConnexionAutres vérifications
LoRaWANDépannage des liaisons montantes et descendantes, le Frames log et le codec
SNMP et autres appareils interrogésInterrogation des appareils en SNMP : chaque interrogation écrit un message ; un appareil en échec est temporisé
API HTTP de l’appareil400 charge invalide, 413 corps trop volumineux, 429 limite de débit. Voir API HTTP de l’appareil.

Voir aussi