Sdílet prostřednictvím

Schéma protokolu souhrnu volání

  • Článek

Protokol souhrnu volání obsahuje data, která vám pomůžou identifikovat klíčové vlastnosti všech volání. Pro každou participantId hodnotu volání (nebo endpointId pro volání peer-to-peer [P2P] se vytvoří jiný protokol souhrnu volání.

Pro každého účastníka v rámci hovoru vytvoří komunikační služba jedinečný protokol souhrnu volání. Pokud se někdo znovu připojí k hovoru, má tento účastník stejnou EndpointId hodnotu, ale jinou ParticipantId hodnotu. Tento koncový bod pak může mít dva protokoly souhrnu volání.

Jak používat protokoly volání

Doporučujeme shromáždit všechny dostupné protokoly volání v prostředku log Analytics, abyste mohli monitorovat využití volání a zlepšit kvalitu volání a přijímat nové protokoly z Azure Communication Services při jejich vydání.

Existují dva hlavní nástroje, které můžete použít k monitorování hovorů a zlepšení kvality hovorů.

Doporučujeme použít řídicí panely pro přehledy hlasu a videa k zahájení jakéhokoli šetření kvality a použití diagnostiky volání podle potřeby k prozkoumání jednotlivých volání, když potřebujete podrobné podrobnosti.

Koncepty dat

Důležité

Pokud je chcete analyzovat, musíte shromažďovat protokoly. Další informace najdete v tématu: Návody ukládat protokoly?

Azure neukládá data protokolu volání, pokud tato konkrétní nastavení diagnostiky nepovolíte. Data volání nejsou zpětně dostupná. Jakmile vytvoříte nastavení diagnostiky, nashromáždíte data.

Definice dat

Schéma protokolu souhrnu volání

Důležité

Informace o účastníkech v protokolu souhrnu volání se liší v závislosti na tenantovi účastníka. Verze sady SDK a verze operačního systému se redactují, pokud účastník není ve stejném tenantovi (označuje se také jako prostředek Komunikační služby). Účastníci mezi tenanty jsou klasifikovaní jako externí uživatelé pozvaní tenantem prostředků, aby se připojili a spolupracovali během hovoru.

Tato tabulka popisuje každou vlastnost.

Vlastnost Popis
time Časové razítko (UTC) při vygenerování protokolu
operationName Operace přidružená k záznamu protokolu.
operationVersion Hodnota api-version přidružená k operaci, pokud operationName byla operace provedena prostřednictvím rozhraní API. Pokud žádné rozhraní API neodpovídá této operaci, verze představuje verzi operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
category Kategorie protokolu události. Tato vlastnost je členitost, při které můžete povolit nebo zakázat protokoly prostředku. Vlastnosti, které se zobrazí v objektu properties blob události, jsou stejné v kategorii protokolu a typu prostředku.
correlationId Jedinečné ID volání. Identifikuje korelované události ze všech účastníků a koncových bodů, které se připojují během jednoho volání, a můžete je použít k připojení dat z různých protokolů. Pokud byste někdy potřebovali otevřít případ podpory u Microsoftu, můžete pomocí correlationId této hodnoty snadno identifikovat volání, které řešíte.
identifier Jedinečné ID uživatele. Identitou může být uživatel Azure Communication Services, ID uživatele Microsoft Entra, anonymní ID uživatele Teams nebo ID robota Teams. Toto ID můžete použít ke korelaci uživatelských událostí napříč protokoly.
callStartTime Časové razítko pro zahájení volání na základě prvního pokusu o připojení z libovolného koncového bodu.
callDuration Doba trvání volání vyjádřená v sekundách na základě prvního pokusu o připojení a konce posledního připojení mezi dvěma koncovými body.
callType Typ hovoru. Obsahuje buď "P2P" nebo "Group". Volání "P2P" je přímé připojení 1:1 mezi pouze dvěma koncovými body bez serveru. Volání "Group" je volání, které má více než dva koncové body nebo se vytvoří jako "Group" volání před připojením.
teamsThreadId ID vlákna Teams. Toto ID je relevantní jenom v případě, že je hovor uspořádaný jako schůzka v Teams. Pak představuje případ použití vzájemné spolupráce mezi Microsoft Teams a Komunikačními službami Azure.

Toto ID je zveřejněné v provozních protokolech. Toto ID můžete získat také prostřednictvím rozhraní API chatu.
participantId ID vygenerované tak, aby představovalo obousměrné připojení mezi "Participant" koncovým bodem (endpointType = "Server") a serverem. Když callType = "P2P"dojde k přímému spojení mezi dvěma koncovými body a nevygeneruje se žádná participantId hodnota.
participantStartTime Časové razítko pro začátek prvního pokusu o připojení účastníka.
participantDuration Doba trvání připojení každého účastníka v sekundách od participantStartTime do časového razítka, kdy připojení skončilo.
participantEndReason Důvod ukončení připojení účastníka. Obsahuje kódy chyb volání sady SDK, které sada SDK pro každou participantId hodnotu generuje (pokud je relevantní).
endpointId Jedinečné ID, které představuje každý koncový bod připojený k volání, kde endpointType definuje typ koncového bodu. Pokud je nullhodnota , připojená entita je server komunikační služby ( = endpointType"Server").

Hodnota endpointId může někdy trvat pro stejného uživatele ve více voláních (correlationId) pro nativní klienty. Počet endpointId hodnot určuje počet protokolů souhrnu volání. Pro každou endpointId hodnotu se vytvoří jedinečný souhrnný protokol.
endpointType Tato hodnota popisuje vlastnosti každého koncového bodu připojeného k volání. Může obsahovat "Server", , "PSTN""VOIP", "BOT"nebo "Unknown".
sdkVersion Řetězec verze pro verzi sady SDK pro volání komunikačních služeb, kterou každý relevantní koncový bod používá (například "1.1.00.20212500").
osVersion Řetězec představující operační systém a verzi každého zařízení koncového bodu.
participantTenantId ID tenanta Microsoftu přidruženého k identitě účastníka. Tenantem může být tenant Azure, který vlastní prostředek Azure Communication Services, nebo tenanta Microsoftu identity Microsoftu 365. Toto pole slouží k vedení redakce napříč tenanty.
participantType Popis účastníka jako kombinace svého klienta (Azure Communication Services nebo Teams) a jeho identity (Azure Communication Services nebo Microsoft 365). Mezi možné hodnoty patří: Azure Communication Services (identita služeb Azure Communication Services a sada SDK služby Azure Communication Services), Teams (identita Teams a klient Teams), Azure Communication Services jako externí uživatel (identita Azure Communication Services a sada AZURE Communication Services SDK v aplikaci Teams nebo schůzka), služba Azure Communication Services jako uživatel Microsoftu 365 (identita Microsoftu 365 a klient Azure Communication Services), a aplikace Teams Voice.
pstnParticipantCallType Představuje typ a směr účastníků veřejné telefonní sítě, včetně volání tísňového volání, přímého směrování, přenosu, přesměrování atd.
ParticipantEndSubCode Představuje podkód chyby volající sady SDK, které sada SDK pro každou participantId hodnotu generuje (pokud je relevantní).
ResultCategory Představuje kategorii účastníka, který hovor ukončí. Může to být jedna z těchto čtyř hodnot: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError.
DiagnosticOptions Tato hodnota umožňuje vývojářům připojit vlastní značky ke své telemetrii klienta, které je pak možné zobrazit v části Diagnostika volání. To pomáhá efektivněji identifikovat a řešit problémy. Informace o přidání vlastních značek k této hodnotě najdete v kurzu přidání vlastních značek do telemetrie klienta.

Kódy chyb

Vlastnost participantEndReason obsahuje hodnotu ze sady kódů chyb volající sady SDK. Tyto kódy můžete použít k řešení potíží zjištěných během volání pro každý koncový bod. Viz Řešení potíží s kódy odpovědí na koncové volání pro volání sady SDK, sady SDK pro automatizaci volání, do veřejné telefonní sítě, sady SDK chatu a sady SMS SDK.

Ukázková data pro různé typy volání

Poznámka:

V tomto článku jsou volání P2P a skupiny ve výchozím nastavení ve stejném tenantovi. Všechny scénáře volání, které jsou napříč tenanty, se zadají odpovídajícím způsobem v celém článku.

Volání P2P

Tady jsou sdílená pole pro všechny protokoly ve volání P2P:

"time":                     "2021-07-19T18:46:50.188Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "aaaa0000-bb11-2222-33cc-444444dddddd",

Protokoly souhrnu volání

Operace sdílení protokolů souhrnu volání a informace o kategoriích:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Tady je souhrn volání pro uživatele VoIP 1:

"properties": {
    "identifier":               "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "callStartTime":            "2021-07-19T17:54:05.113Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",    
    "participantStartTime":     "2021-07-19T17:54:06.758Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.1.0",
    "osVersion":                "Windows 10.0.17763 Arch: x64"
}

Tady je souhrn volání pro uživatele VoIP 2:

"properties": {
    "identifier":               "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "callStartTime":            "2021-07-19T17:54:05.335Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantStartTime":     "2021-07-19T17:54:06.335Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.1.0.0",
    "osVersion":                "null"
}

Tady je protokol souhrnu volání mezi tenanty pro uživatele VoIP 1:

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             520,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "520",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

Tady je souhrn volání pro volání do veřejné telefonní sítě:

Poznámka:

Protokoly volání P2P nebo skupiny mají redakci verzí operačního systému a sady SDK bez ohledu na to, jestli se jedná o tenanta účastníka nebo tenanta robota.

"properties": {
    "identifier": "b1999c3e-bbbb-4650-9b23-9999bdabab47",
    "callStartTime": "2022-08-07T13:53:12Z",
    "callDuration": 1470,
    "callType": "Group",
    "teamsThreadId": "19:36ec5177126fff000aaa521670c804a3@thread.v2",
    "participantId": " b25cf111-73df-4e0a-a888-640000abe34d",
    "participantStartTime": "2022-08-07T13:56:45Z",
    "participantDuration": 960,
    "participantEndReason": "0",
    "endpointId": "8731d003-6c1e-4808-8159-effff000aaa2",
    "endpointType": "PSTN",
    "sdkVersion": "Redacted",
    "osVersion": "Redacted"
}

Skupinové hovory

Data pro skupinové volání se generují ve třech protokolech souhrnu volání a šesti diagnostických protokolech volání. Toto jsou sdílená pole pro všechny protokoly ve volání:

"time":                     "2021-07-05T06:30:06.402Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "bbbb1111-cc22-3333-44dd-555555eeeeee",

Protokoly souhrnu volání

Operace sdílení protokolů souhrnu volání a informace o kategoriích:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Tady je souhrn volání koncového bodu VoIP 1:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "participantStartTime":     "2021-07-05T06:16:44.235Z",
    "participantDuration":      "82",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Darwin Kernel Version 18.7.0: Mon Nov 9 15:07:15 PST 2020; root:xnu-4903.272.3~3/RELEASE_ARM64_S5L8960X"
}

