First agent

Steps

1. Open the cabinet → Agents → Register an agent.
2. Copy the one-time enrollment token (TTL 30 minutes).
3. On the target host:

unimoni-agent --enroll --token=ENROLLMENT_TOKEN --api=https://your-api:8443

1. The agent generates a CSR, receives a client cert and starts pushing metrics every 15 seconds.

Verification

In the cabinet on the Agents page the status should turn active within ~15 seconds. On /app/dashboards you can build your first dashboard with CPU/RAM/Disk widgets.

What if the status stays pending

• Check the firewall — the agent must reach :8443.
• Check /tmp/api.log on the server — cert-handshake errors show up there.
• The token lives 30 minutes. Expired? Issue a new one.