ai-python-telemetry

• ai.experimental_telemetry is experimental: it may change or be removed.

Enable telemetry

• Nothing is reported until an adapter is registered or a sink is routed; with telemetry off, spans are no-ops (id="", no clock reads, push() does nothing). Check with is_enabled().
• OpenTelemetry export: perform the standard OpenTelemetry ceremony (tracer provider + OTLP exporter), then ai.experimental_telemetry.register(otel.OtelAdapter()). Requires the ai[otel] extra.
• Message content capture is opt-in: otel.OtelAdapter(capture_content=True) or OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true.
• Call OtelAdapter.flush() before a checkpoint and OtelAdapter.shutdown() at process exit; the exporter buffers.