Azure Communication Services Hívásautomatizálási naplók

Az Azure Communication Services naplózási képességeket kínál, amelyekkel monitorozhat és hibakeresést végezhet a Communication Services-megoldásban. Ezeket a képességeket az Azure Portalon konfigurálhatja.

Előfeltételek

Az Azure Communication Services monitorozási és elemzési funkciókat biztosít az Azure Monitor-naplókon és az Azure Monitor-metrikákon keresztül. Minden Azure-erőforráshoz saját diagnosztikai beállítás szükséges, amely a következő feltételeket határozza meg:

• A napló- és metrikaadatok azon célhelyekre küldött kategóriái, amelyeket a beállítás határoz meg. Az elérhető kategóriák erőforrástípusonként eltérőek.

• Egy vagy több célhely a naplók elküldéséhez. Az aktuális célhelyek közé tartozik a Log Analytics-munkaterület, az Azure Event Hubs és az Azure Storage.

  Egyetlen diagnosztikai beállítás legfeljebb egy céltípust definiálhat. Ha több céltípusba (például két Log Analytics-munkaterületre) szeretne adatokat küldeni, hozzon létre több beállítást. Minden erőforrás legfeljebb öt diagnosztikai beállításokkal rendelkezhet.

Fontos

Engedélyeznie kell egy diagnosztikai beállítást az Azure Monitorban, hogy a felmérések naplóadatait elküldje egy Log Analytics-munkaterületre, egy eseményközpontba vagy egy Azure Storage-fiókba a felmérési adatok fogadásához és elemzéséhez. Ha nem küld Hívásautomatizálási adatokat az alábbi lehetőségek egyikére, a felmérés adatai nem lesznek tárolva, és elvesznek.

Az alábbi utasítások konfigurálják az Azure Monitor-erőforrást, hogy naplókat és metrikákat hozzon létre a Communication Services-példányhoz. A diagnosztikai beállításoknak az összes Azure-erőforráson való használatával kapcsolatos részletes dokumentációt lásd: Naplózás engedélyezése a diagnosztikai beállításokban.

A diagnosztikai beállítás neve alatt válassza a Hívásautomatizálási naplók és a Hívásautomatizálási események összefoglaló naplói lehetőséget a hívásautomatizálás naplóinak engedélyezéséhez.

Erőforrásnapló-kategóriák

A Communication Services a következő típusú naplókat kínálja, amelyeket engedélyezhet:

• Használati naplók: Adja meg az egyes számlázott szolgáltatásajánlatokhoz társított használati adatokat.
• Hívásautomatizálási üzemeltetési naplók: Működési információk megadása a Call Automation API-kérelmekről. Ezekkel a naplókkal azonosíthatja a hibapontokat, és lekérdezheti a hívásban végrehajtott összes kérést (a korrelációs azonosító vagy a kiszolgáló hívásazonosítójának használatával).
• Az Automation médiaösszesítő naplóinak hívása: Adja meg a médiaműveletek eredményével kapcsolatos információkat. Ezek a naplók aszinkron módon érkeznek, amikor médiakérelmeket küld a Call Automation API-k használatával. Ezekkel a naplókkal azonosíthatja a hibapontokat és a felhasználók alkalmazással való interakciójának lehetséges mintáit.

Használati napló sémája

Property	Leírás
Timestamp	A napló létrehozásának időbélyege (UTC).
OperationName	A naplórekordhoz társított művelet.
OperationVersion	A api-version művelethez társított érték, ha a OperationName műveletet API-val hajtották végre. Ha egyetlen API sem felel meg ennek a műveletnek, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letiltja a naplókat egy erőforráson. Az esemény blobjában megjelenő properties tulajdonságok megegyeznek egy naplókategórián és erőforrástípuson belül.
CorrelationID	A korrelált események azonosítója. Ezzel azonosíthatja a több tábla közötti korrelált eseményeket.
Properties	Egyéb adatok, amelyek a kommunikációs szolgáltatások különböző módjaira vonatkoznak.
RecordID	A használati rekord egyedi azonosítója.
UsageType	A használati mód (például Csevegés, PSTN vagy NAT).
UnitType	A használati mód (például percek, megabájtok vagy üzenetek) alapján használt egység típusa.
Quantity	A rekordhoz használt vagy felhasznált egységek száma.

