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
- Un appareil envoie un message (MQTT, HTTP, LoRaWAN, une passerelle ou un poller). Le message est décompté de votre quota mensuel de messages.
- 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.
- 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 sans lui ne stocke rien.
- 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.
- 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
| 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’epoch, UTC. Plus de 10 minutes dans le futur : supprimé (ajustable). |
| Doublons | Les mêmes valeurs à la même heure pour le même appareil ne sont stockées qu’une fois. |
| Dernière valeur | N’est mise à jour que par un horodatage strictement plus récent. |
| Agrégats | Somme, nombre, minimum, maximum et dernière valeur sur 1 minute par clé numérique, puis cumuls par heure et par jour. |
| Rétention | Une 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 messages | Décompté par mois. Dépasser le quota 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, cumuls |
| 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 en double | Heure de l’appareil et heure de réception, mesures futures et anciennes, doublons, coupures |
| Nombres, texte et valeurs vrai/faux | Ce que lisent les graphiques et comment stocker les états |
| Agrégats et cumuls | 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 |
| Exporter les 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 flux |
| Quota de messages et utilisation | Ce qui compte comme message, allocations des forfaits, avertissements |
Sections liées
- Appareils : connecter des appareils et les 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.
- Flux : le flux racine qui stocke les données, et les flux qui calculent de nouvelles valeurs.

