Tutorial

Create and install a server agent

Provision a server monitor, generate the install script, and confirm the agent is reporting health data.

1) Create the agent record

  1. Open Dashboard → Server agents.
  2. Click Install agent (or New if creating from scratch).
  3. Name the agent, choose region/tags, and save.

Tags help you group hosts (e.g., edge, db, us-east-2).

2) Run the install command

  1. Copy the generated shell command from the dashboard.
  2. SSH into the target host and paste the command.
  3. The script warns if not run with sudo and asks for confirmation.
  4. Confirm to download, register, and start the agent service.

Agents communicate over HTTPS only. No inbound ports are required.

3) Verify the connection

  • Return to the Server agents page; the agent should show Online within seconds.
  • Click the agent to view last heartbeat, CPU/memory, and attached monitors.
  • If status is Unknown, refresh or check network egress from the host.