Monitoring & Logs

1. Create a workspace

A workspace is the unit of tenancy: one bucket of metrics + logs scoped to one Grafana org. Create one in the portal at /portal/monitoring/new or from the CLI:

cloudnx obs workspace create prod \
  --metrics-retention 14 \
  --logs-retention 7

2. Mint an API key

The agent installer needs a write-scoped key. The Create-workspace wizard mints one for you and shows it once; copy it immediately. From the CLI:

cloudnx obs api-key mint --workspace prod --scope write

3. Install the agent on a VM

SSH into the VM and run the installer. It drops in node_exporter + promtail as systemd units, configures them with your workspace token, and registers the host. Total install time ~20s.

curl -fsSL https://metrics.cloudnx.in/agent/install.sh \
  | OBS_API_KEY=<your-token> sudo sh

4. Open Grafana

Go to grafana.cloudnx.in— your CloudNx session signs you in automatically and lands you on your workspace's org. Default dashboards: node-exporter overview, log volume, top promtail labels.

5. LogQL cheatsheet

Common queries to get going:

• {job="varlogs"} |= "ERROR" — errors across all hosts
• rate({app="myapp"}[1m]) — log volume per minute
• {host="web-01"} | json | level="error" — JSON-parsed structured logs