Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.altnautica.com/llms.txt

Use this file to discover all available pages before exploring further.

Logs

The Logs page is a live tail of the agent’s structured log stream. Each entry shows timestamp, level, service, event, and a JSON payload.
Logs page

Controls

ControlEffect
LevelFilters the stream to entries at or above the selected level.
ServiceFilters to a single systemd unit (ados-supervisor, ados-cloud, etc).
LimitNumber of rows held in the view (default 200).
Pause / FollowPause to inspect a row without auto-scroll; resume to follow.
ClearDrop everything currently in the view.

Levels

The agent uses standard syslog levels:
LevelWhen emitted
debugDetail useful during development. Off by default.
infoLifecycle events, normal operations.
warningA degraded condition the agent recovered from.
errorOperation failed; user attention may be needed.
criticalService-level outage.

Profile gating

Shared route — visible on both profiles.

Backend endpoints

MethodPathPurpose
GET/api/logs?limit=N&level=L&service=SPage through the recent log buffer
The page polls the endpoint every two seconds when Follow is on.

Troubleshooting

No entries match the filter. Drop the level (debug shows everything) or clear the service filter. A truly silent stream usually means the journald buffer rotated out the rows the agent surfaces.
SSH into the node and run journalctl -u ados-supervisor -f. The dashboard surfaces the structured stream the agent emits, which is a superset for our services but does not include kernel-level events.