What you need to know
A report can disappear at expiry or remain as an error; an infinite lifetime does neither automatically.
Potentially affected
Azure Service Fabric applications with custom periodic health reports.
DSE recommendation
Define report lifetime and expiry behavior as part of the reporter's failure-detection contract.
Source facts
A Service Fabric health report’s TimeToLive defines its validity and defaults to infinite. With RemoveWhenExpired set to true, an expired report is removed and no longer affects entity health. With the setting false, expiry is evaluated as an error, representing a reporter that failed to refresh its state.
A retained expired report makes the entity’s evaluation Error regardless of the report’s original health state. Queries expose IsExpired only for retained events; removed expired reports are no longer returned. Microsoft Learn.
Applicability
Identify each custom reporter, property, expected refresh cadence and intended response to silence. Distinguish a temporary observation from a watchdog that must keep reporting.
DSE recommendation
DSE recommends choosing lifetime and expiry handling together. For a periodic watchdog, explicitly decide whether missing reports should raise an error instead of silently disappearing. For a temporary event, define how it will clear. Avoid leaving the default infinite lifetime unexamined when the operational requirement is freshness.
Verification
In a controlled environment, stop refreshing a test report and observe the entity after its configured lifetime. Compare both the returned event and aggregated health with the intended behavior. Resume reporting and verify recovery. Record the source, property and settings so a stale OK report is not accepted as proof that the monitored component is still healthy.
Official references
Microsoft Learn: Health monitoring in Service Fabric. Source retrieved September 9, 2026.
Review the official source
Health monitoring in Service Fabric - Azure Service Fabric | Microsoft Learn · Verified September 9, 2026
Need help applying this guidance safely?
DSE can help confirm applicability, protect service continuity, and validate the result across physical security and IT systems.
Talk with DSE