Struct EmergencyDiagnosticHandle 

pub struct EmergencyDiagnosticHandle { /* private fields */ }

Implementations

impl EmergencyDiagnosticHandle

pub fn snapshot(&self) -> DiagnosticOutputSnapshot

pub fn submit(&self, diagnostic: &Diagnostic) -> DiagnosticSubmission

Enqueued means accepted in memory, NOT written or durable.

Examples found in repository

examples/diagnostic_source.rs (line 35)

fn main() {
    // The application must pass its already resolved logging.directory here.
    let mut output =
        EmergencyDiagnostics::start(&FileLoggingConfig::default()).expect("emergency worker");
    let error = source_failure(&std::io::Error::from_raw_os_error(2));
    if let Some(diagnostic) = error.diagnostic() {
        let _admission_only = output.handle().submit(diagnostic);
    }
    // Illustrative bounded host wait; Runtime must use its EXISTING deadline.
    let deadline = std::time::Instant::now() + std::time::Duration::from_secs(1);
    while output.shutdown() == DiagnosticShutdown::Pending && std::time::Instant::now() < deadline {
        std::thread::sleep(std::time::Duration::from_millis(1));
    }
    // Inspect written/first_failure + target; Enqueued alone never proves delivery.
    let _status = output.snapshot();
}

pub fn submit_context( &self, diagnostic: &Diagnostic, context: Option<(&CallContext, &EventContext)>, ) -> DiagnosticSubmission

Trait Implementations

impl Clone for EmergencyDiagnosticHandle

fn clone(&self) -> EmergencyDiagnosticHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.