Journalisation

Contrôlez les niveaux de log Miravo, la sortie pretty, la sortie JSON et les canaux d'événements streamés.

Miravo écrit les logs opérationnels sur stdout et les échecs de commande sur stderr.

Détails techniques

Niveaux

Level	Switch	Ce qui apparaît
`debug`	`--log-level debug` ou `--verbose`	Détails de tick, internals des adaptateurs et traces de démarrage verbeuses
`info`	Par défaut	Démarrage, arrêt, transitions d'état et résumés périodiques
`warn`	`--log-level warn`	Avertissements et erreurs uniquement
`error`	`--log-level error` ou `--quiet`	Erreurs uniquement

Priorité

--quiet gagne sur --log-level. --log-level gagne sur --verbose. NO_COLOR retire le style ANSI. --plain garde la mise en forme texte stable sans style ANSI.

Format de sortie

[engine] Environment "smart-factory" started
[mqtt]   Embedded broker listening on 127.0.0.1:1883
[engine] Tick 30 | 6 instances · 168 values | MQTT: 168 pub · 0 err

miravo start --log-level info
miravo logs --channels faults,lifecycle

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

miravo start --log-format json
miravo logs --json --channels faults

Flux d'événements

Command	Résultat
`miravo logs`	Stream tous les canaux sauf `tick`
`miravo logs --tail 50`	Imprime les événements récents avant d'ouvrir le flux
`miravo logs --channels faults,lifecycle`	Restreint le flux aux canaux choisis
`miravo logs --json`	Émet du NDJSON pour `jq`, Loki ou d'autres consommateurs

miravo logs --channels faults --json | jq -r '.message'

Référence

Switch ou variable d'environnement	Effet
`--log-level <level>`	Sélectionne `debug`, `info`, `warn` ou `error`
`--verbose`	Raccourci pour `--log-level debug`
`--quiet`	Supprime la sortie non erreur
`--log-format json`	Émet des lignes JSON structurées
`--plain`	Garde le texte sans style ANSI
`NO_COLOR=1`	Retire le style ANSI de la sortie pretty
`MIRAVO_DEBUG=1` ou `--debug`	Imprime les stack traces des erreurs inattendues