Sdílet prostřednictvím

Volání schématu protokolu metrik

  • Článek

Tento dokument vysvětluje protokoly ACSCallingMetrics dostupné prostřednictvím služby Azure Monitor ve formě protokolů prostředků.

Protokoly metrik volání se používají na řídicím panelu pro přehledy hlasových hovorů a videí k vizualizaci dlouhodobých grafů spolehlivosti, kvality a výkonu na základě počtu úspěšných a neúspěšných volání volání rozhraní API sady SDK různých operací. Pomocí těchto protokolů získáte přehlednější informace o denních agregovaných metrikách volání napříč různými dimenzemi pro vaše komunikační úlohy. Protokoly metrik volání obsahují agregované metriky volání v denních intervalech na základě atributů, jako jsou verze sady SDK, název operačního systému a podkód chyby.

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.

Tyto metriky jsou vizualizovány na řídicím panelu přehledů pro hlas a videa. Doporučujeme si prohlédnout tyto vizuály, abyste pochopili, jak tato data použít, pokud chcete vytvořit vlastní řídicí panel nebo přizpůsobit existující řídicí panely. Existující sešit můžete upravit na řídicím panelu přehledů pro hlas a video, abyste viděli dotazy za každým vizuálem.

Toto schéma protokolu má vlastnost s názvem MetricName , která podrobně popisuje různé metriky odeslané v tomto schématu. Metriky jsou rozdělené do dvou hlavních kategorií, metrik rozhraní API a metriky UFD (User Facing Diagnostics). Metriky UFD jsou dále rozděleny do dvou skupin, které vysvětlují objem výskytů UFD a jak dobře se UFD obnovily z těchto výskytů během volání.

Vzhledem k tomu, že tyto metriky poskytují přehled o celém volajícím prostředku, můžete nastavit automatizovaná upozornění, pokud metrika spadá. Informace o nastavení automatizovaných upozornění najdete v tématu: Kurz: Vytvoření upozornění prohledávání protokolu pro prostředek Azure

Kategorie metrik

Metriky rozhraní API

Tyto metriky měří úspěšnost i selhání (dcount) volání veřejných rozhraní API sady SDK, například ztlumení, připojení atd.).

  • spolehlivost/ rozhraní API/CreateView/Local
  • spolehlivost/ rozhraní API/Join
  • spolehlivost/ rozhraní API/StartVideo
  • spolehlivost/api/AcceptIncomingCall
  • spolehlivost/ rozhraní API/CreateView/Remote
  • spolehlivost/ rozhraní API/StopVideo
  • spolehlivost/ rozhraní API/CallAgentInit
  • spolehlivost/api/StartCall

Metriky diagnostiky s přístupem uživatelů (UFD)

Metriky noha UFD (User Facing Diagnostics): (počet účastníků (nohy), které během hovoru měly aspoň jeden chybný UFD)

Poskytuje počty, kolik účastníků bylo ovlivněno UFD ve volání.

  • spolehlivost/noha/UFD/NetworkReconnect
  • spolehlivost/noha/UFD/CameraStoppedUnexpectedly
  • spolehlivost/noha/UFD/MikrofonMuteUnexpectedly
  • spolehlivost/ noha/UFD/NetworkReceiveQuality
  • spolehlivost/ noha/ UFD / MikrofonPermissionDenied
  • spolehlivost/noha/UFD/MikrofonNotFunctioning
  • spolehlivost/noha/UFD/NoMicrophoneDevicesEnumerated
  • spolehlivost/ noha/ UFD / KameraPermissionDenied
  • spolehlivost/noha/UFD/CameraStartFailed
  • spolehlivost/noha/UFD/CapturerStoppedUnexpectedly
  • spolehlivost/noha/UFD/CapturerStartFailed
  • spolehlivost/noha/UFD/CameraStartTimedOut
  • spolehlivost/noha/UFD/NoSpeakerDevicesEnumerated
  • spolehlivost/ noha/ UFD / FotoaparátFreeze
  • spolehlivost/ noha/UFD/NetworkRelaysNotReachable
  • spolehlivost/noha/UFD/SpeakingWhileMicrophoneIsMuted
  • spolehlivost/ noha/ UFD / NoNetwork
  • spolehlivost/noha/UFD/NetworkSendQuality
  • spolehlivost/ noha/UFD/ScreenshareRecordingDisabled

