Samtalsinspelningsloggar för Azure Communication Services

Artikel
10/26/2023

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-portalen.

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	Description
`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": "a999f996-b4e1-xxxx-ac04-a59test87d97",
    "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

Få insikter om samtalsinspelning.
Läs mer om samtalsinspelning.

Share via