NVIDIA NeMo Agent Toolkit OpenTelemetry

1.6.0 verified Mon Apr 27 auth: no python

Subpackage for OpenTelemetry integration in NeMo Agent Toolkit, providing telemetry and observability for AI agents. Current version 1.6.0, requires Python >=3.11,<3.14.

pip install nvidia-nat-opentelemetry

Common errors

error ModuleNotFoundError: No module named 'nvidia_nat_opentelemetry' ↓

cause Using incorrect flat import path instead of the correct package path.

fix

Use 'from nvidia.nat.opentelemetry import ...' instead.

error ImportError: cannot import name 'TracerProvider' from 'opentelemetry.sdk.trace' ↓

cause Trying to import the stock OpenTelemetry TracerProvider when the NVIDIA wrapper is needed.

fix

Import TracerProvider from 'nvidia.nat.opentelemetry'.

Warnings

breaking Version 1.6.0 requires Python >=3.11,<3.14. Python 3.10 and below are not supported. ↓

fix Upgrade Python to 3.11-3.13.

deprecated Direct import from 'nvidia_nat_opentelemetry' is deprecated. Use 'nvidia.nat.opentelemetry' instead. ↓

fix Change import to 'from nvidia.nat.opentelemetry import ...'.

gotcha Do not mix stock OpenTelemetry SDK classes with NVIDIA wrappers; they may not propagate context correctly. ↓

fix Always use NVIDIA-provided classes like TracerProvider and create_trace_provider.

Imports

create_trace_provider
wrong
```
from nvidia_nat_opentelemetry import create_trace_provider
```
correct
```
from nvidia.nat.opentelemetry import create_trace_provider
```
Correct import uses dot notation under nvidia.nat package. The flat import name does not work.
TracerProvider
wrong
```
from opentelemetry.sdk.trace import TracerProvider
```
correct
```
from nvidia.nat.opentelemetry import TracerProvider
```
Use NVIDIA's wrapper TracerProvider for proper auto-instrumentation and lineage tracking.

Quickstart

Initialize OpenTelemetry tracing with NVIDIA's trace provider.

from nvidia.nat.opentelemetry import create_trace_provider

tp = create_trace_provider(
    service_name="my-agent",
    endpoint=os.environ.get('OTEL_EXPORTER_OTLP_ENDPOINT', 'http://localhost:4317')
)
# Use tp with OpenTelemetry tracing