Reference: CLI flags & environment variables
The agent binary is atherops-otel-agent, installed at /usr/local/bin/. Under
normal operation it runs as a systemd service; you rarely invoke it by hand
except for --version.
Flags
| Flag | Effect |
|---|---|
--version | Print the agent and collector versions, then exit. |
--log-level=debug | Run with DEBUG-level logging (health-check polls, heartbeat sends, etc.). Default level is INFO. |
--version
atherops-otel-agent --version
atherops-otel-agent 1.2.0
otelcol-contrib 0.102.0
Exactly two lines. The first token on each line is the name, the second is the
version, so the output is machine-parseable. The collector version is read from
the active collector install (the current symlink under the install dir).
If the collector line shows unknown, the collector binary hasn't been resolved yet. On a fresh host before the agent has run, the current symlink doesn't exist. Start the agent once and the version will appear. See Troubleshooting.
Environment variables
The agent reads these at startup. The installer writes the key ones into
/etc/atherops/env, which the systemd unit loads via EnvironmentFile. Env
values override config.yaml values.
| Variable | Purpose |
|---|---|
ATHEROPS_INSTALL_TOKEN | One-time install token used to register on first start (set by the installer). |
ATHEROPS_API_KEY | API key (normally loaded from credentials.json; env overrides it). |
ATHEROPS_HOST_ID | Host id (normally from credentials.json; env overrides it). |
ATHEROPS_PLATFORM_URL | Override the platform base URL. |
ATHEROPS_API_URL | Override the management-API origin. |
ATHEROPS_INGEST_URL | Override the ingest backend origin. |
NODE_NAME | Override the node/instance name (defaults to the hostname). |
LOG_LEVEL | Set to debug to enable DEBUG logging (same as --log-level=debug). |
CONFIG_PATH | Override the config file path (defaults to /etc/atherops/config.yaml). |
Log output
The agent logs in logfmt to stdout/stderr, which systemd routes to journald. Tail it with:
journalctl -u atherops-otel-agent -f
The complete set of log lines is in Log lines.