Reference: agent log lines
The agent logs in logfmt. Each line has a level, a msg, and relevant
key=value pairs. Logs go to journald; tail them with:
journalctl -u atherops-otel-agent -f
Default verbosity is INFO. Set --log-level=debug or LOG_LEVEL=debug to see
DEBUG lines (health-check polls and heartbeats are DEBUG to keep INFO quiet).
Line catalog
| Event | Level | Example line |
|---|---|---|
| Agent started | INFO | level=info msg="agent started" agent_version=1.2.0 host_id=h_7f3a2b |
| Collector started | INFO | level=info msg="collector started" collector_version=0.102.0 pid=3821 |
| Collector health OK | DEBUG | level=debug msg="collector healthy" endpoint=:13133 |
| Collector crashed | ERROR | level=error msg="collector exited unexpectedly" exit_code=1 restarts=3 |
| Collector restarting | INFO | level=info msg="restarting collector" delay=2s restarts=3 |
| Collector crash-looping | ERROR | level=error msg="collector crash-looping (5 restarts in 60s) — pausing restart for 5m" |
| Config reloaded | INFO | level=info msg="config reloaded, restarting collector" |
| Remote config applied | INFO | level=info msg="remote config applied" target_collector=0.103.0 changed=true |
| New collector version fetched | INFO | level=info msg="collector updated" old=0.102.0 new=0.103.0 |
| Collector upgrade aborted (bad checksum) | ERROR | level=error msg="collector upgrade aborted" err="sha256 mismatch: ..." |
| Registration done | INFO | level=info msg="registration complete" host_id=h_7f3a2b |
| Heartbeat sent | DEBUG | level=debug msg="heartbeat sent" agent_version=1.2.0 collector_version=0.102.0 |
| Backend unreachable | WARN | level=warn msg="backend unreachable" url=https://api.atherops.com err="connection refused" retry_in=30s |
| Key revoked / 401 | ERROR | level=error msg="authentication failed (401) — key may be revoked" action="halting; delete /etc/atherops/credentials.json to re-register" |
What to act on
- ERROR lines mean something needs you. Match the
msgto an entry in Troubleshooting. - WARN lines are usually transient (network blips) and self-recover on retry.
- INFO/DEBUG are normal operation.