Logging

Control Miravo log levels, pretty output, JSON output, and streamed event channels for local debugging, automation, and CI runs.

Miravo writes operational logs to stdout and command failures to stderr. Tune output before wiring Miravo into a terminal multiplexer, container log collector, or NDJSON pipeline.

Levels

Level	Switch	What shows up
`debug`	`--log-level debug` or `--verbose`	Tick details, adapter internals, and verbose startup traces
`info`	Default	Startup, shutdown, state transitions, periodic summaries
`warn`	`--log-level warn`	Warnings and errors only
`error`	`--log-level error` or `--quiet`	Errors only

--quiet wins over --log-level. --log-level wins over --verbose. NO_COLOR removes ANSI styling. --plain keeps the stable text layout without ANSI styling.

Output format

[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

Event streaming

Command	Result
`miravo logs`	Stream all channels except `tick`
`miravo logs --tail 50`	Print recent events before opening the stream
`miravo logs --channels faults,lifecycle`	Restrict the stream to selected channels
`miravo logs --json`	Emit NDJSON for `jq`, Loki, or other consumers

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

Reference

Switch or env var	Effect
`--log-level <level>`	Select `debug`, `info`, `warn`, or `error`
`--verbose`	Shorthand for `--log-level debug`
`--quiet`	Suppress non-error output
`--log-format json`	Emit structured JSON lines
`--plain`	Keep plain text without ANSI styling
`NO_COLOR=1`	Remove ANSI styling from pretty output
`MIRAVO_DEBUG=1` or `--debug`	Print stack traces for unexpected failures

CLI ⭢ miravo logs

Stream flags, --json, --tail, and channel filters.

Docker

Container log routing and health probe output.

Environment variables

MIRAVO_DEBUG and NO_COLOR defaults.

Was this page useful?