OpenTelemetry-spår
Exportera OpenTelemetry-spår till din observability-stack som OTLP JSON.
ElevenLabs Agents kan exportera konversationer som OpenTelemetry-spår kodade som OTLP JSON (resourceSpans). Vidarebefordra dem till Datadog, Grafana Tempo, Honeycomb eller valfri backend som importerar OTLP.
ElevenLabs skickar inte spår direkt till din OTLP-insamlare. Du får OTLP-formad JSON från en webhook, API eller övervaknings-WebSocket och vidarebefordrar den till din backend.
Översikt
Exportera spår från tre källor. Alla tre delar samma spår-ID per konversation och attributnamngivningen elevenlabs.*. Spannens utformning och tidssättning skiljer sig mellan efter samtal/GET (transkriptbaserat) och övervakning (händelsebaserat).
Exportkällor
Välja en källa
- Varje slutfört samtal i ditt datalager: webhook efter samtal
- Enstaka export eller reparation: GET conversation med
format=opentelemetry - Livegränssnitt för handledare eller aviseringar: övervaknings-WebSocket
- Tidslinje med full detaljnivå i efterhand: webhook efter samtal eller GET conversation
- Verktygs-, MCP- eller guardrail-händelser när de inträffar: övervaknings-WebSocket
Använd traceId eller elevenlabs.conversation_id för att sammanfoga data mellan källor. Kombinera övervakning för liveåtgärder, webhooks för varaktig analys och GET för återfyllning.
Du behöver en OTLP-kompatibel insamlare eller observability-leverantör för varje källa. Webhooks efter samtal kräver en webhook-slutpunkt för arbetsytan. GET API och övervaknings-WebSocket har egna API-nyckelomfattningar och egen konfiguration. Se avsnitten nedan.
Webhook efter samtal
När en konversation avslutas skickar ElevenLabs en POST-begäran när en webhook efter samtal har konfigurerats, events innehåller transcript och transcript_format är opentelemetry.
Webhookens type är post_call_transcription_otel (inte post_call_transcription, som returnerar JSON-transkript).
Webhook-payload
Aktivera OpenTelemetry-transkript
Konfigurera via instrumentpanelen
Konfigurera via CLI
Konfigurera via API
Skapa en webhook för arbetsytan
I ElevenAgents Dashboard skapar du en webhook för arbetsytan med din HTTPS-URL och autentisering.
Koppla webhooken efter samtal
Öppna Agents settings, tilldela webhooken som webhook efter samtal, aktivera händelsen Transcript och slå på OpenTelemetry transcript payloads.

