> This page is for NeMo Relay, version dev. > For other versions, use one of these documentation indexes: > - Latest (v0.11.1) (default): https://docs.nvidia.com/nemo/relay/latest/llms.txt > - dev: https://docs.nvidia.com/nemo/relay/dev/llms.txt > - v0.11.1: https://docs.nvidia.com/nemo/relay/v0.11.1/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 event > Canonical lifecycle events and normalized LLM accessors. Generated from `cargo doc --no-deps -p nemo-relay-builtins -p nemo-relay-diagnostics -p nemo-relay-logging -p nemo-relay-plugin-host -p nemo-relay-codecs -p nemo-relay -p nemo-relay-runtime -p nemo-relay-model-pricing -p nemo-relay-resource-metrics -p nemo-relay-observability -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`. Canonical lifecycle events and normalized LLM accessors. ## Structs * [BaseEvent](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-baseevent): Shared event metadata carried by every ATOF event. * [CategoryProfile](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-categoryprofile): Category-specific profile data. * [DataSchema](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-dataschema): Identifier for the schema that describes an event's opaque `data` payload. * [EventCategory](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-eventcategory): Semantic category carried by ATOF `category`. * [EventSanitizeFields](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-eventsanitizefields): Observability fields that event sanitizers may rewrite. * [FiniteF64](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-finitef64): A finite IEEE 754 double-precision value. * [HistogramBoundaries](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-histogramboundaries): Explicit histogram bucket boundaries that are finite and strictly increasing. * [InstrumentDescriptor](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-instrumentdescriptor): Descriptor fields shared by all recordings of an instrument. * [InstrumentName](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-instrumentname): An OpenTelemetry instrument name together with its canonical form. * [MarkEvent](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-markevent): ATOF point-in-time mark event. * [MetricAttributes](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-metricattributes): A deterministic map of typed OpenTelemetry metric attributes. * [MetricEnvelope](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-metricenvelope): Payload stored in a mark using [`METRIC_DATA_SCHEMA_NAME`](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/constant-metric-data-schema-name). * [MetricMeasurement](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-metricmeasurement): One recording operation in a Relay metric mark. * [MetricValidationError](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-metricvalidationerror): Validation error for a Relay metric envelope. * [ParseLogSeverityError](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-parselogseverityerror): Error returned when parsing an unsupported log severity. * [PendingMarkSpec](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-pendingmarkspec): Mark requested by middleware for materialization by a lifecycle owner. * [ScopeEvent](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-scopeevent): ATOF scope lifecycle event. * [ValidatedMetricMeasurement](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/struct-validatedmetricmeasurement): Parsed metric measurement that is safe for OTLP export. ## Enums * [AttributeValue](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-attributevalue): Typed OpenTelemetry attribute values, including homogeneous primitive arrays. * [Event](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-event): Tagged union covering the two ATOF event kinds emitted by the runtime. * [LogSeverity](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-logseverity): Severity attached to a mark that may be projected as an OpenTelemetry log. * [MetricKind](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-metrickind): OpenTelemetry instrument kind represented by a metric measurement mark. * [MetricValue](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-metricvalue): One typed metric value accepted by Relay's metric schema. * [MetricValueType](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-metricvaluetype): Numeric representation used by a metric measurement. * [ScopeCategory](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/enum-scopecategory): Agent Trajectory Observability Format (ATOF) lifecycle phase for a scope event. ## Constants * [ATOF_VERSION](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/constant-atof-version): Agent Trajectory Observability Format (ATOF) protocol version emitted by this runtime. * [LOG_SEVERITY_METADATA_KEY](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/constant-log-severity-metadata-key): Reserved metadata key carrying the canonical severity of a mark exported as a log. * [METRIC_DATA_SCHEMA_NAME](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/constant-metric-data-schema-name): Relay-owned schema name for mark payloads containing metric measurements. * [METRIC_DATA_SCHEMA_VERSION](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/constant-metric-data-schema-version): Current Relay-owned metric measurement schema version. ## Traits * [EventNormalizationExt](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/trait-eventnormalizationext): Core-only normalized LLM accessors for ATOF events. ## Functions * [attributes_from_handle](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/fn-attributes-from-handle): Convert handle bitflags into ATOF attributes. * [llm_attributes_to_strings](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/fn-llm-attributes-to-strings): Convert LLM bitflags into ATOF attributes. * [scope_attributes_to_strings](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/fn-scope-attributes-to-strings): Convert scope bitflags into ATOF attributes. * [tool_attributes_to_strings](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/fn-tool-attributes-to-strings): Convert tool bitflags into ATOF attributes. * [validate_metric_measurements](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/event/fn-validate-metric-measurements): Validate a complete list of metric measurements atomically.