Skip to main content

Change the host-metrics scrape interval

The scrape interval controls how often the agent collects host metrics (CPU, memory, disk, filesystem, network, load) and forwards them to AtherOps. The default is 30 seconds.

Set it locally

Edit /etc/atherops/config.yaml:

collection:
scrape_interval: 15s

Use a Go-style duration string (10s, 30s, 1m). Save the file; the agent restarts the collector with the new interval automatically.

A shorter interval gives finer-grained metrics but increases CPU, network, and storage. 15s60s is typical for host metrics. Start at the 30s default and adjust if you need more resolution.

Set it from the platform (remote config)

scrape_interval is a remote-configurable field (marked # [remote] in the config file). A platform operator can push a value from the backend; on the next poll the agent applies it and restarts the collector. A remotely pushed value overrides the local default.

When a remote change is applied you will see:

level=info msg="remote config applied" ... changed=true
level=info msg="config reloaded, restarting collector"

See also