Interface SetTracerProviderOptions

Whether this provider's exporters may receive conversational content, tool payloads and other user data.

Defaults to true (or LIVEKIT_TELEMETRY_ALLOW_PII, when set), since a GenAI backend can only render the conversation if it receives it. Pass false to strip PII in-process before every exporter but LiveKit Cloud's, leaving them the non-content attributes. Ignored when the project mandates redaction — that setting is not weakened from here.

Builds the span processor that exports to LiveKit Cloud, called when cloud tracing starts.

The built-in OpenTelemetry SDK 2.x cloud processor is used by default. Supply this callback only to override how that processor is constructed:

import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-node';

createCloudSpanProcessor: ({ exporter }) => new BatchSpanProcessor(exporter)
Copy

Build the processor around the supplied exporter so the recording-disabled upload gate remains active. The returned processor must use OpenTelemetry SDK 2.x.

Attributes to add to every span created by the provider.

Adds a span processor to the provider.

OpenTelemetry 2.x providers no longer expose addSpanProcessor. Supply this callback when using a provider backed by a mutable or delegating span processor so LiveKit Cloud tracing can share the same provider as another observability backend.