Agent Configuration Reference

The agent component reports telemetry and forwards incident events to the central DevLens API. It can be deployed on any host that has network connectivity to the API endpoint. You can obtain an DevLens API key by creating one in the automatically created DevLens project in the web UI.


Agent Settings

TOML key Environment variable Type Default Example Notes
api_host DEVLENS_AGENT_DEVLENS_HOST string https://devlens.company.tld Full URL of the DevLens API (must include scheme).
api_key DEVLENS_AGENT_DEVLENS_API_KEY string s3cr3t-API-KEY Key used for authenticating the agent against the API.
stats_interval_s DEVLENS_AGENT_STATS_INTERVAL int 60 How often (in seconds) the agent should push health‑check statistics to the API.

Example agent.toml

api_host        = "https://devlens.company.tld"
api_key         = "s3cr3t-API-KEY"
stats_interval_s = 60