Cette page explique ce qu’Hermetry écrit lorsqu’un flux enregistre une mesure, et pourquoi. Comprendre cela vous aide à prévoir ce que renvoient un graphique ou l’API, et pourquoi certaines valeurs apparaissent à un endroit et pas à un autre.
Seuls les flux stockent des données
Un message d’appareil est stocké parce qu’un flux le demande. Chaque organisation commence avec un flux racine par défaut qui reçoit chaque message d’appareil et enregistre la télémétrie et les attributs client. Le bloc Enregistrer la télémétrie est le seul moyen d’écrire la télémétrie :
- Si vous supprimez le bloc (ou la branche qui y mène), les mesures ne sont plus stockées. L’appareil apparaît toujours en ligne, car la connexion est suivie séparément.
- Seul
msg.payloadest stocké. Les métadonnées du message (le topic, le transport, le nom de l’appareil) ne sont jamais stockées. - Une exécution de test d’un flux ne stocke jamais rien.
Voir Hôtes, le flux racine et les flux racines de profil.
Une ligne par message
Lorsque le bloc Enregistrer la télémétrie écrit un enregistrement, le magasin ajoute une seule ligne pour l’enregistrement entier, et non une ligne par clé :
| Partie de la ligne | Contient |
|---|---|
| Appareil et horodatage | L’identifiant de l’appareil et l’horodatage de l’enregistrement (millisecondes, UTC) |
| Nombres | Chaque valeur numérique, stockée par identifiant de clé |
| Autres valeurs | Booléens, textes et valeurs JSON, stockés par nom de clé |
| Empreinte du message | Un hachage des valeurs, utilisé pour reconnaître le même message livré deux fois |
Un enregistrement de 8 clés forme une seule ligne. Cela maintient le stockage compact et permet à l’API de renvoyer un message entier d’un coup.
Le dictionnaire des clés
Chaque clé utilisée par votre organisation reçoit un petit numéro dans un dictionnaire propre à l’organisation, la première fois qu’elle est stockée. Ce dictionnaire est partagé par tous vos appareils : temperature est une seule clé, qu’un appareil ou dix mille l’envoient.
- Les clés ne sont jamais renommées ni réutilisées. Une clé reste dans le dictionnaire après la suppression des appareils qui l’ont envoyée.
- Votre offre peut plafonner le nombre de clés distinctes. Une nouvelle clé au-delà du plafond n’est pas stockée, tandis que les autres clés du même enregistrement le sont. Voir Clés de télémétrie.
Dernières valeurs
En complément de l’historique, le magasin conserve une dernière valeur par appareil et par clé, avec son horodatage. Les cartes de valeurs des tableaux de bord, l’onglet Télémétrie de l’appareil et le bloc de flux Dernières valeurs les lisent.
La dernière valeur n’est remplacée que par un horodatage strictement plus récent :
- Une mesure avec un horodatage plus ancien (un retard mis en mémoire tampon arrivant après une mesure plus récente) est stockée dans l’historique, mais ne remplace pas la dernière valeur.
- Un renvoi corrigé avec le même horodatage est stocké comme son propre message si ses valeurs diffèrent, mais la dernière valeur conserve la première.
Ainsi, l’historique, les dernières valeurs et la vue en direct restent toujours cohérents.
Agrégats et cumuls
Les nombres sont aussi résumés afin que les longues plages temporelles se lisent rapidement :
| Niveau | Contenu | Alimenté par |
|---|---|---|
| Agrégats à 1 minute | Par clé numérique et par minute : somme, nombre, minimum, maximum et dernière valeur | Une tâche exécutée chaque minute |
| Cumuls horaires | Les mêmes cinq valeurs par heure | Dérivés des agrégats par minute |
| Cumuls journaliers | Les mêmes cinq valeurs par jour (UTC) | Dérivés des agrégats par minute |
Les textes, booléens et valeurs JSON ne sont pas agrégés. Une mesure qui arrive en retard pour une minute déjà résumée marque cette minute pour un nouveau passage, afin que les données tardives soient intégrées. Voir Agrégats et cumuls.
Source utilisée par une lecture
| Plage temporelle | Lue depuis |
|---|---|
| Jusqu’à 24 heures | Les lignes de messages bruts (chaque mesure) |
| Plus longue | Le cumul le plus fin qui reste sous 10 000 intervalles : minutes, puis heures, puis jours |
Vous pouvez aussi demander une résolution précise dans l’API. Voir L’API d’historique.
Conservation
Chaque niveau est conservé pendant sa propre durée. Les lignes brutes sont conservées 90 jours au maximum, les agrégats par minute 31 jours au maximum, et les cumuls horaires et journaliers pour toute la classe de rétention de votre offre. Voir Durée de conservation des données.
Valeurs en direct
Une fois l’enregistrement validé, les nouvelles valeurs sont envoyées aux tableaux de bord ouverts et aux pages d’appareils qui suivent l’appareil. Une valeur non enregistrée (par exemple une clé filtrée par le flux racine) n’apparaît jamais en direct. La diffusion en direct est limitée à quatre mises à jour par seconde et par clé ; les valeurs intermédiaires sont tout de même stockées.
Lors de la suppression d’un appareil
La suppression d’un appareil retire ses mesures, agrégats par minute, cumuls et dernières valeurs en arrière-plan, un jour de données à la fois. Les clés qu’il utilisait restent dans le dictionnaire.
Comptage
| Compteur | Signification |
|---|---|
| Messages IoT | Messages de télémétrie et d’attributs acceptés depuis les appareils, comptés à leur arrivée, qu’un flux les stocke ou non |
| Points de données IoT stockés | Les valeurs effectivement insérées par le stockage. Un doublon écarté par le stockage n’est pas compté. Sans quota. |

