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

Comment les mesures sont stockées

Ce que le magasin de télémétrie conserve pour chaque message d'appareil : lignes de messages, dictionnaire des clés, dernières valeurs et cumuls par minute, par heure et par jour.

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.payload est 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 ligneContient
Appareil et horodatageL’identifiant de l’appareil et l’horodatage de l’enregistrement (millisecondes, UTC)
NombresChaque valeur numérique, stockée par identifiant de clé
Autres valeursBooléens, textes et valeurs JSON, stockés par nom de clé
Empreinte du messageUn 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 :

NiveauContenuAlimenté par
Agrégats à 1 minutePar clé numérique et par minute : somme, nombre, minimum, maximum et dernière valeurUne tâche exécutée chaque minute
Cumuls horairesLes mêmes cinq valeurs par heureDérivés des agrégats par minute
Cumuls journaliersLes 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 temporelleLue depuis
Jusqu’à 24 heuresLes lignes de messages bruts (chaque mesure)
Plus longueLe 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

CompteurSignification
Messages IoTMessages 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ésLes valeurs effectivement insérées par le stockage. Un doublon écarté par le stockage n’est pas compté. Sans quota.

Voir Quota de messages et utilisation.