Metriky obnovení rozhraní API UFD (User Facing Diagnostics): (počet výskytů, u které došlo k problému, ale během volání se obnovilo)

Poskytuje počty, kolik identifikátorů UFD se aktivovalo během volání volající sadou SDK, ale následně se během volání obnovilo. Například pokud NetworkReconnect byl UFD aktivován jednou během volání, ale síť se úspěšně obnovila během volání. V tomto příkladu se ≥ počet chybných metrik UFD pro obnovení rozhraní API. Mohli byste vypočítat rychlost obnovení UFD 100 %.

  • spolehlivost/ api/UFD/recovery/NetworkReceiveQuality
  • spolehlivost/ rozhraní API/UFD/recovery/NetworkReconnect
  • spolehlivost/ api/UFD/recovery/CameraStoppedUnexpectedly
  • spolehlivost/ api/UFD/recovery/NetworkSendQuality
  • spolehlivost/ api/UFD/recovery/MicrophoneMuteUnexpectedly
  • spolehlivost/ rozhraní API/UFD/recovery/MicrophoneNotFunctioning
  • spolehlivost/ api/UFD/recovery/CapturerStoppedUnexpectedly
  • spolehlivost/api/UFD/recovery/CameraFreeze
  • spolehlivost/ rozhraní API/UFD/recovery/CameraStartFailed
  • spolehlivost/api/UFD/recovery/NoMicrophoneDevicesEnumerated
  • spolehlivost/ api/UFD/recovery/MicrophonePermissionDenied
  • spolehlivost/ api/UFD/recovery/CameraPermissionDenied
  • spolehlivost/ api/UFD/recovery/NoSpeakerDevicesEnumerated
  • spolehlivost/ api/UFD/recovery/CapturerStartFailed
  • spolehlivost/ api/UFD/recovery/ScreenshareRecordingDisabled
  • spolehlivost/ rozhraní API/UFD/recovery/NoNetwork
  • spolehlivost/ rozhraní API/UFD/recovery/CameraStartTimedOut
  • spolehlivost/ api/UFD/recovery/SpeakingWhileMicrophoneIsMuted
  • spolehlivost/ rozhraní API/UFD/recovery/NetworkRelaysNotReachable

Definice dat

Volání schématu protokolu metrik

Tato tabulka popisuje každou vlastnost.

Vlastnost Popis
TimeGenerated Časové razítko (UTC) při vygenerování protokolu
OperationName Operace přidružená k záznamu protokolu.
OperationVersion Verze rozhraní API přidružená k operaci. Nebo verze operace, pokud neexistuje žádná verze rozhraní API.
Category Kategorie protokolu události. Protokoly se stejnou kategorií protokolu a typem prostředku sdílejí stejná pole vlastností.
CorrelationId Jedinečný identifikátor GUID, který koreluje události ve stejné dimenzi.
TimestampMax Maximální časové razítko ve standardu UTC pro každou dimenzi.
TimestampBin Interval denního časového razítka pro každou dimenzi.
MetricValueAvg Průměrná hodnota metriky pro každou dimenzi.
Unit Jednotka metriky.
Goal Prahová hodnota definovaná pro úspěšnou nohu.
FailedLegsDcount Počet neúspěšných účastníků (nohou) na dimenzi.
SuccessLegsDcount Počet úspěšných účastníků (nohou) na dimenzi.
CallsDcount Celkový počet volání na dimenzi.
LegsDcount Celkový počet účastníků (nohou) na dimenzi.
SubCode Dimenze označující podkód.
CallType Dimenze označující typ volání.
Platform Dimenze platformy (například iOS, Android, Windows).
ResultType Dimenze typu výsledku (například kategorie úspěchu nebo selhání).
DeviceModel Dimenze označující model zařízení.
DeviceBrand Rozměr označující značku zařízení.
DeviceFamily Dimenze označující rodinu zařízení.
DeviceOsVersionMajor Číslo hlavní verze operačního systému zařízení
DeviceOsVersionMinor Číslo podverze operačního systému zařízení.
DeviceBrowserVersionMinor Číslo podverze prohlížeče zařízení
DeviceBrowserVersionMajor Hlavní číslo verze prohlížeče zařízení
DeviceOsName Název operačního systému zařízení
DeviceBrowser Název prohlížeče zařízení
SdkVersion Verze sady SDK spuštěná v klientovi.
MetricName Název měřené metriky.

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

