reactor logs

reactor logs [<target>] [flags]

Description

Stream logs from the Reactor log gateway.

reactor logs                               your project's model, all instances (from reactor.yaml)
reactor logs acme/helios                   a specific model, all instances
reactor logs --session <uuid>              one session
reactor logs --instance helios-aa44-fqwe   one instance

With no argument, reactor logs streams the model defined in the nearest reactor.yaml. Pass a canonical <slug>/<name> to stream a different model. To stream one session or instance, name it with --session / --instance; --model is the explicit form of the <slug>/<name> model target. By default the command prints the historical window (up to the last hour) and then exits. Pass -f / --follow to keep tailing live until Ctrl+C. Combine with shell tools for filtering and slicing:

reactor logs <id> | head -20      # last ~20 historical lines
reactor logs <id> -f | grep ERR   # follow + filter

When stdout is a terminal, structured runtime log lines (JSON) render as a readable single-line format: date and time, LEVEL, message, then the remaining fields as key=value pairs (a record’s exc_info traceback, when present, prints on the lines below). Other lines print verbatim. Piped or redirected output is always the raw line as received (so the examples above and | jq pipelines keep working); pass --raw to force that in a terminal too. Colours honour the NO_COLOR convention. Use --since / --until to request a specific historical window instead of the gateway’s default lookback. Each accepts an RFC3339 timestamp or a duration meaning “that long ago”:

reactor logs <id> --since 2h              # from 2h ago to now
reactor logs <id> --since 3d              # from 3 days ago to now
reactor logs <id> --since 2h --until 30m  # a bounded historical slice

Options

Flag	Description
`-f, --follow`	keep tailing live after the historical window has been printed
`--instance string`	stream one instance, by id (list them with ‘reactor model instances’)
`--model string`	stream a whole model, by <slug>/<name> - the explicit form of the positional
`--raw`	print log lines exactly as received (default when stdout is not a terminal)
`--session string`	stream one session, by UUID
`--since string`	start of the historical window: RFC3339 timestamp or duration ago (e.g. “2h”, “3d”)
`--until string`	end of the historical window: RFC3339 timestamp or duration ago (e.g. “30m”, “3d”); requires `--since`, incompatible with `--follow`

Global options

Flag	Description
`--server string`	Reactor API server URL (default “https://api.reactor.inc”)
`-v, --verbose`	Enable verbose output

Get Started

CLI & Platform

Build a Model

Media & Transport

Releases

Description

Options

Global options

See also

​Description

​Options

​Global options

​See also

Description

Options

Global options

See also