Registry / observability / nvidia-nat-opentelemetry

nvidia-nat-opentelemetry

library1.8.0pypypiunverified

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.

observability ai-ml llm-agents

pip install nvidia-nat-opentelemetry

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · NVIDIA-NAT-OPENTEL

nvidia-nat-opentelemetry

observabilitypythonv1.8.0

Install

21.3s avg

Import

—

Disk

316MB

Pass rate

6/ 10

Env Coverage6 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.8.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✓ —

✓ 23.1s

py 3.12

✓ —

✓ 21.1s

py 3.13

✓ —

✓ 19.8s

py 3.9

✕ build_error

316MB installed

● package 316MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

create_trace_provider

✓ from nat import create_trace_provider

✗ from nvidia.nat.opentelemetry import create_trace_provider

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

Debug

Known issues

breakingVersion 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.

affects: 1.6.0

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

fix

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

affects: >=1.0.0

gotchaDo 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.

affects: all

Upgrade

Version history

1.8.0latest on PyPI · released Jun 17, 2026

Audit

Dependencies

nvidia-nat-utilsrequiredCore NeMo Agent Toolkit utilities

opentelemetry-apirequiredOpenTelemetry API dependency

opentelemetry-sdkrequiredOpenTelemetry SDK dependency

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/NVIDIA/NeMo-Agent-Toolkit ↗

packagehttps://pypi.org/project/nvidia-nat-opentelemetry/ ↗

docshttps://docs.nvidia.com/nemo/agent-toolkit/latest/ ↗