Dela via

Samtalsinspelningsloggar för Azure Communication Services

  • Artikel

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.

Innehållet i den här artikeln refererar till loggar som aktiverats via Azure Monitor (se även Vanliga frågor och svar). Information om hur du aktiverar loggarna för Communication Services finns i Aktivera loggning i diagnostikinställningar.

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.
  • Sammanfattningsloggar för samtalsinspelning: Ange sammanfattningsinformation för samtalsinspelningar, till exempel:
    • Samtalsvaraktighet.
    • Medieinnehåll (till exempel ljud/video, omixat eller transkription).
    • Formattyper som används för inspelningen (till exempel WAV eller MP4).
    • Anledningen till att inspelningen avslutades.
  • Registrera inkommande driftloggar: Ange information om inkommande begäranden för samtalsinspelningsåtgärder. Varje post motsvarar resultatet av ett anrop till API:erna för samtalsinspelning, till exempel StartRecording, StopRecording, PauseRecording och ResumeRecording.

En inspelningsfil genereras i slutet av ett samtal eller möte. Antingen kan en användare eller en app (robot) starta och stoppa inspelningen. Inspelningen kan också avslutas på grund av ett systemfel.

Sammanfattningsloggar publiceras när en inspelning är redo att laddas ned. Loggarna publiceras inom standardsvarstiden för Azure Monitor-resursloggar. Se Loggdatainmatningstid i Azure Monitor.

Schema för användningslogg

Property 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 används eller förbrukas för den här posten.

Schema för sammanfattningslogg för samtalsinspelning

Egenskapsnamn Datatyp beskrivning
timeGenerated Datum/tid Tidsstämpeln (UTC) för när loggen genererades.
operationName String Åtgärden som är associerad med en loggpost.
correlationId String Det ID som används för att korrelera händelser mellan tabeller.
recordingID String ID:t för inspelningen som den här loggen refererar till.
category String Loggkategorin för händelsen. Loggar med samma loggkategori och resurstyp har samma egenskapsfält.
resultType String Status för åtgärden.
level String Allvarlighetsgraden för åtgärden.
chunkCount Integer Det totala antalet segment som skapats för inspelningen.
channelType String Kanaltypen för inspelningen, till exempel blandad eller omixad.
recordingStartTime Datum/tid Tiden då inspelningen startade.
contentType String Innehållet i inspelningen, till exempel endast ljud, ljud/video eller transkription.
formatType String Filformatet för inspelningen.
recordingLength Dubbel Inspelningens varaktighet i sekunder.
audioChannelsCount Integer Det totala antalet ljudkanaler i inspelningen.
recordingEndReason String Anledningen till att inspelningen avslutades.

Samtalsinspelning och exempeldata

"operationName":            "Call Recording Summary",
"operationVersion":         "1.0",
"category":                 "RecordingSummary",

Ett samtal kan ha en inspelning eller många inspelningar, beroende på hur många gånger en inspelningshändelse utlöses.

Om en agent till exempel startar ett utgående samtal på en inspelad rad och samtalet avbryts på grund av en dålig nätverkssignal, callID har ett recordingID värde. Om agenten anropar kunden genererar systemet en ny callID instans och ett nytt recordingID värde.

Exempel: Anropa inspelning för ett anrop till en inspelning

"properties"
{  
  "TimeGenerated":"2022-08-17T23:18:26.4332392Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "zzzzzz-cada-4164-be10-0000000000",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBvaW5xxxxxxxxFmNjkwxxxxxxxxxxxxSZXNvdXJjZVNwZWNpZmljSWQiOiJiZGU5YzE3Ni05M2Q3LTRkMWYtYmYwNS0yMTMwZTRiNWNlOTgifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-16T09:07:54.0000000Z",
    "RecordingLength": "73872.94",
    "ChunkCount": 6,
   "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

Om agenten startar en inspelning och sedan stoppar och startar om inspelningen flera gånger medan anropet fortfarande är aktiverat har callID många recordingID värden. Antalet värden beror på hur många gånger inspelningshändelserna utlöstes.

Exempel: Anropa inspelning för ett samtal till många inspelningar


{   
 "TimeGenerated": "2022-08-17T23:55:46.6304762Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBxxxxxxxxxxxxjkwMC05MmEwLTRlZDYtOTcxYS1kYzZlZTkzNjU0NzciLCJSxxxxxNwZWNpZmljSWQiOiI5ZmY2ZTY2Ny04YmQyLTQ0NzAtYmRkYy00ZTVhMmUwYmNmOTYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:43.3304762Z",
    "RecordingLength": 3.34,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}
{
    "TimeGenerated": "2022-08-17T23:55:56.7664976Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuxxxxxxiOiI4NDFmNjkwMC1mMjBiLTQzNmQtYTg0Mi1hODY2YzE4M2Y0YTEiLCJSZXNvdXJjZVNwZWNpZmljSWQiOiI2YzRlZDI4NC0wOGQ1LTQxNjEtOTExMy1jYWIxNTc3YjM1ODYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:54.0664976Z",
    "RecordingLength": 2.7,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

ACSCallRecordingIncomingOperations-loggar

Här är egenskaperna:

Property beskrivning
timeGenerated Tidsstämpeln (UTC) för när loggen genererades.
callConnectionId ID:t för samtalsanslutningen eller benet, om det är tillgängligt.
callerIpAddress Anroparens IP-adress, om åtgärden motsvarar ett API-anrop som kommer från en entitet med en offentligt tillgänglig IP-adress.
correlationId ID:t för korrelerade händelser. Du kan använda den för att identifiera korrelerade händelser mellan flera tabeller.
durationMs Varaktigheten för åtgärden i millisekunder.
level Allvarlighetsgraden för åtgärden.
operationName Åtgärden som är associerad med loggposter.
operationVersion DEN API-version som är associerad med åtgärden eller versionen av åtgärden (om det inte finns någon API-version).
resourceId En unik identifierare för resursen som posten är associerad med.
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.
resultType Status för åtgärden.
sdkType Den SDK-typ som används i begäran.
sdkVersion SDK-versionen.
serverCallId Serveranrops-ID.
URI URI:n för begäran.

Här är ett exempel:

"properties"
{  "TimeGenerated": "2023-05-09T15:58:30.100Z",
    "Level": "Informational",
    "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "OperationName": "ResumeCallRecording",
    "OperationVersion": "2023-03-06",
    "URI": "https://acsresouce.communication.azure.com/calling/recordings/   eyJQbGF0Zm9ybUVuZHBviI0MjFmMTIwMC04MjhiLTRmZGItOTZjYi0...:resume?api-version=2023-03-06",
    "ResultType": "Succeeded",
    "ResultSignature": 202,
    "DurationMs": 130,
    "CallerIpAddress": "127.0.0.1",
    "CallConnectionId": "d5596715-ab0b-test-8eee-575c250e4234",
    "ServerCallId": "aHR0cHM6Ly9hcGk0vjCCCCCCQd2pRP2k9OTMmZT02Mzc5OTQ3xMDAzNDUwMzg...",
    "SdkVersion": "1.0.0-alpha.20220829.1",
    "SdkType": "dotnet"
}

Nästa steg