Tady je souhrn volání pro koncový bod VoIP 3:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLTk2ZDUtYTZlM2I2ZjgxOTkw@thread.v2",
    "participantId":            "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "participantStartTime":     "2021-07-05T06:16:40.240Z",
    "participantDuration":      "87",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Android 11.0; Manufacturer: Google; Product: redfin; Model: Pixel 5; Hardware: redfin"
}

Tady je souhrn volání koncového bodu veřejné telefonní sítě 2:

"properties": {
    "identifier":               "null",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "515650f7-8204-4079-ac9d-d8f4bf07b04c",
    "participantStartTime":     "2021-07-05T06:17:10.447Z",
    "participantDuration":      "52",
    "participantEndReason":     "0",
    "endpointId":               "46387150-692a-47be-8c9d-1237efe6c48b",
    "endpointType":             "PSTN",
    "sdkVersion":               "null",
    "osVersion":                "null"
}

Tady je protokol souhrnu volání mezi tenanty:

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             912,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "aa1dd7da-5922-4bb1-a4fa-e350a111fd9c",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "902",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

Tady je protokol souhrnu volání mezi tenanty s robotem jako účastníkem:


"properties": {
    "identifier":             "b1902c3e-b9f7-4650-9b23-9999bdabab47",
    "callStartTime":          "2022-08-09T16:00:32Z",
    "callDuration":            1470,
    "callType":               "Group",
    "teamsThreadId":         "19:meeting_MmQwZDcwYTQtZ000HWE6NzI4LTg1YTAtNXXXXX99999ZZZZZ@thread.v2",
    "participantId":           "66e9d9a7-a434-4663-d91d-fb1ea73ff31e",
    "participantStartTime":    "2022-08-09T16:14:18Z",
    "participantDuration":      644,
    "participantEndReason":    "0",
    "endpointId":             "69680ec2-5ac0-4a3c-9574-eaaa77720b82",
    "endpointType":           "Bot",
    "sdkVersion":             "Redacted",
    "osVersion":              "Redacted"
}

