lumio logs

Stream server function logs in real time (or fetch historical logs). Useful for debugging production server functions.

Usage

lumio logs [--follow] [--since <time>] [--level <level>] [--version <semver>]

Example

# Stream logs in real time
lumio logs --follow

# Show last hour of logs
lumio logs --since 1h

# Show only errors
lumio logs --level error

[2026-05-12T10:34:12Z] [info]  getScoreboard called: sport=football league=nfl
[2026-05-12T10:34:12Z] [info]  ESPN API response: 200 OK (342ms)
[2026-05-12T10:34:13Z] [info]  getScoreboard returned 8 events
[2026-05-12T10:34:45Z] [error] addRule failed: text field is required (installation: abc123)
[2026-05-12T10:35:01Z] [warn]  rate limit approaching: castVote 45/50 calls this minute

Options

Flag	Description
--follow	Stream logs in real time (like tail -f). Press Ctrl+C to stop
--since <time>	Show logs from this time ago. Accepts 5m, 1h, 24h, 7d
--level <level>	Filter by log level: debug, info, warn, error
--version <semver>	Show logs only for a specific version
--json	Output machine-readable JSON (one JSON object per line)
--limit <n>	Maximum number of log lines to fetch (default: 100)

Log levels

Level	When it appears
debug	console.debug() calls in server functions
info	console.log() and console.info() calls
warn	console.warn() calls and SDK rate limit warnings
error	Uncaught exceptions, rejected actions, timeout errors

Filtering by installation

Use --installation <id> to see logs from a specific overlay installation:

lumio logs --installation abc123def456 --follow

The installation ID is visible in the extension dashboard under Installations.

JSON format

lumio logs --json --limit 5

{"timestamp":"2026-05-12T10:34:12Z","level":"info","function":"getScoreboard","message":"ESPN API response: 200 OK (342ms)","installationId":"abc123"}
{"timestamp":"2026-05-12T10:34:45Z","level":"error","function":"addRule","message":"text field is required","installationId":"abc123"}

Notes

• Logs are retained for 30 days
• Logs are only available for server functions (server: true) — client-side extensions have no server logs
• console.log() calls in server functions appear as info level
• Sensitive values (secrets, user data) are automatically redacted in logs