Agent & Exporter Installation

The MonSPHERE agent is a small binary that connects to agent-gateway over mutual TLS gRPC, registers itself against an enrollment token, then installs and supervises Prometheus exporters on the host via the Docker Engine API.

Generate an enrollment token

From the dashboard, or via API:

curl -X POST https://api.monsphere.com/api/v1/organizations/:orgId/agents/enroll-tokens \
  -H "X-Api-Key: msk_live_..."

Agent creation is quota-checked against your plan's agent_limit — Free plans include 1 agent, Professional includes 10.

Install the agent

curl -fsSL https://get.monsphere.com/agent | \
  sh -s -- --token=<enrollment_token> --gateway=agents.monsphere.com:50051

On first connection the agent registers itself, receives its exporter configuration, and starts supervising node_exporter (and any other configured exporters) as Docker containers — no manual exporter installation or Prometheus scrape-config editing required.

Exporter management

Once an agent is connected, exporters can be added, reconfigured, or removed centrally — the agent reconciles its local Docker containers to match. Exporter health (running/stopped/restart count) is visible per host in the dashboard and queryable via the API.

What gets monitored automatically

Node-level CPU, memory, disk, and network metrics flow in immediately through node_exporter. Container-level metrics are available through the same Docker Engine API integration the agent already uses to manage exporters — no separate cAdvisor install required.