Az Azure Communication Services hívásrögzítési naplói

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.

A cikk tartalma az Azure Monitoron keresztül engedélyezett naplókra vonatkozik (lásd még a gyakori kérdéseket). Ha engedélyezni szeretné ezeket a naplókat a Communication Serviceshez, olvassa el a naplózás engedélyezése a diagnosztikai beállításokban című témakört.

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ásrögzítési összefoglaló naplók: Adja meg a hívásrögzítések összefoglaló adatait, például:
  • Hívás időtartama.
  • Médiatartalom (például hang/videó, nem kevert vagy átirat).
  • A felvételhez használt formátumtípusok (például WAV vagy MP4).
  • Az ok, amiért a felvétel véget ért.
• Bejövő műveleti naplók rögzítése: Adjon meg információkat a hívásrögzítési műveletek bejövő kéréseiről. Minden bejegyzés megfelel a hívásrögzítési API-k hívásának eredményének, például StartRecording, StopRecording, PauseRecording és ResumeRecording.

A rendszer egy hívás vagy értekezlet végén létrehoz egy felvételfájlt. Egy felhasználó vagy egy alkalmazás (robot) elindíthatja és leállíthatja a felvételt. A felvétel rendszerhiba miatt is véget vethet.

Az összefoglaló naplók közzétételre kerülnek, miután a felvétel készen áll a letöltésre. A naplók az Azure Monitor-erőforrásnaplók szokásos késési idején belül jelennek meg. Lásd: Naplóadatok betöltési ideje az Azure Monitorban.

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.

Hívásrögzítési összefoglaló naplóséma

Tulajdonság neve	Adattípus	Leírás
timeGenerated	Dátum/idő	A napló létrehozásának időbélyege (UTC).
operationName	Sztring	Naplórekordhoz társított művelet.
correlationId	Sztring	A táblák közötti események korrelálásához használt azonosító.
recordingID	Sztring	Annak a rögzítésnek az azonosítója, amelyre a napló hivatkozik.
category	Sztring	Az esemény naplókategóriája. Az azonos naplókategória és erőforrástípusú naplók tulajdonságmezői azonosak.
resultType	Sztring	A művelet állapota.
level	Sztring	A művelet súlyossági szintje.
chunkCount	Integer	A felvételhez létrehozott adattömbök teljes száma.
channelType	Sztring	A felvétel csatornatípusa, például vegyes vagy nem kevert.
recordingStartTime	Dátum/idő	A felvétel kezdetének időpontja.
contentType	Sztring	A felvétel tartalma, például csak hang, hang/videó vagy átirat.
formatType	Sztring	A felvétel fájlformátuma.
recordingLength	Dupla	A felvétel időtartama másodpercben.
audioChannelsCount	Integer	A felvétel hangcsatornáinak teljes száma.
recordingEndReason	Sztring	Az ok, amiért a felvétel véget ért.

Hívásrögzítés és példaadatok

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

Egy hívás egy vagy több felvételt tartalmazhat attól függően, hogy hányszor aktiválódik a rögzítési esemény.

Ha például egy ügynök kimenő hívást indít egy rögzített vonalon, és a hívás egy gyenge hálózati jel miatt csökken, callID egy recordingID értékkel fog rendelkezni. Ha az ügynök visszahívja az ügyfelet, a rendszer létrehoz egy új callID példányt és egy új recordingID értéket.

Példa: Hívásfelvétel egy híváshoz egy felvételhez

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

Ha az ügynök elindít egy felvételt, majd leállítja és többször újraindítja a felvételt, amíg a hívás még be van kapcsolva, callID számos recordingID érték fog rendelkezni. Az értékek száma attól függ, hogy a rögzítési események hányszor lettek aktiválva.

Példa: Hívásfelvétel több felvétel egyetlen hívásához

{   
 "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 naplók

A tulajdonságok a következők:

Property	Leírás
timeGenerated	A napló létrehozásának időbélyege (UTC).
callConnectionId	Ha elérhető, a híváskapcsolat vagy a láb azonosítója.
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.
correlationId	A korrelált események azonosítója. Ezzel azonosíthatja a több tábla közötti korrelált eseményeket.
durationMs	A művelet időtartama ezredmásodpercben.
level	A művelet súlyossági szintje.
operationName	A naplórekordokhoz társított művelet.
operationVersion	A művelethez vagy a művelet verziójához társított API-verzió (ha nincs API-verzió).
resourceId	Annak az erőforrásnak az egyedi azonosítója, amelyhez a rekord társítva van.
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.
resultType	A művelet állapota.
sdkType	A kérelemben használt SDK-típus.
sdkVersion	Az SDK verziója.
serverCallId	A kiszolgáló hívásazonosítója.
URI	A kérelem URI-ja.

Here's an example:

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

Következő lépések

• Hívásrögzítési megállapítások lekérése.
• További információ a hívásrögzítésről.