> This page is for NeMo Relay, version v0.11.0. > 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.11.0: https://docs.nvidia.com/nemo/relay/v0.11.0/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](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-classification): Shared classification payload for producers, projections, and decoded evidence. * [ClassificationError](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-classificationerror): A cause is missing, forbidden, or unsupported by the selected catalogue code. * [ComponentIdentity](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentidentity): Identity of one registered component within a diagnostic source. * [ComponentMemoryFootprint](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentmemoryfootprint): Assigned diagnostic storage for one component incarnation, not its heap or RSS. * [ComponentMemoryUsage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentmemoryusage): One retained registration's diagnostic backing. * [ComponentOwnership](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentownership): Bounded attribution for a component refresh or an originating observation. * [ComponentSnapshot](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-componentsnapshot): One retained row per component registration instance. * [DiagnosticCapability](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcapability): Capability coverage, including explicitly deferred producer integrations. * [DiagnosticCorrelation](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcorrelation): Optional caller correlation identifiers, excluded from aggregation keys. * [DiagnosticCount](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcount): Magnitude of an occurrence or loss counter, including overflow visibility. * [DiagnosticCounter](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcounter): Lifetime occurrences for one code in its containing component instance. * [DiagnosticCoverage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcoverage): Explicit evidence, retention, saturation, and producer integration coverage. * [DiagnosticCursor](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticcursor): Opaque continuation bound to source, capture revision, offsets, and scope. * [DiagnosticDetail](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticdetail): Restricted optional recent evidence, independent of the accepted numeric summary. * [DiagnosticDiscovery](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticdiscovery): Side-effect-free discovery, available even when snapshot queries are disabled. * [DiagnosticEvent](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticevent): One recent observation with its actual class and original configuration attribution. * [DiagnosticLifetimeSummary](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticlifetimesummary): Fixed lifetime totals and monotonic timing for a context or component instance. * [DiagnosticLoss](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticloss): Source loss state reserved independently of optional evidence capacity. * [DiagnosticMemoryPage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticmemorypage): Bounded independent memory view; inspection neither records nor freezes history. * [DiagnosticMemoryUsage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticmemoryusage): Backing capacity and current occupancy of one context. * [DiagnosticNumber](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticnumber): Unsigned diagnostic integer serialized losslessly as a decimal string. * [DiagnosticOrigin](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticorigin): Original bounded configuration attribution carried by one observation. * [DiagnosticOutputSummary](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticoutputsummary): Allowlisted operational output, constructed independently of retained detail. * [DiagnosticProducerSupport](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticproducersupport): One finite integration entry. Support is independent of collection enablement, configured/admitted registrations, observed evidence, and read authority. * [DiagnosticQuery](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticquery): Portable bounded selection; consumers never reset or mutate evidence. * [DiagnosticRefreshSummary](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticrefreshsummary): One current resettable counting period, with no retained historical summary. * [DiagnosticRetention](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticretention): Boundaries of returned retained evidence, separate from cumulative counters. * [DiagnosticSnapshot](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticsnapshot): Read evidence from one source incarnation, using the canonical snapshot schema. * [DiagnosticTotals](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnostictotals): Fixed numeric accounting for one explicitly identified lifetime or refresh scope. * [DiagnosticWindow](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindow): Fixed-resolution outcome series for the containing component instance. * [DiagnosticWindowBucket](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindowbucket): An aggregate bucket using component-relative elapsed time, never raw process ticks. * [DiagnosticWindowCoverage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-diagnosticwindowcoverage): Actual observation interval and limitations of a fixed-bucket window. * [EntryMemoryFootprint](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-entrymemoryfootprint): Occupied backing for one retained observation; these quantities overlap. * [EntryMemoryUsage](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-entrymemoryusage): One retained entry, identified within the enclosing source incarnation. * [MemoryLimitEvent](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-memorylimitevent): One cumulative environment limit event. * [MemorySelectionTotals](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-memoryselectiontotals): Whole-selection totals, distinct from the rows present in this page. * [PluginExecutionName](/nemo/relay/v0.11.0/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](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-pluginobservationcontext): Shared plugin-operation facts for producers, projections, and decoded evidence. * [PluginPhaseName](/nemo/relay/v0.11.0/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. * [RecordReceipt](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-recordreceipt): Accepted lifetime and current-summary update. * [RemoteDiagnosticOrigin](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-remotediagnosticorigin): Fixed-size provenance retained by an authorized ingestion adapter. * [ResourceMemoryMeasurement](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-resourcememorymeasurement): One available measurement; an absent field means not reported (unsupported or unreadable). * [ResourceMemoryMetrics](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-resourcememorymetrics): Memory-only projection; fixed fields and eight limit slots bound all copies. * [ResourceMemorySample](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-resourcememorysample): Collection identity and memory values, copied without an unbounded retained graph. * [ResourceMemoryView](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-resourcememoryview): Independent resource result joined after diagnostic capture releases its lock. * [ResourceProcessIdentity](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-resourceprocessidentity): Verified root incarnation from the same collection, never PID alone. * [SourceIdentity](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/struct-sourceidentity): Identity of one Relay process or explicitly owned runtime incarnation. ## Enums * [BuiltinDiagnosticCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-builtindiagnosticcode): Fixed-size canonical authoring value with one authoritative hierarchy. * [CliFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-clifailurecode): Failures at integrated CLI operation boundaries; causes come from producers. * [CommonPluginFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-commonpluginfailurecode): Plugin failures supported by phase-one activation recording. * [DaemonFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-daemonfailurecode): Failures observed by daemon operation owners, independent of health policy. * [DiagnosticAvailability](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticavailability): Availability of evidence, without applying deployment or application health. * [DiagnosticDomain](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticdomain): Top-level owning subsystem, derived from its catalogue code. * [DiagnosticOutcome](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticoutcome): Observed operation outcome; severity does not imply this value. * [DiagnosticReadReason](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticreadreason): Stable reasons shared by canonical snapshot adapters. These are operation results, never a source health classification or a producer failure code. Include a fallback arm when matching: future releases can add reasons. * [DiagnosticSeverity](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticseverity): Severity of evidence, independent of an operation's outcome. * [DiagnosticSummaryScope](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-diagnosticsummaryscope): Scope of summary and outcome-window values in a filtered response. * [EvidenceDisposition](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-evidencedisposition): Evidence retention is independent of numeric acceptance. * [FailureClass](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-failureclass): Supported general cause, independent of health, retries, and operation outcome. * [FailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-failurecode): Failure event hierarchy for integrated producers. * [LoggingFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-loggingfailurecode): Initial Logging failure vocabulary. * [MemoryFieldScope](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-memoryfieldscope): Field-level scope; snapshot scope does not relabel system/environment data. * [NoticeCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-noticecode): Bounded non-failure observations; they never acquire a failure class. * [PluginDiagnosticFamily](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-plugindiagnosticfamily): Semantic family of related plugin diagnostic codes. * [PluginExecution](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginexecution): Producer-authored plugin execution mechanism, excluded from counter identity. * [PluginFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginfailurecode): Plugin failure hierarchy for integrated producers. * [PluginOperationFailureCode](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginoperationfailurecode): Failures at observed dynamic-plugin operation boundaries. * [PluginPhase](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-pluginphase): Observed plugin lifecycle phase or policy-gate context, independent of classification. * [RecordOutcome](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-recordoutcome): Accepted collection or intentional disablement. * [ResourceAssociation](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-resourceassociation): Relationship between the diagnostic process and measured target. * [ResourceMemoryAvailability](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-resourcememoryavailability): Availability of the latest-memory projection, independent of diagnostic reads. * [ResourceMemoryNumber](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-resourcememorynumber): Exact integers and finite converted decimals retain distinct numeric kinds. * [ResourceMemoryUnit](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-resourcememoryunit): Original unit family and canonical unit. Inspection performs no conversion. * [ResourceSampleStream](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/enum-resourcesamplestream): Independent baseline series producing this sample. * [SuccessCode](/nemo/relay/v0.11.0/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](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-catalogue-version): Stable typed-catalogue revision, independent of the envelope version. * [DIAGNOSTIC_DISCOVERY_VERSION](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-discovery-version): Version of the side-effect-free discovery contract. * [DIAGNOSTIC_MEMORY_VERSION](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-memory-version): Initial version of the separate memory inspection envelope. * [DIAGNOSTIC_SCHEMA_VERSION](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/constant-diagnostic-schema-version): Initial version of the canonical diagnostic snapshot envelope. ## Traits * [DiagnosticClassifier](/nemo/relay/v0.11.0/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](/nemo/relay/v0.11.0/reference/api/rust-library-reference/nemo-relay-types/diagnostics/type-observationtime): UTC wall-clock time when the source observed evidence or captured a snapshot.