Chaque mesure est enregistrée à une heure donnée. Cette page explique quelle heure est utilisée, quelles mesures sont refusées en raison de leur horodatage, comment les doublons sont traités et ce qui advient des mesures qui arrivent en retard.
Heure de l’appareil ou heure de réception
| Ce que l’appareil envoie | Enregistré à |
|---|---|
Un objet plat, par exemple {"temperature": 21.5} | L’heure à laquelle la plateforme a reçu le message |
{"ts": 1759572000000, "values": {...}} | ts : l’heure propre à l’appareil |
| Un tableau des deux formes | Chaque élément à sa propre heure |
ts est un entier en millisecondes depuis le 1er janvier 1970, UTC. Tout autre ts (en secondes, une chaîne, un nombre négatif) fait rejeter l’enregistrement avec bad_ts. Voir Référence des topics et charges utiles MQTT.
N’envoyez ts que si l’horloge de l’appareil est synchronisée. Un appareil sans horloge fiable doit envoyer des objets plats et laisser la plateforme les horodater. Une horloge qui dérive produit des mesures au mauvais endroit sur les graphiques et peut être refusée.
Dans un flux, l’heure d’enregistrement est msg.metadata.recordTs et l’heure de réception msg.metadata.ts. Le bloc Save telemetry enregistre par défaut l’heure d’enregistrement ; son paramètre ts peut basculer sur l’heure de réception, et ts_path peut redater un enregistrement à partir d’une valeur du message.
Mesures provenant du futur
Un enregistrement dont l’horodatage est postérieur de plus de 10 minutes à l’heure de sa réception est rejeté avec bad_ts. Il n’est jamais corrigé en « maintenant ». Pour modifier la tolérance, allez dans Paramètres > Télémétrie (Paramètres de télémétrie IoT) :
| Paramètre | Valeur par défaut | Plage |
|---|---|---|
| Future timestamp tolerance (minutes) | 10 | 1 à 1 440 |
| Oldest accepted reading (days) | 0 (tout âge) | 0 à 36 500 |
Un enregistrement antérieur de plus de Plus ancienne valeur acceptée (jours) à sa réception est rejeté avec bad_ts. Ce réglage permet d’empêcher un appareil de rejouer de très anciennes données mises en mémoire tampon. La page nécessite les autorisations Afficher les paramètres de télémétrie IoT et Modifier les paramètres de télémétrie IoT (Admin par défaut). Les modifications sont prises en compte par l’ingestion dans la minute.
Relevés anciens
Un relevé plus ancien que la durée de conservation de votre classe de rétention pour les données brutes est refusé par le stockage avec too_old, quels que soient les réglages ci-dessus :
| Classe de rétention | Un relevé est refusé lorsqu’il est plus ancien que |
|---|---|
| 7 jours | 7 jours |
| 30 jours | 7 jours |
| 90 jours | 30 jours |
| 365 jours | 90 jours |
| 1 095 jours | 90 jours |
Les relevés situés dans la fenêtre brute sont stockés même anciens, et intégrés aux synthèses par minute, par heure et par jour. Voir Durée de conservation des données.
Doublons
Un appareil, une passerelle ou une nouvelle tentative peut envoyer deux fois la même mesure. Hermetry traite ce cas à deux endroits :
- Avant le flux. Un message d’appareil dont l’identifiant a déjà été vu dans les 60 secondes, ou, s’il n’a pas d’identifiant mais porte son propre
ts, dont le contenu a déjà été vu, est acquitté sans exécution. Une mesure sans identifiant nitsn’est jamais considérée comme un doublon : la même valeur deux fois représente deux mesures. - Dans le stockage. Un message ayant les mêmes valeurs, à la même heure, pour le même appareil n’est stocké qu’une fois. Un message renvoyé ou rejoué ne change rien.
Deux messages différents ayant le même horodatage sont tous deux conservés. Lorsque l’API lit les valeurs brutes, elle renvoie un seul point par horodatage. La dernière valeur conserve la première valeur vue pour cet horodatage.
Mesures hors d’ordre
Un appareil qui met en mémoire tampon des mesures hors ligne et les envoie plus tard les transmet après des données plus récentes. Elles sont stockées dans l’historique à leurs propres heures. Elles ne remplacent pas une valeur la plus récente plus récente. Les règles d’alarme traitent les enregistrements plus anciens que la dernière évaluée comme un rattrapage : ils ne sont pas évalués en direct, et une règle avec rattrapage activé enregistre des alarmes à partir d’eux sans notifier personne. Voir Clear conditions and late readings.
Mesures retardées par une panne
Les messages attendent dans une file pendant qu’un processus de traitement est arrêté. Lorsque la plateforme rattrape son retard, un message d’appareil ayant attendu plus longtemps que son délai de vie (5 minutes par défaut) est un message en retard :
- Il passe toujours par son flux racine et est stocké. Un arriéré fait partie de vos données, il n’est donc jamais abandonné à cette étape.
- Il est marqué en retard (
msg.metadata.late). Les blocs qui agissent en dehors de la plateforme l’ignorent : pas de notification, pas de commande d’appareil, pas d’appel HTTP ni de publication MQTT (sauf si le paramètre late du bloc vautsend), pas d’événement émis. - Le bloc Alarm rules l’évalue comme un rattrapage : les alarmes sont écrites dans l’historique, marquées Backfilled, et personne n’est appelé pour le passé. Une alarme encore ouverte lorsque les mesures en direct reprennent est annoncée à ce moment-là.
- Les autres flux qui y réagiraient (par exemple un écouteur
alarm) l’ignorent et le comptent comme Trop ancien.
Voir Protections and failed messages.
Fuseaux horaires
Tout est stocké en UTC. La console, les tableaux de bord et les exports affichent les heures dans le fuseau du spectateur. Les agrégats journaliers vont de minuit à minuit en UTC ; voir Aggregates and rollups pour lire les jours locaux.
Dépannage
| Symptôme | Cause probable |
|---|---|
| Une mesure manque, les autres du même appareil sont présentes | Son ts était dans le futur ou hors plage (bad_ts), ou antérieur à la fenêtre brute (too_old). Consultez les enregistrements d’exécution du flux racine. |
| Les mesures apparaissent décalées de plusieurs heures ou d’un jour | L’appareil envoie ts en heure locale ou en secondes. Envoyez des millisecondes UTC, ou des objets plats. |
| La dernière valeur ne change pas alors que de nouvelles mesures arrivent | Les nouvelles mesures ont un ts plus ancien ou égal à celui stocké. |
| Une valeur corrigée n’apparaît pas | Elle a été envoyée avec le même ts que l’originale ; la dernière valeur conserve la première. Envoyez la correction avec un nouveau ts. |
Voir aussi Wrong times and gaps.

