Guide pratique

Créer un dashboard temps réel avec MQpanel

Un dashboard MQpanel est une grille de widgets glisser-déposer, chacun branché sur un ou plusieurs topics MQTT : il affiche vos données en direct et peut aussi publier des commandes vers vos appareils.

schedule 8 min de lecture
  1. 1

    Créer un nouveau dashboard

    Depuis « Dashboards », créez un dashboard, donnez-lui un nom et éventuellement un préfixe MQTT commun (mqtt_prefix) qui sera automatiquement préfixé à tous les topics de ses widgets.

  2. 2

    Ajouter des widgets sur la grille

    Glissez-déposez un widget depuis le catalogue, redimensionnez-le librement sur la grille : chaque widget peut occuper de 1 à N cellules.

  3. 3

    Brancher le widget sur un topic

    Configurez le topic MQTT à écouter (et éventuellement à publier), le type de payload (brut, JSON avec une clé précise) et l'apparence du widget (couleurs, unité, plage de valeurs).

  4. 4

    Organiser comme un système de fichiers

    Utilisez les tags (Production, Maintenance, Zone A...) pour structurer vos dashboards comme dans un véritable système de fichiers. Ces tags agissent comme des dossiers virtuels, permettant de classer et retrouver instantanément vos interfaces, même si vous en gérez des dizaines.

  5. 5

    Partager ou intégrer

    Chaque dashboard dispose d'un lien de consultation par token à partager à un client. Par sécurité, l'accès MQTT en arrière-plan est strictement restreint aux seuls topics configurés sur les widgets avec les permissions minimales. L'utilisation du wildcard global '#' seul est interdite (mais 'prefix/#' reste autorisé).

16 types de widgets disponibles

De la simple valeur affichée au graphique temps réel, chaque widget se connecte indépendamment à MQTT — un dashboard peut mélanger autant de widgets et de topics que nécessaire.

Contrôle & interaction

  • Bouton
  • Interrupteur (Switch)
  • Boutons radio
  • Liste déroulante (Combo)
  • Curseur (Slider)
  • Sélecteur de couleur

Affichage de valeurs

  • Texte
  • Texte de sortie
  • Icône d'état
  • Barre de progression
  • Jauge (Gauge)
  • Texte statique

Graphiques & séries temporelles

  • Graphique en ligne (Chart)
  • Graphique en barres
  • Graphique circulaire (Pie)
  • Champ de saisie texte

Exemple : un widget Graphique branché sur une télémétrie

factory/oven-3/temperature
Live

Aperçu du rendu d'un widget « Chart » recevant une température toutes les 5 secondes sur factory/oven-3/temperature — chaque nouveau message MQTT ajoute un point sans recharger la page.

Le préfixe MQTT du dashboard

Plutôt que de ressaisir usine/four-3/ dans chaque widget, définissez-le une seule fois comme préfixe du dashboard : chaque widget n'a plus qu'à préciser son sous-topic (temperature, pression, statut...), ce qui simplifie la maintenance si vous dupliquez le dashboard pour un autre four.

Configuration multi-écrans (Responsive)

L'interface du dashboard est entièrement responsive et s'adapte dynamiquement à la taille de votre écran. La personnalisation de la disposition est spécifique au type d'appareil utilisé : une configuration effectuée sur ordinateur n'affectera pas l'affichage mobile, et inversement. En l'absence de disposition spécifique pour un appareil donné, les widgets s'organiseront automatiquement de manière séquentielle pour garantir une lisibilité optimale.

Mode Édition et Mode View

Mode Édition

L'interface principale pour concevoir votre dashboard : ajout, suppression et configuration des widgets.

Mode View

Permet d'avoir un aperçu de ce que les utilisateurs du partage vont voir (vue lecture ou contrôle limité).

Statistiques de consultation

Vous pouvez suivre l'utilisation de vos dashboards depuis la page des statistiques. Vous y retrouverez le nombre total de dashboards, le nombre de partages, le nombre de visites et le nombre de messages envoyés. En cliquant sur les statistiques d'un dashboard spécifique, vous accédez à : son nombre de partages, le nombre de messages qu'il a publiés, le dernier utilisateur à s'y être connecté, ainsi qu'un historique complet des événements (date, client, topic et payload envoyé).

Logs MQTT en direct

Pour faciliter le débogage de vos widgets, l'éditeur de dashboard dispose d'un panneau de logs en direct. Il affiche en temps réel tous les messages MQTT reçus et publiés par le dashboard, vous permettant de vérifier instantanément vos topics et payloads. Cette journalisation garantit également la sécurité et la traçabilité des opérations en conformité avec le Règlement machines (UE) 2023/1230.

FAQ

Oui : un widget Interrupteur ou Curseur par exemple affiche le dernier état reçu sur un topic (lecture) et publie une nouvelle valeur sur un topic dès que l'utilisateur interagit avec (écriture), qui peuvent être identiques ou différents.