Azure Communication Services Samtalsautomatiseringsloggar

Azure Communication Services erbjuder loggningsfunktioner som du kan använda för att övervaka och felsöka din Communication Services-lösning. Du konfigurerar dessa funktioner via Azure Portal.

Förutsättningar

Azure Communication Services tillhandahåller övervaknings- och analysfunktioner via Azure Monitor-loggar och Azure Monitor-mått. Varje Azure-resurs kräver en egen diagnostikinställning, som definierar följande villkor:

  • Kategorier av logg- och måttdata som skickas till de mål som inställningen definierar. De tillgängliga kategorierna varierar beroende på resurstyp.

  • En eller flera destinationer för att skicka loggarna. Aktuella mål är Log Analytics-arbetsytan, Azure Event Hubs och Azure Storage.

    En enda diagnostikinställning kan inte definiera mer än en av varje måltyp. Om du vill skicka data till mer än en måltyp (till exempel två Log Analytics-arbetsytor) skapar du flera inställningar. Varje resurs kan ha upp till fem diagnostikinställningar.

Viktigt!

Du måste aktivera en diagnostikinställning i Azure Monitor för att skicka loggdata för dina undersökningar till en Log Analytics-arbetsyta, en händelsehubb eller ett Azure Storage-konto för att ta emot och analysera dina undersökningsdata. Om du inte skickar Samtalsautomatiseringsdata till något av dessa alternativ lagras inte dina undersökningsdata och går förlorade.

Följande instruktioner konfigurerar din Azure Monitor-resurs för att börja skapa loggar och mått för din Communication Services-instans. Detaljerad dokumentation om hur du använder diagnostikinställningar för alla Azure-resurser finns i Aktivera loggning i diagnostikinställningar.

Under namnet på diagnostikinställningen väljer du följande för att aktivera loggarna för Samtalsautomatisering:

  • Operationsloggar för samtalsautomation
  • Anropa Sammanfattningsloggar för Automation-händelser
  • Användningsinformationsloggar för funktioner av Call Automation Media Streaming

Skärmbild av diagnostikinställningar för Samtalsautomatisering.

Resursloggkategorier

Communication Services erbjuder följande typer av loggar som du kan aktivera:

  • Användningsloggar: Ange användningsdata som är associerade med varje faktureringstjänsterbjudande.
  • Driftloggar för samtalsautomatisering: Ange driftinformation om API-begäranden för samtalsautomatisering. Du kan använda dessa loggar för att identifiera felpunkter och göra förfrågningar mot alla begäranden som gjorts under ett samtal (med hjälp av ett korrelations-ID eller serveranrops-ID).
  • Call Automation media sammanfattningsloggar: Ange information om resultatet av medieåtgärder. Dessa loggar kommer till dig asynkront när du gör medieförfrågningar med hjälp av API:er för samtalsautomatisering. Du kan använda dessa loggar för att identifiera felpunkter och möjliga mönster för hur användare interagerar med ditt program.
  • Anropa Automation Media Streaming-funktioner användningsinformation Loggar: Ange användningsinformation om realtidsströmningsfunktioner som medieströmning och transkription. Dessa loggar kommer till dig asynkront när direktuppspelning i realtid har stoppats eller slutförts. Du kan använda dessa loggar för att identifiera anrop med realtidsströmning aktiverat, deltagare som strömmas i omixade strömningsfall, starttider för direktuppspelning, varaktigheter och möjliga direktuppspelningstrender som används i ditt program.

Schema för användningslogg

Fastighet beskrivning
Timestamp Tidsstämpeln (UTC) för när loggen genererades.
OperationName Åtgärden som är associerad med loggposten.
OperationVersion Värdet api-version som är associerat med åtgärden, om åtgärden OperationName utfördes via ett API. Om inget API motsvarar den här åtgärden representerar versionen versionen av åtgärden, om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en resurs. Egenskaperna som visas i blobben för properties en händelse är desamma inom en loggkategori och resurstyp.
CorrelationID ID:t för korrelerade händelser. Du kan använda den för att identifiera korrelerade händelser mellan flera tabeller.
Properties Andra data som gäller för olika kommunikationstjänster.
RecordID Det unika ID:t för en användningspost.
UsageType Användningsläget (till exempel Chatt, PSTN eller NAT).
UnitType Den typ av enhet som användningen baseras på för ett användningsläge (till exempel minuter, megabyte eller meddelanden).
Quantity Antalet enheter som har använts eller förbrukats för den här posten.

Driftloggar för Samtalsautomation

Fastighet beskrivning
TimeGenerated Tidsstämpeln (UTC) för när loggen genererades.
OperationName Åtgärden som är associerad med loggposten.
CorrelationID En identifierare som används för att korrelera händelser för ett anrop. Den här identifieraren kan ändras under samtalets varaktighet beroende på händelser som deltagare som ansluter till eller lämnar samtalet. För en helt stabil anropsidentifierare bör du överväga att använda CallConnectionId.
OperationVersion Den api-version version som är associerad med åtgärden, om åtgärden operationName utfördes via ett API. Om inget API motsvarar den här åtgärden representerar versionen versionen av åtgärden, om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en resurs. Egenskaperna som visas i blobben för properties en händelse är desamma inom en loggkategori och resurstyp.
ResultType Status för åtgärden.
ResultSignature Åtgärdens understatus. Om den här åtgärden motsvarar ett REST API-anrop är det här fältet HTTP-statuskoden för motsvarande REST-anrop.
DurationMs Varaktigheten för åtgärden i millisekunder.
CallerIpAddress Anroparens IP-adress, om åtgärden motsvarar ett API-anrop som kommer från en entitet med en offentligt tillgänglig IP-adress.
Level Allvarlighetsgraden för händelsen.
URI URI:n för begäran.
CallConnectionId Det ID som representerar samtalsanslutningen, om det är tillgängligt. Det här ID:t är olika för varje deltagare och används för att identifiera deras anslutning till anropet.
ServerCallId Ett unikt ID för att identifiera ett anrop.
SDKVersion SDK-versionen som används för begäran.
SDKType Den SDK-typ som används för begäran.
SubOperationName Namnet som används för att identifiera undertypen av medieåtgärden (spela upp eller identifiera).
operationID Det ID som används för att korrelera asynkrona händelser.

