Opnamelogboeken voor Oproepen van Azure Communication Services

Artikel
10/26/2023

Azure Communication Services biedt mogelijkheden voor logboekregistratie die u kunt gebruiken om uw Communication Services-oplossing te bewaken en fouten op te sporen. U configureert deze mogelijkheden via Azure Portal.

De inhoud in dit artikel verwijst naar logboeken die zijn ingeschakeld via Azure Monitor (zie ook veelgestelde vragen). Zie Logboekregistratie in diagnostische instellingen inschakelen om deze logboeken in te schakelen voor Communication Services.

Categorieën van resourcelogboeken

Communication Services biedt de volgende typen logboeken die u kunt inschakelen:

Gebruikslogboeken: geef gebruiksgegevens op die zijn gekoppeld aan elke gefactureerde serviceaanbiedingen.
Samenvattingslogboeken oproepopname: geef samenvattingsinformatie op voor oproepopnamen, zoals:
- Gespreksduur.
- Media-inhoud (bijvoorbeeld audio/video, niet-gemengd of transcriptie).
- Indelingstypen die worden gebruikt voor de opname (bijvoorbeeld WAV of MP4).
- De reden waarom de opname is beëindigd.
Logboeken voor binnenkomende bewerkingen opnemen: geef informatie op over binnenkomende aanvragen voor oproepopnamebewerkingen. Elke vermelding komt overeen met het resultaat van een aanroep naar de CALL Recording-API's, zoals StartRecording, StopRecording, PauseRecording en ResumeRecording.

Er wordt een opnamebestand gegenereerd aan het einde van een gesprek of vergadering. Een gebruiker of een app (bot) kan de opname starten en stoppen. De opname kan ook worden beëindigd vanwege een systeemfout.

Samenvattingslogboeken worden gepubliceerd nadat een opname gereed is om te worden gedownload. De logboeken worden gepubliceerd binnen de standaardlatentietijd voor Azure Monitor-resourcelogboeken. Zie De opnametijd van logboekgegevens in Azure Monitor.

Schema voor gebruikslogboek

Eigenschappen	Beschrijving
`timestamp`	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
`operationName`	De bewerking die is gekoppeld aan de logboekrecord.
`operationVersion`	De `api-version` waarde die is gekoppeld aan de bewerking, als de `operationName` bewerking is uitgevoerd via een API. Als er geen API overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van de bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
`category`	De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een resource kunt in- of uitschakelen. De eigenschappen die in de `properties` blob van een gebeurtenis worden weergegeven, zijn hetzelfde binnen een logboekcategorie en resourcetype.
`correlationID`	De id voor gecorreleerde gebeurtenissen. U kunt deze gebruiken om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren.
`Properties`	Andere gegevens die van toepassing zijn op verschillende modi van Communication Services.
`recordID`	De unieke id voor een gebruiksrecord.
`usageType`	De gebruiksmodus (bijvoorbeeld Chat, PSTN of NAT).
`unitType`	Het type eenheid waarop het gebruik is gebaseerd voor een gebruiksmodus (bijvoorbeeld minuten, megabytes of berichten).
`quantity`	Het aantal eenheden dat is gebruikt of verbruikt voor deze record.

Samenvattingslogboekschema voor gespreksopname

Naam van de eigenschap	Gegevenstype	Beschrijving
`timeGenerated`	Datum en tijd	Het tijdstempel (UTC) van het moment waarop het logboek is gegenereerd.
`operationName`	String	De bewerking die is gekoppeld aan een logboekrecord.
`correlationId`	String	De id die wordt gebruikt om gebeurtenissen tussen tabellen te correleren.
`recordingID`	String	De id voor de opname waarnaar dit logboek verwijst.
`category`	String	De logboekcategorie van de gebeurtenis. Logboeken met dezelfde logboekcategorie en hetzelfde resourcetype hebben dezelfde eigenschapsvelden.
`resultType`	String	De status van de bewerking.
`level`	String	Het ernstniveau van de bewerking.
`chunkCount`	Geheel getal	Het totale aantal segmenten dat is gemaakt voor de opname.
`channelType`	String	Het kanaaltype van de opname, zoals gemengd of niet-gemengd.
`recordingStartTime`	Datum en tijd	De tijd waarop de opname is gestart.
`contentType`	String	De inhoud van de opname, zoals alleen audio, audio/video of transcriptie.
`formatType`	String	De bestandsindeling van de opname.
`recordingLength`	Dubbel	De duur van de opname in seconden.
`audioChannelsCount`	Geheel getal	Het totale aantal audiokanalen in de opname.
`recordingEndReason`	String	De reden waarom de opname is beëindigd.

Gespreksopname en voorbeeldgegevens

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

Een oproep kan één opname of veel opnamen hebben, afhankelijk van hoe vaak een opnamegebeurtenis wordt geactiveerd.

Als een agent bijvoorbeeld een uitgaande oproep start op een opgenomen regel en de oproep afneemt vanwege een slecht netwerksignaal, callID heeft één recordingID waarde. Als de agent de klant terugroept, genereert het systeem een nieuw callID exemplaar en een nieuwe recordingID waarde.

Voorbeeld: Gespreksopname voor één oproep naar één opname

"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
}

Als de agent een opname start en de opname vervolgens meerdere keren stopt en opnieuw start terwijl de oproep nog steeds is ingeschakeld, callID heeft deze veel recordingID waarden. Het aantal waarden is afhankelijk van hoe vaak de opnamegebeurtenissen zijn geactiveerd.

Voorbeeld: Gespreksopname voor één oproep naar veel opnamen


{   
 "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-logboeken

Dit zijn de eigenschappen:

Eigenschappen	Beschrijving
`timeGenerated`	Het tijdstempel (UTC) van het moment waarop het logboek is gegenereerd.
`callConnectionId`	De id van de oproepverbinding of het been, indien beschikbaar.
`callerIpAddress`	Het aanroeper-IP-adres, als de bewerking overeenkomt met een API-aanroep die afkomstig is van een entiteit met een openbaar beschikbaar IP-adres.
`correlationId`	De id voor gecorreleerde gebeurtenissen. U kunt deze gebruiken om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren.
`durationMs`	De duur van de bewerking in milliseconden.
`level`	Het ernstniveau van de bewerking.
`operationName`	De bewerking die is gekoppeld aan logboekrecords.
`operationVersion`	De API-versie die is gekoppeld aan de bewerking of versie van de bewerking (als er geen API-versie is).
`resourceId`	Een unieke id voor de resource waaraan de record is gekoppeld.
`resultSignature`	De substatus van de bewerking. Als deze bewerking overeenkomt met een REST API-aanroep, dan is dit veld de HTTP-statuscode van de bijbehorende REST-aanroep.
`resultType`	De status van de bewerking.
`sdkType`	Het SDK-type dat in de aanvraag wordt gebruikt.
`sdkVersion`	De SDK-versie.
`serverCallId`	De aanroep-id van de server.
`URI`	De URI van de aanvraag.

Hier volgt een voorbeeld:

"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"
}

Volgende stappen

Krijg inzichten in gespreksopname.
Meer informatie over gespreksopname.

Delen via