Keep VM availability state separate from the annotation explaining it

Source facts

Azure Resource Graph exposes the latest platform-assessed VM availability through availabilitystatuses and contextual details through resourceannotations. Unknown means the platform cannot accurately determine VM health, rather than confirming an outage. Annotations include downtime, informational, and degraded categories. Their context distinguishes platform-, user-, or VM-initiated activity; their planned/unplanned category does not apply to customer- or VM-initiated events. Microsoft Learn.

Applicability

Use this review when querying HealthResources for an Azure VM investigation or dashboard. Identify the affected VM and the interval being examined. Treat the latest status and an annotation’s occurrence time as separate observations, and avoid replacing an unknown or inapplicable value with an invented failure classification.

DSE recommendation

Preserve the resource ID, observation time, availability state, and annotation context as separate fields. Have the incident owner define how an Unknown state will prompt further checking without being counted automatically as confirmed downtime. Keep informational control-plane activity distinct from availability loss. Correlate the platform record with the application’s own evidence before attributing a user-visible incident to a particular operation.

Verification

Test the query against representative available, unavailable, unknown, and annotated records. Inspect whether null or inapplicable category values remain distinguishable from planned and unplanned activity. Compare the output with the underlying source record and the application’s timeline. Retain conflicting observations for investigation rather than forcing them into a single status merely to simplify a dashboard or incident summary.

Official references

Microsoft Learn: VM availability information in Azure Resource Graph. Source reviewed September 9, 2026.