Sdílet prostřednictvím

Volání schématu protokolu operací klienta

  • Článek

Protokol operací klienta volání poskytuje informace na straně klienta o volajících koncových bodech a účastníkůch zapojených do volání. Tyto protokoly jsou aktuálně ve verzi Preview a zobrazují události klienta, ke kterým došlo při volání a jaké akce zákazník provede během hovoru.

Tento protokol poskytuje podrobné informace o akcích provedených během volání a je možné je použít k vizualizaci a zkoumání problémů s voláním pomocí diagnostiky volání pro prostředek služby Azure Communication Services. Další informace o diagnostice 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

Volání schématu protokolu operací klienta

Tato tabulka popisuje každou vlastnost.

Vlastnost Popis
CallClientTimeStamp Časové razítko, kdy došlo k operaci v sadě SDK v UTC.
OperationName Název operace aktivované na volající sadě SDK.
CallId 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ů. Podobá se ID korelace v protokolu souhrnu volání a diagnostickém protokolu volání.
ParticipantId Jedinečný identifikátor pro každou nohu hovoru (ve skupinových hovorech) nebo účastníka hovoru (v partnerském vztahu k partnerským voláním). Toto ID je hlavní korelační bod mezi protokoly CallSummary, CallDiagnostic, CallClientOperations a CallClientMediaStats.
OperationType Volání operace klienta
OperationId Jedinečný identifikátor GGUID identifikující operaci sady SDK.
DurationMs Doba, kterou trvala operace volání sady SDK, selhala nebo byla úspěšná.
ResultType Pole popisující úspěch nebo selhání operace
ResultSignature Selhání podobné protokolu HTTP nebo kód úspěchu (200, 500).
SdkVersion Používá se verze sady SDK pro volání.
UserAgent Používá se standardní řetězec uživatelského agenta založený na prohlížeči nebo sadě SDK pro volání platformy.
ClientInstanceId Jedinečný objekt GGUID identifikující objekt CallClient.
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 hodnota null, 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) nativních klientů. Počet hodnot endpointId určuje počet protokolů souhrnu volání. Pro každou hodnotu endpointId se vytvoří jedinečný souhrnný protokol.
OperationPayload Dynamická datová část, která se liší v závislosti na operaci, která poskytuje podrobnější podrobnosti o operaci.

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

Volání protokolu operací klienta

Tady je protokol operací volání klienta pro operaci CreateView:

"properties": {
    "TenantId":               "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":          "2024-01-09T17:06:50.3Z",
    "CallClientTimeStamp":    "2024-01-09T15:07:56.066Z",
    "OperationName":          "CreateView" ,   
    "CallId":                 "92d800c4-abde-40be-91e9-3814ee786b19",
    "ParticipantId":          "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
    "OperationType":          "client-api-request",
    "OperationId":            "0d987336-37e0-4acc-aba3-e48741d88103",
    "DurationMs":             "577",
    "ResultType":             "Succeeded",
    "ResultSignature":        "200",
    "SdkVersion":             "1.19.2.2_beta",
    "UserAgent":              "azure-communication-services/1.3.1-beta.1 azsdk-js-communication-calling/1.19.2-beta.2 (javascript_calling_sdk;#clientTag:904f667c-5f25-4729-9ee8-6968b0eaa40b). Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "ClientInstanceId":       "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "OperationPayload":       "{"StreamType":"Video","StreamId":"2.0","Source":"remote","RemoteParticipantId":"remote"}",
    "Type":                   "ACSCallClientOperations"
}

Každý účastník může mít pro hovor mnoho různých metrik. Spuštěním následujícího dotazu v Log Analytics na webu Azure Portal můžete zobrazit seznam všech možných operací v protokolu operací volání klienta:

ACSCallClientOperations | distinct OperationName

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