Nejčastější dotazy

Návody ukládat protokoly?

Tento požadavek vysvětluje následující část.

Protokoly Azure Communication Services se ve výchozím nastavení neukládají do vašeho účtu Azure, takže je musíte začít ukládat, abyste mohli používat nástroje, jako je řídicí panel pro přehledy hlasových hovorů a diagnostika volání. Pokud chcete tyto protokoly volání shromáždit, musíte povolit nastavení diagnostiky, které směruje data volání do pracovního prostoru služby Log Analytics.

Data se neukládají zpětně, takže začnete zachytávat protokoly volání až po konfiguraci nastavení diagnostiky.

Podle pokynů přidejte nastavení diagnostiky pro váš prostředek v části Povolit protokoly prostřednictvím nastavení diagnostiky ve službě Azure Monitor. Doporučujeme nejprve shromáždit všechny protokoly. Jakmile porozumíte možnostem ve službě Azure Monitor, určete, které protokoly chcete zachovat a jak dlouho. Když přidáte nastavení diagnostiky, zobrazí se výzva k výběru protokolů. Pokud chcete shromáždit všechny protokoly, vyberte všechny protokoly.

Objem dat, uchovávání a využití v Log Analytics v rámci služby Azure Monitor se účtuje prostřednictvím stávajících měřičů dat Azure. Doporučujeme podle potřeby monitorovat využití dat a zásady uchovávání informací. Další informace naleznete v tématu Řízení nákladů.

Pokud máte více ID prostředků Azure Communications Services, musíte tato nastavení povolit pro každé ID prostředku.

Další kroky