Machine agent

Host/process metrics, log scraping, and platform-issued commands.

machine-agenthostlogsinstallconfig

Machine agent

The machine agent runs on a host and reports metrics and process activity, scrapes logs, and can run platform-issued commands (for example, a Workbook remediation).

Install

# Docker
docker run -d --name verops-machine-agent --restart unless-stopped \
  --pid host --network host \
  -v /var/log:/host/var/log:ro \
  -e VEROPS_API_KEY=$VEROPS_INGEST_KEY \
  -e VEROPS_HOST_NAME=$(hostname) \
  verops/machine-agent:latest

What it collects

  • Host metrics — CPU, memory, disk, network.
  • Process snapshots — what's running and consuming resources, over time.
  • Logs — scrape configured files/paths for collection, search and alerting.

Log scraping configuration

logs:
  - name: app
    path: /host/var/log/myapp/*.log
    # optional: include/exclude patterns, multiline join

Using it in Workbooks

The Log Collector node pulls recent lines so a Workbook can assert "no ERROR in the last 5 minutes" as part of a journey. Because the agent can also run commands, a Workbook's HTTP Action/remediation can reach private hosts safely.