Skip to main content
Patter ships opt-in OpenTelemetry tracing that covers the hot spots on the voice pipeline: STT, endpointing, LLM, TTS, barge-in, and tool calls. Every span carries the current getpatter.call.id so you can group by call in your backend. Span names are identical across Python and TypeScript — one dashboard query covers both runtimes.

​
Enable tracing

Tracing is disabled by default. Set the env flag and call initTracing once at process start: 
export PATTER_OTEL_ENABLED=1
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318   # any OTLP/HTTP collector

import { initTracing } from "getpatter";

initTracing({
  serviceName: "my-voice-bot",
  otlpEndpoint: "http://localhost:4318",
  resourceAttributes: { "deployment.environment": "staging" },
});
If PATTER_OTEL_ENABLED is not set, initTracing is a no-op and every span becomes a no-op — zero cost when disabled.

​
Emitted spans

Span nameFiresAttributes
getpatter.callOne per call (root span)getpatter.call.id, getpatter.call.direction, getpatter.call.provider_mode
getpatter.sttOne per final transcriptgetpatter.stt.text_len, getpatter.stt.confidence
getpatter.endpointOne per detected end-of-utterancegetpatter.endpoint.silence_ms
getpatter.llmOne per LLM iteration (incl. tool rounds) — wraps the pipeline LLM call so TTFT is measured per turngetpatter.llm.iteration, getpatter.llm.history_size, getpatter.llm.ttft_ms
getpatter.ttsOne per synthesized sentencegetpatter.tts.text_len
getpatter.bargeinOne per barge-in eventgetpatter.bargein.cancelled_text_len
getpatter.toolOne per tool invocationgetpatter.tool.name, getpatter.tool.transport

​
PII hygiene

Patter never exports user utterances, tool payloads, or LLM content as span attributes. Only sizes, counts, and identifiers are emitted — traces are safe to ship to a shared Jaeger / Honeycomb / Grafana Cloud instance.

​
Shutdown

Call shutdownTracing() during graceful shutdown to flush any pending spans: 
import { shutdownTracing } from "getpatter";

await shutdownTracing();

​
Troubleshooting

No spans appear → confirm PATTER_OTEL_ENABLED=1 is set in the process that calls initTracing. Quick check: 
import { isTracingEnabled } from "getpatter";
console.log(isTracingEnabled());
Collector refuses spans → the endpoint defaults to OTLP/HTTP on port 4318. If you’re running the gRPC-only OTel Collector image, switch to otel/opentelemetry-collector-contrib or enable the HTTP receiver in your collector config.