nemo-relay-export-otel

name	nemo-relay-export-otel
description	Configure and use NeMo Relay OpenTelemetry export for OTLP-compatible tracing backends
author	NVIDIA Corporation and Affiliates
license	Apache-2.0

Export OpenTelemetry Traces

Use this skill when the destination is an OTLP/OpenTelemetry backend such as an OpenTelemetry Collector, Jaeger, Tempo, or Honeycomb.

Default Path

• Build the binding-specific OpenTelemetryConfig
• Set endpoint, service name, and any required headers
• Construct the subscriber
• Register it before running scoped work
• Deregister, flush, and shut down when the process or subsystem is done

Embedded OpenTelemetry Semantics

• OpenTelemetry export maps NeMo Relay runtime events into OTLP traces for tracing backends and collectors.
• Configure transport, endpoint, service_name, optional namespace and version, instrumentation scope, headers, resource attributes, and timeout.
• Start with http_binary transport and an OTLP traces endpoint such as a local collector on port 4318 unless deployment requirements differ.
• grpc transport is available when a Tokio runtime is active.
• Use explicit config objects in application code; environment variables may be honored by the underlying exporter but should not be the only source of application behavior.
• Register before the first instrumented request, use stable service identity, keep auth and endpoints out of source code, flush during graceful shutdown, and redact sensitive payloads before production export.
• Validate export by checking subscriber construction, collector requests, backend spans for scopes/tools/LLMs, and span grouping by root scope.

Things To Confirm

• Transport: http_binary vs grpc
• Endpoint and auth headers
• Service naming and resource attributes
• Whether deterministic flush-before-exit is required
• Whether the chosen binding and target support the desired transport

Troubleshooting Focus

• No spans visible
• Wrong endpoint or auth headers
• Events emitted outside active scopes
• grpc selected without a Tokio runtime
• Forgetting register/deregister or flush/shutdown steps

Related Skills

• nemo-relay-setup-observability
• nemo-relay-export-openinference
• nemo-relay-debug-runtime-integration