Azure Communication Services Call Automation-logboeken
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.
Vereisten
Azure Communication Services biedt bewakings- en analysefuncties via Azure Monitor-logboeken en metrische gegevens van Azure Monitor. Voor elke Azure-resource is een eigen diagnostische instelling vereist, die de volgende criteria definieert:
Categorieën van logboek- en metrische gegevens die worden verzonden naar de bestemmingen die door de instelling worden gedefinieerd. De beschikbare categorieën variëren per resourcetype.
Een of meer bestemmingen voor de logboeken. Huidige bestemmingen zijn onder andere Log Analytics-werkruimte, Azure Event Hubs en Azure Storage.
Eén diagnostische instelling kan niet meer dan één van elk doeltype definiëren. Als u gegevens wilt verzenden naar meer dan één doeltype (bijvoorbeeld twee Log Analytics-werkruimten), maakt u meerdere instellingen. Elke resource kan maximaal vijf diagnostische instellingen hebben.
Belangrijk
U moet een diagnostische instelling in Azure Monitor inschakelen om de logboekgegevens van uw enquêtes te verzenden naar een Log Analytics-werkruimte, een Event Hub of een Azure-opslagaccount om uw enquêtegegevens te ontvangen en te analyseren. Als u geen gespreksautomatiseringsgegevens naar een van deze opties verzendt, worden uw enquêtegegevens niet opgeslagen en gaan ze verloren.
Met de volgende instructies configureert u uw Azure Monitor-resource om logboeken en metrische gegevens te maken voor uw Communication Services-exemplaar. Zie Logboekregistratie in diagnostische instellingen inschakelen voor gedetailleerde documentatie over het gebruik van diagnostische instellingen voor alle Azure-resources.
Selecteer onder de naam van de diagnostische instelling operation Call Automation-logboeken en samenvattingslogboeken voor oproepautomatisering om de logboeken voor gespreksautomatisering in te schakelen.
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.
- Operationele logboeken voor aanroepen van automatisering: operationele informatie over aanroepen van Automation-API-aanvragen. U kunt deze logboeken gebruiken om storingspunten te identificeren en alle aanvragen in een aanroep op te vragen (met behulp van de correlatie-id of de aanroep-id van de server).
- Samenvattingslogboeken van Gespreksautomatiseringsmedia: geef informatie over het resultaat van mediabewerkingen. Deze logboeken worden asynchroon weergegeven wanneer u mediaaanvragen doet met behulp van Call Automation-API's. U kunt deze logboeken gebruiken om foutenpunten en mogelijke patronen te identificeren voor de interactie van gebruikers met uw toepassing.
Schema voor gebruikslogboek
| Eigenschappen | Beschrijving |
|---|---|
Timestamp |
Het tijdstempel (UTC) van het moment waarop het logboek is 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. |
Operationele logboeken oproepautomatisering
| Eigenschappen | Beschrijving |
|---|---|
TimeGenerated |
Het tijdstempel (UTC) van het moment waarop het logboek is gegenereerd. |
OperationName |
De bewerking die is gekoppeld aan de logboekrecord. |
CorrelationID |
De id voor het identificeren van een oproep en het correleren van gebeurtenissen voor een unieke aanroep. |
OperationVersion |
De api-version versie 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. |
ResultType |
De status van de bewerking. |
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. |
DurationMs |
De duur van de bewerking in milliseconden. |
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. |
Level |
De ernst van de gebeurtenis. |
URI |
De URI van de aanvraag. |
CallConnectionId |
De id die de oproepverbinding vertegenwoordigt, indien beschikbaar. Deze id is verschillend voor elke deelnemer en wordt gebruikt om de verbinding met de oproep te identificeren. |
ServerCallId |
Een unieke id om een aanroep te identificeren. |
SDKVersion |
De SDK-versie die wordt gebruikt voor de aanvraag. |
SDKType |
Het SDK-type dat wordt gebruikt voor de aanvraag. |
ParticipantId |
De id om de gespreksdeelnemer te identificeren die de aanvraag heeft ingediend. |
SubOperationName |
De naam die wordt gebruikt om het subtype van de mediabewerking te identificeren (afspelen of herkennen). |
operationID |
De id die wordt gebruikt om asynchrone gebeurtenissen te correleren. |
Hier volgt een voorbeeld van een operationeel logboek voor oproepautomatisering:
[
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "e2a97d52-0cbb-4adf-8c4b-e10f791fb764",
"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",
}
Samenvattingslogboeken van Gespreksautomatiseringsmedia
| Eigenschappen | Beschrijving |
|---|---|
TimeGenerated |
Het tijdstempel (UTC) van de gebeurtenis. |
level |
De ernst van de gebeurtenis. Het moet een van Informational, Warning, Errorof Critical. |
resourceId |
De id van de resource die de gebeurtenis heeft verzonden. |
durationMs |
De duur van de bewerking in milliseconden. |
callerIpAddress |
|
correlationId |
De Skype-keten-id. |
operationName |
De naam van de bewerking die deze gebeurtenis vertegenwoordigt. |
operationVersion |
|
resultType |
De status van de gebeurtenis. Typische waarden zijn onder andere Completed, Canceleden Failed. |
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. |
operationId |
De bewerkings-id die wordt gebruikt om asynchrone gebeurtenissen te correleren. |
recognizePromptSubOperationName |
Een subtype van de bewerking. Mogelijke waarden zijn onder andere File, TextToSpeechen SSML. |
playInLoop |
True als lusing is aangevraagd voor de afspeelbewerking. False indien anders. |
playToParticipant |
True als de afspeelbewerking een doel had. False als het een play-to-all-bewerking was. |
interrupted |
True als de prompt wordt onderbroken. False indien anders. |
resultCode |
De resultaatcode van de bewerking. |
resultSubcode |
De resultaatsubcode van de bewerking. |
resultMessage |
Het resultaatbericht van de bewerking. |
Hier volgt een voorbeeld van een samenvattingslogboek van Call Automation-media:
[
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "d149d528-a392-404c-8fcd-69087e9d0802",
"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."
}
Volgende stappen
- Meer informatie over het inzichtendashboard voor het bewaken van oproepautomatiseringslogboeken en metrische gegevens.