Journalisation

Miravo utilise consola avec des loggers tagués pour chaque sous-système.

Niveaux de log

Niveau	Flag	Description
debug	--verbose	Évaluations de générateurs, détails de tick, internals des adaptateurs
info	Défaut	Démarrage, arrêt, résumés périodiques, transitions d’état
warn	—	Avertissements de dépassement, saturation des adaptateurs, avis de dépréciation
error	—	Échecs de tick, erreurs d’adaptateur, échecs de commande

Définir le niveau :

miravo start --log-level debug
miravo start --verbose          # Équivalent à --log-level debug
miravo start -q                 # Silencieux : supprimer la sortie non-erreur

Priorité : -q/--quiet > --log-level > --verbose.

Formats de sortie

Pretty (défaut)

Sortie colorée lisible par l’homme avec des préfixes tagués :

[engine] Simulation "smart-factory" started (7 instances, 1 template)
[mqtt]   Embedded broker listening on 127.0.0.1:1883
[engine] Tick 30 | 7 instances · 168 values | MQTT: 168 pub · 0 err

JSON

JSON structuré, un objet par ligne. Idéal pour l’agrégation de logs (ELK, Datadog, Loki) :

miravo start --log-format json

{"ts":"2026-03-18T10:00:00.000Z","level":"info","tag":"engine","simulationName":"smart-factory","runId":"abc123","message":"Simulation started"}

Champs JSON : ts, level, tag, simulationName, runId, message.

Plain

Sans couleurs ni formatage. Utile pour CI/CD ou les pipes :

miravo start --plain

Ou via variable d’environnement :

NO_COLOR=1 miravo start

Tags des loggers

Chaque sous-système a un logger tagué :

Tag	Sous-système
engine	Moteur principal, scheduler, cycle de vie
mqtt	Adaptateur MQTT, broker, transport de contrôle
opcua	Adaptateur OPC UA, serveur, espace d’adresses
admin	Serveur HTTP admin
cli	Traitement des commandes CLI

Résumé périodique

Toutes les 30 secondes (configurable avec --summary-interval), Miravo journalise une ligne de résumé :

Tick 1800 | 7 instances · 168 values | MQTT: 302,400 pub · 0 err | OPC UA: disabled

Inclut le nombre de ticks, d’instances, de valeurs de membres et les statistiques par adaptateur.

Streaming d’événements

Utilisez miravo logs pour streamer les événements de domaine depuis une simulation en arrière-plan :

Streamer tous les événements :

miravo logs my-sim

50 derniers événements, puis streamer :

miravo logs my-sim --tail 50

Filtrer par canal :

miravo logs my-sim --channels faults,lifecycle

Canaux disponibles : tick, faults, lifecycle, instances, engine, adapters.