Registry / observability / nucliadb-telemetry

nucliadb-telemetry

JSON →
library6.15.0.post6578pypypi✓ verified 79d ago

Telemetry library for NucliaDB processes. Provides OpenTelemetry-based tracing, metrics, and logging with Sentry integration. Current version 6.13.0.post6185, frequent releases.

pip install nucliadb-telemetry
INSTALL
IMPORT
SIG · NUCLIADB-TELEMETRY
N
nucliadb-telemetry
observabilitypythonv6.15.0.post6578
Install
4.6s avg
Import
Disk
29MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v6.15.0.post6578 · 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
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 30.6MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 4.6s · import 0.000s · 30MB
29MB installed
● package 29MB
Code
Verified usage

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

logger
from nucliadb_telemetry import logger
from nucliadb_telemetry import Telemetry
logging
from nucliadb_telemetry import logging
from nucliadb_telemetry import Telemetry

Initialize telemetry with Sentry and OpenTelemetry. Settings dict configures endpoints and service name.

import os from nucliadb_telemetry import Telemetry # Use environment variables for configuration service_name = os.environ.get('SERVICE_NAME', 'my-service') settings = { 'sentry_dsn': os.environ.get('SENTRY_DSN', ''), 'service_name': service_name, } telemetry = Telemetry(settings) telemetry.setup() # initializes tracing, metrics, logging
Debug
Known issues
breakingSettings 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.
fix
Review settings dict: use 'logging': {'level': 'DEBUG'} instead of top-level 'log_level'.
affects: >=6.10.0
gotchaTelemetry.setup() may block if Sentry DSN is set but unreachable. Network timeouts can delay startup.
fix
Consider setting SENTRY_DSN='' for local development, or run setup in background thread.
affects: all
gotchaOpenTelemetry 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.
fix
Set env var OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 or configure in settings.
affects: all
Upgrade
Version history
6.15.0.post6578latest on PyPI · released Jun 18, 2026
Audit
Dependencies
opentelemetry-apirequiredCore dependency for OpenTelemetry tracing and metrics
sentry-sdkoptionalFor error reporting and performance monitoring
Agent activity
10 hits · last 30 days
node
8
OpenAI (training)
2
Resources
nucliadb-telemetry — pip install nucliadb-telemetry · libregistry