{"id":24126,"library":"nucliadb-telemetry","title":"NucliaDB Telemetry","description":"Telemetry library for NucliaDB processes. Provides OpenTelemetry-based tracing, metrics, and logging with Sentry integration. Current version 6.13.0.post6185, frequent releases.","status":"active","version":"6.13.0.post6185","language":"python","source_language":"en","source_url":"https://github.com/nuclia/nucliadb","tags":["telemetry","opentelemetry","sentry","logging","nucliadb"],"install":[{"cmd":"pip install nucliadb-telemetry","lang":"bash","label":"stable"}],"dependencies":[{"reason":"Core dependency for OpenTelemetry tracing and metrics","package":"opentelemetry-api","optional":false},{"reason":"For error reporting and performance monitoring","package":"sentry-sdk","optional":true}],"imports":[{"wrong":"from nucliadb_telemetry import Telemetry","symbol":"logger","correct":"from nucliadb_telemetry import logger"},{"wrong":"from nucliadb_telemetry import Telemetry","symbol":"logging","correct":"from nucliadb_telemetry import logging"}],"quickstart":{"code":"import os\nfrom nucliadb_telemetry import Telemetry\n\n# Use environment variables for configuration\nservice_name = os.environ.get('SERVICE_NAME', 'my-service')\nsettings = {\n    'sentry_dsn': os.environ.get('SENTRY_DSN', ''),\n    'service_name': service_name,\n}\ntelemetry = Telemetry(settings)\ntelemetry.setup()  # initializes tracing, metrics, logging","lang":"python","description":"Initialize telemetry with Sentry and OpenTelemetry. Settings dict configures endpoints and service name."},"warnings":[{"fix":"Review settings dict: use 'logging': {'level': 'DEBUG'} instead of top-level 'log_level'.","message":"Settings dict structure changed in v6.10.0: 'sentry_dsn' renamed from 'sentry_dsn' (remains same) but 'log_level' moved to a nested dict under 'logging'. Check changelog.","severity":"breaking","affected_versions":">=6.10.0"},{"fix":"Consider setting SENTRY_DSN='' for local development, or run setup in background thread.","message":"Telemetry.setup() may block if Sentry DSN is set but unreachable. Network timeouts can delay startup.","severity":"gotcha","affected_versions":"all"},{"fix":"Set env var OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 or configure in settings.","message":"OpenTelemetry spans may not appear if no exporter is configured. The library defaults to a console exporter for debugging; production requires setting OTEL_EXPORTER_OTLP_ENDPOINT.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'6.13.0':21 'base':11 'current':19 'frequent':23 'integr':18 'librari':4 'log':15,28 'metric':13 'nucliadb':1,6,29 'opentelemetri':10,26 'opentelemetry-bas':9 'post6185':22 'process':7 'provid':8 'releas':24 'sentri':17,27 'telemetri':2,3,25 'trace':12 'version':20","created_at":"2026-05-01T08:11:25.387099+00:00","updated_at":"2026-05-01T08:11:25.387099+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"6.15.0.post6578","cli_name":"","cli_version":null,"type":"library","homepage":"https://nuclia.com","github":"https://github.com/nuclia/nucliadb","docs":null,"changelog":null,"pypi":"https://pypi.org/project/nucliadb-telemetry/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["observability"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}