For the complete documentation index, see llms.txt. This page is also available as Markdown.

Données en temps réel

Comment Kilo IoT livre les données de capteurs en temps réel aux tableaux de bord et à la vue d’ensemble — et quoi vérifier quand les mises à jour s’arrêtent.

Le serveur Kilo IoT fournit les données des appareils à vos tableaux de bord et à votre page d’aperçu en temps réel. Lorsqu’un capteur signale une nouvelle lecture, celle-ci apparaît à l’écran sans nécessiter d’actualisation de la page ni d’action manuelle. Cette page explique les deux zones Live Data, le fonctionnement de la diffusion en temps réel et ce qu’il faut vérifier lorsque les données n’apparaissent pas comme prévu.

Deux zones Live Data

La plateforme affiche l’état en temps réel à deux endroits, avec un comportement différent dans chaque cas :

Page d’aperçu : bouton Live Data

Sur le page d’aperçu, l’en-tête affiche un « Données en direct » avec un bouton icône cliquable. Le survol du bouton affiche l’info-bulle « Les nouvelles données sont affichées automatiquement ».

C’est un bouton interactif. Cliquer dessus déclenche une actualisation manuelle des données — l’aperçu interroge les dernières informations sur les appareils et les passerelles, puis met à jour les cartes récapitulatives. C’est utile lorsque vous venez d’enregistrer un nouvel appareil ou d’effectuer un changement de configuration et que vous souhaitez voir le résultat immédiatement plutôt que d’attendre le cycle d’actualisation automatique.

En-tête du tableau de bord : indicateur Live Data

Sur n’importe quel tableau de bord, l’en-tête affiche un « Données en direct » avec une petite icône. Contrairement au bouton d’aperçu, il s’agit d’un indicateur d’état, pas d’un bouton — il n’a aucune action au clic, aucune info-bulle et aucun effet au survol.

L’indicateur confirme que le tableau de bord reçoit des mises à jour de données en temps réel. Les valeurs des widgets se rafraîchissent automatiquement à mesure que de nouvelles lectures arrivent depuis les appareils. L’indicateur disparaît lorsque vous passez en mode édition (remplacé par l’icône d’édition des métadonnées du tableau de bord).

A dashboard header showing the Live Data indicator beside the dashboard name, with a widget updating

Fonctionnement de la diffusion en temps réel

Le serveur utilise une connexion persistante entre votre navigateur et la plateforme pour envoyer les mises à jour de données au fur et à mesure qu’elles se produisent :

  1. L’appareil envoie des données — Un capteur transmet une nouvelle lecture via son connecteur (LoRaWAN, tracker ou autre protocole).

  2. Le serveur traite la lecture — Les données passent par une normalisation et sont stockées pour les requêtes historiques.

  3. Envoi vers le navigateur — Simultanément, la lecture est envoyée à toute session de navigateur active affichant un tableau de bord ou un widget pertinent.

  4. Mise à jour des widgets — Les widgets du tableau de bord affichant la métrique concernée actualisent leur valeur affichée sans rechargement de la page.

Cette architecture signifie qu’un capteur de température envoyant une lecture toutes les 60 secondes mettra à jour votre widget de tableau de bord toutes les 60 secondes — la latence est déterminée par l’intervalle de transmission de l’appareil, et non par le mécanisme de diffusion de la plateforme.

Pour les intégrateurs qui construisent des systèmes externes consommant des données en temps réel, la plateforme prend en charge SSE (Server-Sent Events) et WebSocket protocoles. Les widgets de tableau de bord utilisent en interne ces mêmes mécanismes. Si vous créez des intégrations personnalisées qui nécessitent des flux de données en direct, ces protocoles constituent la base.

L’état « En attente de données en direct »

Lorsqu’un tableau de bord ou un widget est connecté au flux en temps réel mais qu’aucune donnée n’est encore arrivée, l’interface peut afficher « En attente de données en direct ». Il s’agit d’un état normal qui se produit lorsque :

  • Un appareil a été enregistré mais n’a pas encore envoyé sa première lecture.

  • L’intervalle de transmission de l’appareil ne s’est pas encore écoulé depuis l’ouverture du tableau de bord.

  • L’appareil est hors ligne ou son connecteur n’est pas actif.

Dépannage des retards de données

Si les données n’apparaissent pas en temps réel :

  1. Vérifiez l’état de l’appareil — Ouvrez la page de détails de l’appareil et confirmez qu’il est en ligne et qu’il envoie des données. Consultez l’horodatage de dernière détection.

  2. Vérifiez le connecteur — Assurez-vous que le connecteur associé à l’appareil est actif et connecté.

  3. Vérifiez la passerelle (appareils LoRaWAN) — Si l’appareil utilise une passerelle LoRaWAN, vérifiez que la passerelle est en ligne et à portée.

  4. Actualisez le navigateur — Dans de rares cas, il peut être nécessaire de rétablir la connexion persistante entre le navigateur et le serveur. Un rechargement de la page résout ce problème.

  5. Cliquez sur le bouton Live Data (page d’aperçu uniquement) — Sur la page d’aperçu, cliquer sur le bouton Live Data force une actualisation manuelle des données.

Pages associées

Mis à jour