> This page is for NeMo Relay, version dev. > For other versions, use one of these documentation indexes: > - Latest (v0.10.4) (default): https://docs.nvidia.com/nemo/relay/latest/llms.txt > - dev: https://docs.nvidia.com/nemo/relay/dev/llms.txt > - v0.10.4: https://docs.nvidia.com/nemo/relay/v0.10.4/llms.txt > - v0.9.4: https://docs.nvidia.com/nemo/relay/v0.9.4/llms.txt > - v0.8.4: https://docs.nvidia.com/nemo/relay/v0.8.4/llms.txt > - v0.7.3: https://docs.nvidia.com/nemo/relay/v0.7.3/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server. # Module diagnostics > Versioned, transport-neutral runtime diagnostic contracts. Portable diagnostic evidence shared by Relay runtimes, tools, and adapters. Generated from `cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-pii-redaction -p nemo-relay-ffi -p nemo-relay-types -p nemo-relay-plugin -p nemo-relay-worker-proto -p nemo-relay-worker`. Versioned, transport-neutral runtime diagnostic contracts. Portable diagnostic evidence shared by Relay runtimes, tools, and adapters. These types describe observations rather than readiness or deployment health. They contain no runtime state. Producers enforce resource limits before recording; consumers inspect coverage before interpreting absent evidence. Potentially growing integers use DiagnosticNumber, encoded as canonical unsigned decimal JSON strings to preserve every u64 value in JavaScript. Numbers, signs, leading zeroes, fractions, whitespace, and values outside u64 are rejected. Unknown object fields support additive evolution. Unknown catalogue names remain opaque in supported envelopes; unsupported schema versions require adapter negotiation. ## Structs * [Classification](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-classification): Shared classification payload for producers, projections, and decoded evidence. * [ClassificationError](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-classificationerror): A cause is missing, forbidden, or unsupported by the selected catalogue code. * [ComponentIdentity](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentidentity): Identity of one registered component within a diagnostic source. * [ComponentOwnership](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentownership): Bounded attribution for a component refresh or an originating observation. * [ComponentSnapshot](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentsnapshot): One retained row per component registration instance. * [DiagnosticCapability](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcapability): Capability coverage, including explicitly deferred producer integrations. * [DiagnosticCorrelation](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcorrelation): Optional caller correlation identifiers, excluded from aggregation keys. * [DiagnosticCount](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcount): Magnitude of an occurrence or loss counter, including overflow visibility. * [DiagnosticCounter](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcounter): Lifetime occurrences for one code in its containing component instance. * [DiagnosticCoverage](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcoverage): Explicit evidence, retention, saturation, and producer integration coverage. * [DiagnosticCursor](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcursor): Opaque continuation bound to source, capture revision, offsets, and scope. * [DiagnosticDetail](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticdetail): Restricted optional recent evidence, independent of the accepted numeric summary. * [DiagnosticDiscovery](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticdiscovery): Side-effect-free discovery, available even when snapshot queries are disabled. * [DiagnosticEvent](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticevent): One recent observation with its actual class and original configuration attribution. * [DiagnosticLifetimeSummary](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticlifetimesummary): Fixed lifetime totals and monotonic timing for a context or component instance. * [DiagnosticLoss](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticloss): Source loss state reserved independently of optional evidence capacity. * [DiagnosticNumber](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticnumber): Unsigned diagnostic integer serialized losslessly as a decimal string. * [DiagnosticOrigin](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticorigin): Original bounded configuration attribution carried by one observation. * [DiagnosticOutputSummary](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticoutputsummary): Allowlisted operational output, constructed independently of retained detail. * [DiagnosticQuery](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticquery): Portable bounded selection; consumers never reset or mutate evidence. * [DiagnosticRefreshSummary](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticrefreshsummary): One current resettable counting period, with no retained historical summary. * [DiagnosticRetention](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticretention): Boundaries of returned retained evidence, separate from cumulative counters. * [DiagnosticSnapshot](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticsnapshot): Read evidence from one source incarnation, using the canonical snapshot schema. * [DiagnosticTotals](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnostictotals): Fixed numeric accounting for one explicitly identified lifetime or refresh scope. * [DiagnosticWindow](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindow): Fixed-resolution outcome series for the containing component instance. * [DiagnosticWindowBucket](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindowbucket): An aggregate bucket using component-relative elapsed time, never raw process ticks. * [DiagnosticWindowCoverage](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindowcoverage): Actual observation interval and limitations of a fixed-bucket window. * [PluginExecutionName](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-pluginexecutionname): A plugin execution mechanism name, preserving values unknown to this reader. Typed conversion accepts only the corresponding catalogue enum. * [PluginObservationContext](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-pluginobservationcontext): Shared plugin-operation facts for producers, projections, and decoded evidence. * [PluginPhaseName](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-pluginphasename): A plugin lifecycle phase name, preserving values unknown to this reader. Typed conversion accepts only the corresponding catalogue enum. * [RemoteDiagnosticOrigin](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-remotediagnosticorigin): Fixed-size provenance retained by an authorized ingestion adapter. * [SourceIdentity](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-sourceidentity): Identity of one Relay process or explicitly owned runtime incarnation. ## Enums * [BuiltinDiagnosticCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-builtindiagnosticcode): Fixed-size canonical authoring value with one authoritative hierarchy. * [CliFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-clifailurecode): Failures at integrated CLI operation boundaries; causes come from producers. * [CommonPluginFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-commonpluginfailurecode): Plugin failures supported by phase-one activation recording. * [DaemonFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-daemonfailurecode): Failures observed by daemon operation owners, independent of health policy. * [DiagnosticAvailability](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticavailability): Availability of evidence, without applying deployment or application health. * [DiagnosticDomain](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticdomain): Top-level owning subsystem, derived from its catalogue code. * [DiagnosticOutcome](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticoutcome): Observed operation outcome; severity does not imply this value. * [DiagnosticSeverity](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticseverity): Severity of evidence, independent of an operation's outcome. * [DiagnosticSummaryScope](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticsummaryscope): Scope of summary and outcome-window values in a filtered response. * [FailureClass](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-failureclass): Supported general cause, independent of health, retries, and operation outcome. * [FailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-failurecode): Failure event hierarchy for integrated producers. * [LoggingFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-loggingfailurecode): Initial Logging failure vocabulary. * [NoticeCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-noticecode): Bounded non-failure observations; they never acquire a failure class. * [PluginDiagnosticFamily](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-plugindiagnosticfamily): Semantic family of related plugin diagnostic codes. * [PluginExecution](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginexecution): Producer-authored plugin execution mechanism, excluded from counter identity. * [PluginFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginfailurecode): Plugin failure hierarchy for integrated producers. * [PluginOperationFailureCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginoperationfailurecode): Failures at observed dynamic-plugin operation boundaries. * [PluginPhase](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginphase): Observed plugin lifecycle phase or policy-gate context, independent of classification. * [SuccessCode](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-successcode): Explicit successful operations; successes do not recover or clear failures. ## Constants * [DIAGNOSTIC_CATALOGUE_VERSION](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-catalogue-version): Stable typed-catalogue revision, independent of the envelope version. * [DIAGNOSTIC_SCHEMA_VERSION](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-schema-version): Initial version of the canonical diagnostic snapshot envelope. ## Traits * [DiagnosticClassifier](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/trait-diagnosticclassifier): Pure producer behavior: borrow original evidence and return shared classification metadata. ## Type Aliases * [ObservationTime](/reference/api/rust-library-reference/nemo-relay-types/diagnostics/type-observationtime): UTC wall-clock time when the source observed evidence or captured a snapshot.