Struct HealthAlertReporter 

pub struct HealthAlertReporter { /* private fields */ }

Lets a driver proactively report faults to the driver framework as OnHealthAlert events.

Obtained from crate::DriverContext::health_alert_reporter while the driver is starting. Unlike the rest of the driver’s lifecycle, alerts are driver-initiated and may come from any task or thread, so the reporter is cheap to clone and drivers typically keep one in their own state.

Implementations

impl HealthAlertReporter

pub fn new_for_testing() -> (Self, Receiver<HealthAlert>)

Creates a reporter and alert receiver pair for unit tests that construct a driver directly without a lifecycle server.

pub fn report_health_alert(&self, alert: HealthAlert)

Emits an OnHealthAlert event over the Driver channel to the driver framework.

This never blocks: on a running driver the event is written synchronously to the underlying fdf_fidl::DriverChannel via fidl_next::SendFuture::send_immediately; alerts reported after the driver has been asked to stop are dropped.

Alerts are not mirrored into Inspect automatically; a driver that records its health there can pass SelfFault alerts to HealthCheckInspect::record_alert as well.

Trait Implementations

impl Clone for HealthAlertReporter

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for HealthAlertReporter

fn default() -> Self

Returns a disconnected reporter: every alert reported through it is dropped (logged at debug). Intended only for tests or placeholders; use crate::DriverContext::health_alert_reporter in a running driver or HealthAlertReporter::new_for_testing to observe alerts in a test.