{"id":21625,"library":"nvidia-nat-opentelemetry","title":"NVIDIA NeMo Agent Toolkit OpenTelemetry","description":"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.","status":"active","version":"1.6.0","language":"python","source_language":"en","source_url":"https://github.com/NVIDIA/NeMo-Agent-Toolkit","tags":["nvidia","nemo","opentelemetry","observability","tracing"],"install":[{"cmd":"pip install nvidia-nat-opentelemetry","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core NeMo Agent Toolkit utilities","package":"nvidia-nat-utils","optional":false},{"reason":"OpenTelemetry API dependency","package":"opentelemetry-api","optional":false},{"reason":"OpenTelemetry SDK dependency","package":"opentelemetry-sdk","optional":false}],"imports":[{"note":"Correct import uses dot notation under nvidia.nat package. The flat import name does not work.","wrong":"from nvidia_nat_opentelemetry import create_trace_provider","symbol":"create_trace_provider","correct":"from nvidia.nat.opentelemetry import create_trace_provider"},{"note":"Use NVIDIA's wrapper TracerProvider for proper auto-instrumentation and lineage tracking.","wrong":"from opentelemetry.sdk.trace import TracerProvider","symbol":"TracerProvider","correct":"from nvidia.nat.opentelemetry import TracerProvider"}],"quickstart":{"code":"from nvidia.nat.opentelemetry import create_trace_provider\n\ntp = create_trace_provider(\n    service_name=\"my-agent\",\n    endpoint=os.environ.get('OTEL_EXPORTER_OTLP_ENDPOINT', 'http://localhost:4317')\n)\n# Use tp with OpenTelemetry tracing","lang":"python","description":"Initialize OpenTelemetry tracing with NVIDIA's trace provider."},"warnings":[{"fix":"Upgrade Python to 3.11-3.13.","message":"Version 1.6.0 requires Python >=3.11,<3.14. Python 3.10 and below are not supported.","severity":"breaking","affected_versions":"1.6.0"},{"fix":"Change import to 'from nvidia.nat.opentelemetry import ...'.","message":"Direct import from 'nvidia_nat_opentelemetry' is deprecated. Use 'nvidia.nat.opentelemetry' instead.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Always use NVIDIA-provided classes like TracerProvider and create_trace_provider.","message":"Do not mix stock OpenTelemetry SDK classes with NVIDIA wrappers; they may not propagate context correctly.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from nvidia.nat.opentelemetry import ...' instead.","cause":"Using incorrect flat import path instead of the correct package path.","error":"ModuleNotFoundError: No module named 'nvidia_nat_opentelemetry'"},{"fix":"Import TracerProvider from 'nvidia.nat.opentelemetry'.","cause":"Trying to import the stock OpenTelemetry TracerProvider when the NVIDIA wrapper is needed.","error":"ImportError: cannot import name 'TracerProvider' from 'opentelemetry.sdk.trace'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}