Logging

Control Miravo log levels, pretty output, JSON output, and streamed event channels.

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?