Host monitoring
Hosts give you server-level visibility through a lightweight push agent. Install it on a Linux or Windows box and it streams CPU, memory, disk and network metrics — no inbound ports, no scraping.
- Read
- 4 min
- Sections
- 4
- Limits
- Free 1 · Pro 25 · Business ∞
Add a host
Click New host to create a host record and get an enrollment token. The host starts in pending state until the agent checks in. Install the agent on the server with the token:
# Linux — install and enroll with the token from the New host drawer
curl -fsSL https://your-datarunner.com/agent/install.sh | sh -s -- \
--token dr_host_xxxxxxxxxxxx \
--url https://your-datarunner.comOn Windows, run the equivalent installer from the drawer. Once the agent reports in, the host flips to online and its hostname, OS, and agent version populate.
Status & freshness
The list ranks hosts that need attention first. Each host is in one of four states:
- online — agent reporting on schedule
- stale — last sample is overdue; agent may be struggling
- offline — no recent samples; the box or agent is down
- pending— created but the agent hasn't enrolled yet
What the agent streams
CPU, memory, disk and network are sampled and pushed on an interval. Raw samples are kept per your plan's host-metrics retention (7 days Free, 30 days Pro, 90 days Business); rolled-up 1-minute and 1-hour aggregates live longer for trend charts on the host detail page.
Alerting on hosts
Host conditions feed the same alerting pipeline as monitors. Route host alerts to channels, escalate via on-call, and silence them during planned work — see Alerting and Maintenance windows.