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

Télémétrie et données

Comment Hermetry stocke les mesures des appareils : dernières valeurs, historique, agrégats, rétention, export, API d'historique et décompte mensuel des messages.

La télémétrie correspond aux grandeurs que vos appareils mesurent et transmettent dans le temps : températures, niveaux, compteurs, états. Cette section explique ce qui advient d’une mesure après son arrivée, combien de temps chaque niveau de détail est conservé, comment la relire (dans la console, sur les tableaux de bord, via l’API) et comment les mesures sont décomptées de votre forfait.

Le parcours d’une mesure

  1. Un appareil envoie un message (MQTT, HTTP, LoRaWAN, une passerelle ou un poller). Le message est décompté de votre quota mensuel de messages.
  2. Le message entre dans votre flux racine, où il est découpé en enregistrements (un par horodatage), et les clés et valeurs sont vérifiées selon les règles de clés.
  3. Le bloc Alarm rules évalue les règles d’alarme du profil de l’appareil.
  4. Le bloc Save telemetry écrit l’enregistrement. Seul ce bloc stocke la télémétrie : une branche sans lui ne stocke rien.
  5. Le stockage conserve le message, met à jour la dernière valeur de chaque clé de l’appareil, et la tâche de chaque minute regroupe les valeurs en agrégats d’1 minute ; les cumuls par heure et par jour suivent.
  6. Les tableaux de bord, l’onglet Telemetry de l’appareil, les flux et l’API lisent les dernières valeurs, les lignes brutes ou les cumuls, selon la fenêtre temporelle.

Voir Comment les mesures sont stockées et Hôtes, flux racine et flux racines de profil.

Points clés

SujetDétail
ClésJusqu’à 64 caractères parmi A-Z a-z 0-9 _ . -, sensibles à la casse. Les préfixes _, fw_, current_fw_ et cfg. sont réservés.
ValeursNombres, true/false, texte jusqu’à 1 024 caractères, objets ou tableaux JSON jusqu’à 4 KiB. Seuls les nombres sont tracés et agrégés.
HorodatagesMillisecondes depuis l’epoch, UTC. Plus de 10 minutes dans le futur : supprimé (ajustable).
DoublonsLes mêmes valeurs à la même heure pour le même appareil ne sont stockées qu’une fois.
Dernière valeurN’est mise à jour que par un horodatage strictement plus récent.
AgrégatsSomme, nombre, minimum, maximum et dernière valeur sur 1 minute par clé numérique, puis cumuls par heure et par jour.
RétentionUne classe de 7, 30, 90, 365 ou 1 095 jours selon votre offre. Les lignes brutes sont conservées 90 jours au maximum.
Quota de messagesDécompté par mois. Dépasser le quota n’arrête jamais vos appareils.

Dans cette section

PageCe qu’elle couvre
Comment les mesures sont stockéesLignes de messages, dictionnaire des clés, dernières valeurs, cumuls
Clés de télémétrieRègles de clés, préfixes réservés, raw, plafond de clés, réglages de clés du profil
Horodatages, mesures tardives et en doubleHeure de l’appareil et heure de réception, mesures futures et anciennes, doublons, coupures
Nombres, texte et valeurs vrai/fauxCe que lisent les graphiques et comment stocker les états
Agrégats et cumulsIntervalles, les sept fonctions d’agrégation, increase pour les compteurs
Durée de conservation des donnéesClasses de rétention et ce que conserve chaque niveau de détail
L’onglet Telemetry de l’appareilDernières valeurs et graphique de tendance sur la page de l’appareil
Exporter les donnéesTéléchargements CSV et Excel, l’API, l’export de l’organisation
L’API d’historiqueGET /api/telemetry/series et latest, avec exemples
Valeurs dérivéesCalcul et stockage de nouvelles clés dans un flux
Quota de messages et utilisationCe qui compte comme message, allocations des forfaits, avertissements

Sections liées