La télémétrie correspond à ce 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 sa réception, 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
- Un appareil envoie un message (MQTT, HTTP, LoRaWAN, une passerelle ou un poller). Le message est compté dans votre quota mensuel de messages.
- Le message entre dans votre root flow, découpé en enregistrements (un par horodatage), et les clés et valeurs sont vérifiées selon les règles de clés.
- Le bloc Alarm rules évalue les règles d’alarme du profil de l’appareil.
- Le bloc Save telemetry écrit l’enregistrement. Seul ce bloc stocke la télémétrie : une branche qui n’en contient pas ne stocke rien.
- Le store conserve le message, met à jour la dernière valeur de chaque clé de l’appareil, et la tâche de la minute regroupe les valeurs en agrégats d’1 minute ; les agrégats par heure et par jour suivent.
- Les tableaux de bord, l’onglet Telemetry de l’appareil, les flows et l’API lisent les dernières valeurs, les lignes brutes ou les agrégats, selon la fenêtre temporelle.
Voir Comment les mesures sont stockées et Hôtes, le root flow et les root flows de profil.
Points clés
| Sujet | Détail |
|---|---|
| Clés | Jusqu’à 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. |
| Valeurs | Nombres, 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. |
| Horodatages | Millisecondes depuis l’époque, en UTC. Au-delà de 10 minutes dans le futur, la mesure est ignorée (réglable). |
| Doublons | Les mêmes valeurs à la même heure pour le même appareil sont stockées une seule fois. |
| Dernière valeur | Ne change que pour un horodatage strictement plus récent. |
| Agrégats | Somme, nombre, minimum, maximum et dernière valeur sur 1 minute par clé numérique, puis agrégats par heure et par jour. |
| Rétention | Une classe de 7, 30, 90, 365 ou 1 095 jours selon votre forfait. Les lignes brutes sont conservées au maximum 90 jours. |
| Quota de messages | Compté par mois. Le dépassement n’arrête jamais vos appareils. |
Dans cette section
| Page | Ce qu’elle couvre |
|---|---|
| Comment les mesures sont stockées | Lignes de messages, dictionnaire des clés, dernières valeurs, agrégats |
| Clés de télémétrie | Rè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 doublons | Heure de l’appareil et heure de réception, mesures futures et anciennes, doublons, coupures |
| Nombres, texte et valeurs true/false | Ce que lisent les graphiques et comment stocker les états |
| Agrégats et rollups | Intervalles, les sept fonctions d’agrégation, increase pour les compteurs |
| Durée de conservation des données | Classes de rétention et ce que conserve chaque niveau de détail |
| L’onglet Telemetry de l’appareil | Dernières valeurs et graphique de tendance sur la page de l’appareil |
| Export des données | Téléchargements CSV et Excel, l’API, l’export de l’organisation |
| L’API d’historique | GET /api/telemetry/series et latest, avec exemples |
| Valeurs dérivées | Calcul et stockage de nouvelles clés dans un flow |
| Quota et utilisation des messages | Ce qui compte comme message, allocations des forfaits, avertissements |
Sections liées
- Appareils : connexion des appareils et formats de charge utile qu’ils envoient. Voir Référence des topics MQTT et des charges utiles.
- Tableaux de bord : graphiques, tableaux et cartes de valeurs. Voir Sources de données et paramètres.
- Flows : le root flow qui stocke les données, et les flows qui calculent de nouvelles valeurs.