Slide 4 of 6

Health status indicators

What Fleet Management checks

Fleet Management continuously monitors your collectors and checks three things. Based on these checks, each collector receives a health status.

CheckQuestion it answers
Check-inHas the collector contacted Fleet Management in the last 30 minutes?
AlertsAre any user-created alerts firing for this collector?
Config errorsDid the collector load its remote configuration without errors?

Fleet Management doesn’t create alerts. It surfaces active alerts you’ve created in your stack.

Health status indicators

StatusColorMeaningAction
HealthyGreenAll checks passing, collector is operational.None needed
WarningYellowNon-critical alert, or the collector hasn’t checked in.Investigate soon
ErrorRedCritical alert, or a remote configuration error.Investigate immediately
UnknownGrayCollector hasn’t reported any telemetry yet (no heartbeat).Confirm it started

A quick glance tells you what needs attention. Green is fine, yellow needs a look soon, and red needs investigating now. Gray means a collector hasn’t reported in yet, so check that it started and can reach Grafana Cloud.

Script

Once your collectors are registered, you need to know if they’re working properly. That’s what health monitoring is for.

Fleet Management continuously checks your collectors and reports their status. But what does “healthy” actually mean? It’s not just “is the process running.” Fleet Management looks at several factors to give you a complete picture.

First, is the collector checking in? Has it contacted Fleet Management in the last 30 minutes?

Second, are any alerts firing? This is important. Fleet Management doesn’t create alerts automatically. It surfaces active alerts that you’ve created in your stack. This is intentional. Alerting thresholds are different for every team. You define what matters, and Fleet Management surfaces those alerts in context.

And finally: has the collector loaded its remote configuration successfully or are there errors preventing it from doing so?

Based on these checks, each collector gets a status. Green means everything is fine. Yellow means something needs attention soon. Red means investigate immediately. And gray means the collector hasn’t reported any data yet, so you’ll want to confirm it started and can reach Grafana Cloud. This lets you scan your entire fleet at a glance and know exactly which collectors need your attention.