keepcalculator

06 Numbers and Powers

Troubleshoot Gaps in Infrastructure Monitoring Data

Card No. 06·59516 · Updated · Standard formula, shown below

Missing points, delayed metrics, or blank periods can make infrastructure alerts and dashboards unreliable. Use this guide to trace the gap from the monitored host through collection, transport, storage, and display; have access to the affected system and monitoring configuration before you begin.

What You’ll Need

  • The name of an affected host, service, metric, and an example time range, including its time zone.
  • Read-only access to the relevant dashboard and monitoring system; administrative access may be needed to inspect agents or configuration.
  • Access to host, collector, network, and monitoring-platform logs, plus a known-good host or metric for comparison.
  • Your monitoring system’s documentation and change history, if available. Avoid sharing credentials or sensitive log data.

Step-by-Step

  1. Define exactly what is missing. Record the host, metric name, expected collection interval, first and last missing timestamps, and whether the gap affects one metric, one host, or many. Note whether values stop entirely, arrive late, or appear only in the dashboard. Check the dashboard’s selected time range, filters, aggregation, and time zone; a display setting can resemble missing data.
  2. Compare raw data with the chart. Query the monitoring system’s underlying series or inspect its data explorer for the same host, metric, and interval. If raw points exist, investigate dashboard filters, transformations, downsampling, or permissions rather than the agent. If raw points are absent, continue upstream. Use the platform’s supported query tools and avoid changing retention or sampling settings during diagnosis.
  3. Check whether the host and agent are healthy. Confirm that the host is reachable and that its monitoring agent or exporter is running. Review service status and logs around the first missing timestamp for restarts, crashes, configuration errors, resource exhaustion, or permission failures. Check that the agent is configured to collect the specific metric and that the endpoint or local source it reads is available. Compare its status with a healthy peer running the same configuration.
  4. Inspect collection and scrape results. In pull-based systems, check target discovery, scrape status, and the last successful collection time. Look for failed health checks, timeouts, rejected samples, or a target that disappeared after a configuration or label change. In push-based systems, check the sender’s queue, delivery status, and response errors. Confirm that the expected interval and target identity have not changed. A healthy host does not prove that its metrics are being collected.
  5. Trace the route between source and collector. Check DNS resolution, routing, firewall rules, proxy settings, and required ports from the system that actually makes the connection. Review network or collector logs for resets, timeouts, TLS or certificate failures, and connection limits. Test reachability using approved tools and existing access rules; do not open ports broadly as a diagnostic shortcut. If many hosts fail behind the same network boundary, prioritize that shared path.
  6. Check collector capacity and buffering. Look for high CPU or memory use, full disks, queue growth, dropped samples, backpressure, or restarts. Compare ingestion volume and error counts before and during the gap. A collector that is overloaded may accept some streams while dropping others. Check whether a recent increase in targets, label cardinality, or traffic coincides with the incident. Follow platform guidance before raising limits or discarding queued data.
  7. Verify ingestion, timestamps, and identity. Inspect ingest logs or platform status for rejected or delayed samples. Check for invalid metric names, label changes, duplicate series, timestamp parsing problems, and samples outside the platform’s accepted time window. Compare the host clock with a trusted time source and confirm the agent, collector, and backend use compatible timestamp conventions. Do not manually rewrite timestamps or delete series until you understand the effect on historical data.
  8. Check backend health and retention. Review storage availability, ingestion errors, quotas, retention rules, and any incident notices from the platform. Determine whether only older points have expired or whether recent data is failing to persist. Check whether a policy or routing rule directs this metric to another dataset. If storage is degraded, preserve logs and escalate to the platform owner rather than repeatedly restarting healthy agents.
  9. Review recent changes and test one controlled fix. Compare the incident start with deployments, agent upgrades, credentials or certificate changes, firewall edits, configuration rollouts, and maintenance. Prefer a reversible correction on one affected target, such as restoring a known-good scrape setting or fixing an expired credential. Record the change, then verify fresh points at the expected interval before applying it more widely.
  10. Confirm recovery and document the cause. Check that new samples arrive at the source, collector, backend, and dashboard, and that timestamps and labels are correct. Confirm alert behavior without silencing unrelated alerts. Note the cause, affected time range, fix, any unrecoverable gap, and preventive action. Some systems do not backfill lost data; do not assume a recovered feed will fill historical gaps.

Common Mistakes

  • Assuming a blank chart means the host is down. First distinguish missing raw samples from a display or query issue.
  • Checking the wrong time zone or range. Compare timestamps in a consistent zone and account for daylight-saving changes.
  • Restarting agents before saving logs. A restart can clear useful evidence and may hide a recurring failure.
  • Changing several settings at once. Make one controlled change so you can identify what helped or made matters worse.
  • Ignoring labels and identity. A renamed host or changed label can create a new series while the old chart appears empty.
  • Assuming the platform can reconstruct missing points. Backfill depends on whether the source retained data and whether the platform supports it.

Tips

  • Keep a small, reliable set of monitoring checks for agent health, collector queue depth, ingestion errors, and sample freshness.
  • Use a known-good peer and compare configuration, versions, labels, permissions, and network path rather than relying on memory.
  • Track expected collection intervals. A gap of one interval may be transient; repeated misses or a longer outage warrants investigation.
  • Maintain synchronized clocks and document time zones in incident notes. Accurate timestamps make logs from separate systems comparable.
  • After resolution, add a targeted alert for stale data or failed collection where appropriate, and review whether the alert itself needs a clear owner.

Troubleshooting

Only one metric is missing: Check its collection configuration, source permissions, name, labels, and whether the application still exposes it. Compare the same metric on a peer.

Many metrics from one host are missing: Focus on agent health, host resources, credentials, and the host’s connection to its collector. Check logs at the start of the gap.

Many hosts are affected at once: Investigate shared collectors, network boundaries, central configuration changes, and backend health. Escalate to the team that owns the shared component.

Data arrives late or intermittently: Examine queue growth, retries, timeouts, resource pressure, and clock synchronization. Compare source timestamps with ingestion timestamps to locate the delay.

Raw data exists but the dashboard remains blank: Verify query filters, metric labels, aggregation, permissions, and dashboard time settings. Test a simple query against the raw series before editing the dashboard.

The cause is unclear or the fix risks data loss: Preserve relevant logs and configuration, avoid destructive cleanup, and contact the monitoring-platform owner with the affected series, timestamps, and checks already completed.

Frequently Asked Questions

Why are there gaps if the server is online?
An online server can still have a stopped agent, failed scrape, blocked network path, rejected samples, or an issue in storage or display.

Can missing monitoring data be recovered?
Only if another source retained the measurements or the monitoring system supports backfill. Check before attempting a replay, since duplicate or stale samples may be rejected.

How long should I wait before treating a gap as an incident?
Use the metric’s normal collection interval and your service’s freshness expectations. A brief delay may be normal, but repeated missed intervals or an alert threshold should trigger investigation.

Should I restart the monitoring agent?
Not as the first step. Capture its status and logs first, then restart only when evidence or platform guidance supports it and the operational impact is understood.

What details should I include when escalating?
Include affected hosts and metrics, exact timestamps and time zone, expected interval, error messages, recent changes, checks performed, and whether the issue affects raw data or only a dashboard.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →