Aller au contenu

Console

Le tableau de bord web intégré de Miravo — parcourez les instances, affichez les métriques en temps réel, streamez les événements et gérez les adaptateurs.

Miravo inclut une console web intégrée pour surveiller et contrôler les simulations depuis votre navigateur.

La console est servie par le serveur HTTP admin. Ouvrez votre navigateur à :

http://127.0.0.1:8080

Dans Docker, assurez-vous que le port 8080 est mappé :

Fenêtre de terminal
docker run --rm -p 1883:1883 -p 8080:8080 amineamaach/miravo:latest

Le tableau de bord principal fournit une vue d’ensemble en temps réel de la simulation en cours :

  • État de la simulation (en cours, en pause, arrêté)
  • Nombre de ticks et temps de simulation
  • Nombre d’instances et résumé de la flotte
  • Métriques par adaptateur (messages MQTT publiés, mises à jour OPC UA, compteurs d’erreurs)

Parcourez toutes les instances actives avec leurs valeurs de membres actuelles, paramètres, étape du cycle de vie et défaillances actives. Sélectionnez une instance pour afficher son détail complet.

Les événements se diffusent en temps réel via WebSocket :

  • Déclenchements et effacements de défaillances
  • Transitions d’étape du cycle de vie
  • Création et suppression d’instances
  • Changements d’état du moteur
  • Événements d’activation/désactivation des adaptateurs

La page de contrôle inclut des cartes de protocole pour chaque adaptateur enregistré (MQTT, OPC UA et les futurs protocoles) :

  • Bascules d’activation/désactivation
  • Métriques en direct (messages publiés, erreurs, état de santé)
  • Détails de configuration (port, hôte)
  • Avertissements de disponibilité de port

La console est une application React + shadcn/ui à page unique construite avec Vite. Elle se connecte aux endpoints REST du serveur admin et au WebSocket pour les mises à jour en temps réel.

La console est intégrée dans l’image Docker et les binaires autonomes. Aucune installation séparée requise.

La console est servie automatiquement quand le serveur admin démarre. Aucune configuration supplémentaire n’est nécessaire.

Pour accéder à la console depuis une autre machine, liez le serveur admin à une adresse non-loopback :

Fenêtre de terminal
miravo start --admin-host 0.0.0.0

Ou via variable d’environnement :

Fenêtre de terminal
MIRAVO_ADMIN_HOST=0.0.0.0 miravo start

Les routes API (/healthz, /metrics, /state, /commands, etc.) ont la priorité sur les routes de la console. Les chemins inconnus sont redirigés vers le routeur SPA.