Docs / Troubleshooting / Monitoring Data Missing Playbook

Monitoring Data Missing Playbook

Published · Last updated: May 2026 · 3 min read

Who this is for

Users who see blank or stale charts in the Monitoring tab, or whose metrics haven't updated in a while.

How Monitoring Data Works

CloudAIPilot collects server metrics (CPU, memory, disk, network) via two methods:

  1. CloudAIPilot Agent — a lightweight agent installed on the server, reports metrics directly.
  2. SSH polling — CloudAIPilot SSH-es into the server periodically to collect metrics.

If neither method is working, the monitoring charts will be blank or stale.

Step 1 — Check the Agent Status

  1. Open Server detail → Monitoring tab.
  2. Look for an Agent status indicator.
  3. If the agent shows "Offline" or "Not installed":

If agent was previously installed:

  • SSH to the server and check: sudo systemctl status cloudpilot-agent
  • Restart if needed: sudo systemctl restart cloudpilot-agent

If agent is not installed:

  • Go to Server detail → click Install Agent.
  • Follow the instructions to install the monitoring agent.

Step 2 — Check SSH Polling (Fallback)

If the agent is unavailable, CloudAIPilot falls back to SSH polling. If metrics are still missing:

  1. Verify SSH is working — see KB-12-05: SSH Unreachable Playbook.
  2. Once SSH is restored, metrics collection resumes automatically.

Step 3 — Check for Data Gaps

If some time periods are missing in charts but newer data is present:

  • The server was offline during that period. Gaps in monitoring charts represent periods when the server was unreachable.
  • This is expected and does not require any action.

Step 4 — Check the Server Status

If the server status is stopped:

  • CloudAIPilot cannot collect metrics from a stopped server.
  • Start the server to resume metrics collection.

If the server status is error:

Step 5 — Wait for Metrics to Appear

After restoring connectivity or installing the agent:

  • Metrics typically appear within 1–5 minutes.
  • Charts update in near real-time once the agent or SSH polling resumes.

If metrics do not appear after 10 minutes of confirmed SSH/agent connectivity, reload the CloudAIPilot dashboard.

Common Scenarios

SymptomLikely causeFix
Blank chart for all metricsSSH down or agent offlineRestore SSH or restart agent
Charts show data up to X hours ago, then blankServer or agent crashed at that timeRestart agent or fix SSH
Disk usage not updatingAgent reporting but disk metric missingReinstall agent or check agent config
CPU shows 0% when server is clearly busySSH/agent data is stale — dashboard cachedRefresh the page; check agent status
Monitoring data fine but alerts never fireAlert rules misconfiguredCheck threshold values — see KB-06-03

Related Articles