Az Automation működési naplóinak meghívása

Property	Leírás
TimeGenerated	A napló létrehozásának időbélyege (UTC).
OperationName	A naplórekordhoz társított művelet.
CorrelationID	A hívás azonosítására és az egyedi hívások eseményeinek korrelálására szolgáló azonosító.
OperationVersion	A api-version művelethez társított verzió, ha a operationName műveletet EGY API-val hajtották végre. Ha egyetlen API sem felel meg ennek a műveletnek, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letiltja a naplókat egy erőforráson. Az esemény blobjában megjelenő properties tulajdonságok megegyeznek egy naplókategórián és erőforrástípuson belül.
ResultType	A művelet állapota.
ResultSignature	A művelet alállapota. Ha ez a művelet egy REST API-hívásnak felel meg, ez a mező a megfelelő REST-hívás HTTP-állapotkódja.
DurationMs	A művelet időtartama ezredmásodpercben.
CallerIpAddress	A hívó IP-címe, ha a művelet egy nyilvánosan elérhető IP-címmel rendelkező entitásból származó API-hívásnak felel meg.
Level	Az esemény súlyossági szintje.
URI	A kérelem URI-ja.
CallConnectionId	A híváskapcsolatot jelképező azonosító, ha elérhető. Ez az azonosító minden résztvevő esetében eltérő, és a híváshoz való kapcsolat azonosítására szolgál.
ServerCallId	Egy hívás azonosítására szolgáló egyedi azonosító.
SDKVersion	A kéréshez használt SDK-verzió.
SDKType	A kéréshez használt SDK-típus.
ParticipantId	A kérést küldő hívás résztvevőjének azonosítására szolgáló azonosító.
SubOperationName	A médiaművelet altípusának azonosítására használt név (lejátszás vagy felismerés).
operationID	Az aszinkron események korrelálásához használt azonosító.

Íme egy példa a Call Automation működési naplójára:

[
{
"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",
}

Automation-médiaösszegző naplók meghívása

Property	Leírás
TimeGenerated	Az esemény időbélyege (UTC).
level	Az esemény súlyossági szintje. Az egyiknek, Warningvagy ErrorCriticala másiknak Informationalkell lennie.
resourceId	Az eseményt kibocsátó erőforrás azonosítója.
durationMs	A művelet időtartama ezredmásodpercben.
callerIpAddress
correlationId	A Skype láncazonosítója.
operationName	Az esemény által képviselt művelet neve.
operationVersion
resultType	Az esemény állapota. A tipikus értékek közé tartozik az Completed, Canceledés Faileda .
resultSignature	A művelet alállapota. Ha ez a művelet egy REST API-hívásnak felel meg, ez a mező a megfelelő REST-hívás HTTP-állapotkódja.
operationId	Az aszinkron események korrelálásához használt műveletazonosító.
recognizePromptSubOperationName	A művelet altípusa. A lehetséges értékek közé tartozik az File, TextToSpeechés SSMLa .
playInLoop	True ha a lejátszási művelethez hurkot kértek. False ha másként nem.
playToParticipant	True ha a játékműveletnek volt egy célpontja. False ha ez egy mindent eldöntő művelet volt.
interrupted	True ha a rendszer megszakítja a kérést. False ha másként nem.
resultCode	A művelet eredménykódja.
resultSubcode	A művelet eredmény-alkódja.
resultMessage	A művelet eredményüzenete.

Íme egy példa a Call Automation médiaösszegző naplójára:

[
{
"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."
}

Következő lépések

• Ismerje meg az elemzési irányítópultot a Hívásautomatizálási naplók és metrikák monitorozásához.