Här är ett exempel på en driftlogg för samtalsautomatisering:

{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"OperationName": "Play",
"OperationVersion": "3/6/23",
"URI": "ccts-media-synthetics-prod.communication.azure.com",
"ResultType": "Succeeded",
"ResultSignature": "202",
"DurationMs": "82",
"CallerIpAddress": "40.88.50.228",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"ServerCallId": "aHR0cHM6Ly9hcGkuZmxpZ2h0cHJveHkuc2t5cGUuY29tL2FwaS92Mi9jcC9jb252LXVzZWEyLTAxLmNvbnYuc2t5cGUuY29tL2NvbnYvZzRoWlVoS1ZEVUtma19HenRDZ1JTQT9pPTEyJmU9NjM4MjA1NDc4MDg5MzEzMjIz",
"SdkVersion": "",
"SdkType": "unknown",
"SubOperationName": "File",
"OperationId": "5fab0875-3211-4879-8051-c688d0854c4d",
}

Anropa Sammanfattningsloggar för Automation-media

Fastighet beskrivning
TimeGenerated Tidsstämpeln (UTC) för händelsen.
level Allvarlighetsgraden för händelsen. Det måste vara en av Informational, Warning, Erroreller Critical. 
resourceId ID:t för resursen som genererade händelsen.
durationMs Varaktigheten för åtgärden i millisekunder.
callerIpAddress
correlationId Identifiera korrelerade begäranden som görs med hjälp av Samtalsautomation.
operationName Namnet på den åtgärd som den här händelsen representerar.
operationVersion
resultType Status för händelsen. Typiska värden är Completed, Canceledoch Failed.
resultSignature Åtgärdens understatus. Om den här åtgärden motsvarar ett REST API-anrop är det här fältet HTTP-statuskoden för motsvarande REST-anrop.
operationId Åtgärds-ID:t som används för att korrelera asynkrona händelser.
recognizePromptSubOperationName En undertyp av åtgärden. Potentiella värden är File, TextToSpeechoch SSML.
playInLoop True om loopning begärdes för uppspelningsåtgärden. False om annat.
playToParticipant True om uppspelningsoperationen hade ett mål. False om det var en "play-to-all"-åtgärd.
interrupted True om prompten avbryts. False om annat.
resultCode Åtgärdens resultatkod.
resultSubcode Åtgärdens resultatunderkod.
resultMessage Resultatmeddelandet för åtgärden.

Här är ett exemplar av en sammanfattningslogg för media vid samtalsautomatisering.

{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
"ResultType": "Completed",
"OperationName": "Play",
"OperationId": "7bef24d5-eb95-4ee6-bbab-0b7d45d91288",
"PlayInLoop": "FALSE",
"PlayToParticipant": "TRUE",
"PlayInterrupted": "FALSE",
"RecognizePromptSubOperationName": "",
"ResultCode": "200",
"ResultSubcode": "0",
"ResultMessage": "Action completed successfully."
}

Loggar för användningsinformation om mediestreamingfunktioner för anropsautomation

Fastighet beskrivning
TimeGenerated Tidsstämpeln (UTC) för händelsen.
CorrelationId Identifiera korrelerade begäranden som görs med hjälp av Samtalsautomation.
CallConnectionId Det ID som representerar samtalsanslutningen, om det är tillgängligt. Det här ID:t är olika för varje deltagare och används för att identifiera deras anslutning till anropet.
StreamingModality Typen av realtidsströmning (t.ex. AudioStreamingUnmixed, AudioStreamingMixed, Transkription) som den här händelsen representerar.
StreamingStartTime Tidsstämpeln (UTC) där realtidsströmningssessionen startade.
StreamingDurationInMs Varaktigheten för realtidsströmningssessionen i millisekunder.
StreamingSessionId Unik identifierare för varje realtidsströmningssession som definieras som tiden mellan början och slutet av en enda modalitet för realtidsströmning i ett visst anrop.
ParticipantId Unik identifierare för varje deltagare som var närvarande i strömningssessionen identifierad av StreamingSessionId vars strömning startade vid StreamingStartTime och varade i StreamingDurationInMs. Detta gäller endast för StreamingModality AudioStreamingUnmixed och Transkription där varje deltagare representeras med sin egen post i den här tabellen.

Här är ett exempel på loggar för användningsinformation av funktionerna för samtalsautomatisering och mediaströmning:

{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"CorrelationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"StreamingModality": "AudioStreamingUnmixed",
"StreamingStartTime [UTC]": "5/24/2023, 7:57:45.480 PM",
"StreamingDurationInMs": "1172487.9394",
"StreamingSessionId": "8dc674eb-0313-46e1-8326-326ea71c7a45",
"ParticipantId": "7a5ae46f-efb0-4abb-bc9f-c1f1ccfd1470"
}

Nästa steg

  • Last updated on