Volání protokolu metrik pro volání P2P a skupinových volání

V protokolu metrik volání neexistuje žádný rozdíl mezi scénáři volání P2P a skupinovým voláním. Následující kód je obecná ukázka znázorňující schéma těchto protokolů.

Protokol metrik volání

Tady jsou dva ukázkové řádky protokolu metrik volání:

"properties": {
  "TenantId": "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
  "TimeGenerated": "2025-02-03T05:17:39.1840000Z",
  "OperationName": "CallingMetrics",
  "OperationVersion": "1.0-dev",
  "Category": "CallingMetrics",
  "CorrelationId": "1f27dac9e6d64c82cafdd6da73cdb785",
  "TimestampMax": "2025-02-02T14:35:55.0000000Z",
  "TimestampBin": "2025-02-02T00:00:00.0000000Z",
  "MetricValueAvg": 100,
  "Unit": "percentage",
  "Goal": ">= 100.0",
  "FailedLegsDcount": 0,
  "SuccessLegsDcount": 2,
  "CallsDcount": 1,
  "LegsDcount": 2,
  "SubCode": 0,
  "CallType": "1 to 1",
  "Platform": "Web",
  "ResultType": "Succeeded",
  "DeviceModel": "",
  "DeviceBrand": "",
  "DeviceFamily": "Other",
  "DeviceOsVersionMajor": "",
  "DeviceOsVersionMinor": 10,
  "DeviceBrowserVersionMinor": 0,
  "DeviceBrowserVersionMajor": 132,
  "DeviceOsName": "Windows",
  "DeviceBrowser": "Edge",
  "SdkVersion": "1.32.1.0_stable",
  "MetricName": "reliability/leg/UFD/CameraStoppedUnexpectedly",
  "SourceSystem": "",
  "Type": "ACSCallingMetrics",
  "_ResourceId": "/subscriptions/50ad1522-5c2c-4d9a-a6c8-67c11ecb75b8/resourcegroups/calling-sample-apps/providers/microsoft.communication/communicationservices/corertc-test-apps"
}

"properties": {
  "TenantId": "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
  "TimeGenerated": "2025-02-03T05:17:39.1840000Z",
  "OperationName": "CallingMetrics",
  "OperationVersion": "1.0-dev",
  "Category": "CallingMetrics",
  "CorrelationId": "1f27dac9e6d64c82cafdd6da73cdb785",
  "TimestampMax": "2025-02-02T14:35:55.0000000Z",
  "TimestampBin": "2025-02-02T00:00:00.0000000Z",
  "MetricValueAvg": 100,
  "Unit": "percentage",
  "Goal": ">= 100.0",
  "FailedLegsDcount": 0,
  "SuccessLegsDcount": 2,
  "CallsDcount": 1,
  "LegsDcount": 2,
  "SubCode": 0,
  "CallType": "1 to 1",
  "Platform": "Web",
  "ResultType": "Succeeded",
  "DeviceModel": "",
  "DeviceBrand": "",
  "DeviceFamily": "Other",
  "DeviceOsVersionMajor": "",
  "DeviceOsVersionMinor": 10,
  "DeviceBrowserVersionMinor": 0,
  "DeviceBrowserVersionMajor": 132,
  "DeviceOsName": "Windows",
  "DeviceBrowser": "Edge",
  "SdkVersion": "1.32.1.0_stable",
  "MetricName": "reliability/leg/UFD/CameraStoppedUnexpectedly",
  "SourceSystem": "",
  "Type": "ACSCallingMetrics",
  "_ResourceId": "/subscriptions/50ad1522-5c2c-4d9a-a6c8-67c11ecb75b8/resourcegroups/calling-sample-apps/providers/microsoft.communication/communicationservices/corertc-test-apps"
}

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