OpenTelemetry-transkriptwebhooks innehåller inte ljud. Använd post_call_audio om du behöver
inspelningar.
Returnera 2xx vid lyckat resultat. 4xx och 5xx räknas som fel.
Återförsök gäller endast transkriptwebhooks (inklusive OpenTelemetry) och ljudwebhooks när Enable retries är aktiverat för webhooken för arbetsytan. Tillfälliga fel (** 5xx **, **429 **, **408 **) försöks igen upp till 5 gånger; 4xx gör det inte. Upprepade fel kan automatiskt inaktivera webhooken. Se Post-call webhooks för detaljer och HIPAA- undantag.
Leverans
Spårstruktur
Varje leverans är ett komplett spår: ett rotspann plus underordnade spann.
Spann för agentsvar innehåller elevenlabs.reasoning_content när leveransen innehåller en sammanfattning av resonemang.
Tidssättningen kommer från transkriptets time_in_call_secs och samtalsmetadata:
- Rotspannet omfattar hela samtalet, från
start_time_unix_secsundercall_duration_secs. - Varje transkriptspann börjar vid dess
time_in_call_secsoch slutar när nästa transkriptpost börjar. Det sista slutar med samtalet. - Ett verktygsspann börjar med sitt transkriptspann och varar under verktygets latens, när latensen är känd.
Rotspannet anger elevenlabs.source = post_call_webhook. Dess status är ERROR när konversationsstatusen är failed eller samtalsmetadata registrerar ett fel, och status.message innehåller felorsaken när en sådan finns. Se Attributreferens för alla attribut.
GET conversation
Begär OpenTelemetry-format i Get conversation för att få samma otlp_traces-objekt som i OpenTelemetry-webhooken efter samtal, plus hela konversationsmodellen.
Kräver en API-nyckel med CONVAI_READ. Med format=json (standard) utelämnas otlp_traces.
Förväntade spannnamn är bland annat elevenlabs.conversation, elevenlabs.recv.user_transcript och elevenlabs.recv.agent_response.
Övervaknings-WebSocket
Realtidsövervakning kräver en Enterprise-arbetsyta eller funktionsflaggan realtime-monitoring.
Se Realtidsövervakning för konfiguration,
kontrollkommandon och åtkomstkrav.
Strömma OpenTelemetry-spårdata som OTLP JSON medan en konversation pågår. Varje meddelande är en liten resourceSpans-batch, inte ett enda spår vid samtalets slut.
Autentisering kräver CONVAI_WRITE, xi-api-key (eller Authorization) och EDITOR-åtkomst till agentens arbetsyta. Anslut när konversationen har startat.
Aktivera övervakning för agenten
Ange monitoring_enabled: true och konfigurera monitoring_events före samtalet. Se Realtidsövervakning.
Sessionsprotokoll
- Anslut med autentiseringsrubriker.
- Ta emot
{"type": "connected"}. - Ta emot en rotspannbatch (
elevenlabs.conversation,elevenlabs.source=monitoring). - Ta emot cachelagd historik (omkring de senaste 100 händelserna), sedan
{"type": "history_complete"}. - Ta emot live-spannbatcher när händelser inträffar.
Med events_format=json (standard) returnerar WebSocket råa klienthändelser i stället för resourceSpans. Kontrollkommandon följer Realtidsövervakning.
Spårstruktur
Strukturerade händelser mappas till särskilda attribut (till exempel elevenlabs.user.text, elevenlabs.agent.text). Okända händelser använder elevenlabs.event.data med trunkerad JSON. Se Övervakningsspann för attributen för varje händelse.
Anta inte att händelseordningen motsvarar talordningen. Korrelera live-spann med data efter samtal med
samma traceId.
Beteende för övervakningsspann
- Ett spann per meddelande. Varje
resourceSpans-meddelande innehåller exakt ett spann. - Turer. Den första händelsen öppnar
elevenlabs.turn.0. Enuser_transcriptöppnar en ny tur endast när den aktuella turen redan har en, så tur 0 innehåller agentens hälsning, användarens första meddelande och svaret på det. Från tur 1 börjar varje tur med enuser_transcript. - Tidsstämplar.
startTimeUnixNanoär tiden då servern skickade händelsen, inte tiden då den sades. Uppspelad historik har uppspelningstiden. - Varaktighet. Rot-, tur- och händelsespann börjar och slutar samtidigt och uppdateras inte när samtalet avslutas. Endast
elevenlabs.tool.{name}-spann har en varaktighet, frånagent_tool_requesttillagent_tool_response. - Återanslutningar. Varje anslutning skapar ett nytt rotspann-ID, startar om turnumreringen vid 0 och spelar upp cachelagd historik med nya spann-ID:n. Ta bort dubbletter efter innehåll, inte spann-ID.
- Valda händelser. Strömmen innehåller endast händelserna i agentens
monitoring_events. Standard äruser_transcript,agent_responseochagent_response_correction. Ett verktygsspann skickas näragent_tool_responseanländer; välj ävenagent_tool_requestför att få dess starttid.
Exempel på anslutning
OTLP JSON-struktur
OpenTelemetry-spår från alla källor delar samma batchlayout för OTLP JSON:
Attributreferens
Alla attribut använder prefixet elevenlabs.*, förutom service.name.
Värdekodning
- Värden använder OTLP JSON-omslutenheterna
stringValue,intValue,doubleValueochboolValue.intValueär ett tal som kodas som en sträng, till exempel"3". - Ett attribut med ett null- eller tomt värde utelämnas.
- Attribut som är märkta JSON innehåller en JSON-kodad sträng. JSON-värden och
elevenlabs.reasoning_contenttrunkeras vid 4 096 tecken, så ett trunkerat värde kanske inte kan parsas. - Varje meddelande innehåller resursattributen
service.name(elevenlabs-convai),elevenlabs.conversation_idochelevenlabs.agent_id.
Spår efter samtal och GET
Rotspann (elevenlabs.conversation)
Transkriptspann (elevenlabs.recv.user_transcript, elevenlabs.recv.agent_response)
Verktygsspann (elevenlabs.tool.{name})
Övervakningsspann
Varje händelsespann innehåller också elevenlabs.event.type, inställt på händelsetypen (agent_tool för verktygsspann). Om du vill få verktygsresultat i övervakningsströmmen väljer du agent_tool_response_full_payload och läser dess elevenlabs.event.data.
Latensmått
Agenttranskriptspann i spår efter samtal och GET innehåller latensmått per tur som elevenlabs.metric.{name}_ms. Värdena är millisekunder, avrundade till 0,1 ms. Ett mått utelämnas från en tur när det inte har mätts. Övervakningsströmmen innehåller inga latensmått.
Samma mått visas i JSON-transkriptet som conversation_turn_metrics.metrics.{name}.elapsed_time, i sekunder.
Begränsningar
- Ingen direktöverföring till din OTLP gRPC-slutpunkt.
- Nyttolaster är JSON formad som OTLP-export, inte rå protobuf över nätverket.