Partilhar via

Esquema de log de métricas de chamada

  • Artigo

Este documento explica os logs ACSCallingMetrics disponíveis para você por meio do Azure Monitor na forma de Logs de Recursos.

Os logs de métricas de chamadas são usados no painel de insights de voz e vídeo para visualizar gráficos de longo prazo de confiabilidade, qualidade e desempenho com base na contagem de chamadas de API do SDK de chamadas bem-sucedidas e com falha de várias operações. Use esses logs para obter uma compreensão mais clara das métricas de chamadas agregadas diárias em várias dimensões para suas cargas de trabalho de comunicação. os logs de métricas de chamada contêm métricas de chamada agregadas em compartimentos diários com base em atributos como Versão do SDK, nome do sistema operacional e subcódigo de erro.

Como usar os registros de chamadas

Recomendamos que você colete todos os logs de chamadas disponíveis em um recurso de análise de log para que possa monitorar o uso de chamadas e melhorar a qualidade da chamada e receber novos logs dos Serviços de Comunicação do Azure à medida que os lançamos.

Existem duas ferramentas principais que pode utilizar para monitorizar as suas chamadas e melhorar a qualidade das chamadas.

Recomendamos usar os painéis do painel de insights de voz e vídeo para iniciar investigações de qualidade e usar diagnósticos de chamadas, conforme necessário, para explorar chamadas individuais quando precisar de detalhes granulares.

Conceitos de dados

Importante

Você deve coletar logs se quiser analisá-los. Para saber mais, consulte: Como faço para armazenar logs?

O Azure não armazena seus dados de log de chamadas, a menos que você habilite essas Configurações de Diagnóstico específicas. Os dados da sua chamada não estão disponíveis retroativamente. Você acumula dados depois de criar as Configurações de diagnóstico.

Essas métricas são visualizadas no Painel de Insights de voz e vídeo, recomendamos revisar esses elementos visuais para entender como você pode usar esses dados se quiser criar seu próprio painel ou personalizar os painéis existentes. Você pode editar a pasta de trabalho existente no Painel do Voice and Video Insights para ver as consultas por trás de cada visual.

Este esquema de log tem uma propriedade chamada MetricName que detalha as várias métricas que são enviadas nesse esquema. As métricas são divididas em duas categorias principais, métricas de API e métricas de diagnóstico voltado para o usuário (UFD). As métricas UFD são ainda divididas em dois grupos que explicam o volume de ocorrências UFD e quão bem UFDs se recuperaram dessas ocorrências durante chamadas.

Como essas métricas fornecem uma visão geral de todo o seu recurso de chamadas, você pode configurar alertas automatizados se uma métrica cair. Para saber como configurar alertas automatizados, consulte: Tutorial: Criar um alerta de pesquisa de log para um recurso do Azure

Categorias de métricas

Métricas da API

Essas métricas medem os sucessos e falhas (dcount) das APIs públicas do SDK de chamada, por exemplo (silenciar, juntar, etc.).

  • confiabilidade/api/CreateView/Local
  • confiabilidade/api/Join
  • confiabilidade/api/StartVideo
  • confiabilidade/api/AcceptIncomingCall
  • confiabilidade/api/CreateView/Remote
  • confiabilidade/api/StopVideo
  • confiabilidade/api/CallAgentInit
  • confiabilidade/api/StartCall

Métricas do Diagnóstico Voltado para o Usuário (UFD)

Métricas de perna do User Facing Diagnostics (UFD): (contagem de participantes (pernas) que tiveram pelo menos um UFD ruim durante uma chamada)

Fornece contagens de quantos participantes foram impactados por uma UFD em uma chamada.

  • confiabilidade/perna/UFD/NetworkReconnect
  • confiabilidade/perna/UFD/CameraStoppedUnexpectedly
  • confiabilidade/perna/UFD/microfoneMuteInesperadamente
  • confiabilidade/leg/UFD/NetworkReceiveQuality
  • confiabilidade/perna/UFD/MicrofonePermissão negada
  • confiabilidade/perna/UFD/microfoneNotFunctioning
  • confiabilidade/leg/UFD/NoMicrophoneDevicesEnumerated
  • confiabilidade/perna/UFD/CameraPermissionDenied
  • confiabilidade/perna/UFD/CameraStartFailed
  • confiabilidade/perna/UFD/CapturerStoppedUnexpectedly
  • confiabilidade/leg/UFD/CapturerStartFailed
  • confiabilidade/perna/UFD/CameraStartTimedOut
  • confiabilidade/leg/UFD/NoSpeakerDevicesEnumerated
  • confiabilidade/perna/UFD/CameraFreeze
  • confiabilidade/perna/UFD/NetworkRelaysNotReachable
  • confiabilidade/perna/UFD/SpeakingWhileMicrophoneIsMuted
  • confiabilidade/perna/UFD/NoNetwork
  • confiabilidade/perna/UFD/NetworkSendQuality
  • confiabilidade/leg/UFD/ScreenshareRecordingDisabled

Métricas de recuperação da API UFD (User Facing Diagnostics): (contagem de ocorrências que tiveram um problema, mas depois recuperadas durante uma chamada)

Fornece contagens de quantos UFDs foram acionados durante uma chamada pelo SDK de chamada, mas posteriormente recuperados durante a chamada. Por exemplo, se o NetworkReconnect UFD foi acionado uma vez em uma chamada, mas a rede se recuperou com êxito durante a chamada. Neste exemplo, a contagem de boa recuperação de API UFD é ≥ a contagem de métrica de perna UFD ruim. Você pode calcular uma taxa de recuperação de UFD de 100%.

  • confiabilidade/api/UFD/recovery/NetworkReceiveQuality
  • confiabilidade/api/UFD/recuperação/NetworkReconnect
  • confiabilidade/api/UFD/recovery/CameraStoppedUnexpectedly
  • confiabilidade/api/UFD/recovery/NetworkSendQuality
  • confiabilidade/api/UFD/recovery/MicrophoneMuteUnexpectedly
  • confiabilidade/api/UFD/recovery/MicrophoneNotFunctioning
  • confiabilidade/api/UFD/recovery/CapturerStoppedUnexpectedly
  • confiabilidade/api/UFD/recovery/CameraFreeze
  • confiabilidade/api/UFD/recuperação/CameraStartFailed
  • confiabilidade/api/UFD/recovery/NoMicrophoneDevicesEnumerated
  • confiabilidade/api/UFD/recovery/MicrophonePermissionDenied
  • confiabilidade/api/UFD/recuperação/CameraPermissionDenied
  • confiabilidade/api/UFD/recovery/NoSpeakerDevicesEnumerated
  • confiabilidade/api/UFD/recovery/CapturerStartFailed
  • confiabilidade/api/UFD/recovery/ScreenshareRecordingDisabled
  • confiabilidade/api/UFD/recovery/NoNetwork
  • confiabilidade/api/UFD/recuperação/CameraStartTimedOut
  • confiabilidade/api/UFD/recovery/SpeakingWhileMicrophoneIsMuted
  • confiabilidade/api/UFD/recovery/NetworkRelaysNotReachable

Definições de dados

Esquema de log de métricas de chamada

Esta tabela descreve cada propriedade.

Property Description
TimeGenerated O carimbo de data/hora (UTC) de quando o log foi gerado.
OperationName A operação associada ao registro de log.
OperationVersion A versão da API associada à operação. Ou a versão da operação, se não houver uma versão da API.
Category A categoria de log do evento. Os logs com a mesma categoria de log e tipo de recurso compartilham os mesmos campos de propriedades.
CorrelationId Um GUID exclusivo que correlaciona eventos na mesma dimensão.
TimestampMax O carimbo de data/hora máximo em UTC para cada dimensão.
TimestampBin O compartimento de carimbo de data/hora diário para cada dimensão.
MetricValueAvg O valor médio da métrica para cada dimensão.
Unit A unidade da métrica.
Goal O limiar definido para que uma perna tenha sucesso.
FailedLegsDcount O número de participantes reprovados (pernas) por dimensão.
SuccessLegsDcount A contagem de participantes bem-sucedidos (pernas) por dimensão.
CallsDcount O número total de chamadas por dimensão.
LegsDcount O número total de participantes (pernas) por dimensão.
SubCode Uma dimensão que indica o subcódigo.
CallType Uma dimensão que indica o tipo de chamada.
Platform A dimensão da plataforma (por exemplo, iOS, Android, Windows).
ResultType A dimensão do tipo de resultado (por exemplo, categoria de sucesso ou falha).
DeviceModel Uma dimensão que indica o modelo do dispositivo.
DeviceBrand Uma dimensão que indica a marca do dispositivo.
DeviceFamily Uma dimensão que indica a família de dispositivos.
DeviceOsVersionMajor Número da versão principal do sistema operacional do dispositivo.
DeviceOsVersionMinor Número da versão secundária do sistema operacional do dispositivo.
DeviceBrowserVersionMinor Número da versão secundária do navegador do dispositivo.
DeviceBrowserVersionMajor Número da versão principal do navegador do dispositivo.
DeviceOsName Nome do sistema operativo do dispositivo.
DeviceBrowser Nome do navegador do dispositivo.
SdkVersion A versão do SDK em execução no cliente.
MetricName O nome da métrica que está sendo medida.

Dados de exemplo para vários tipos de chamada

Registro de métricas de chamadas para P2P e chamadas em grupo

Para o log de métricas de chamada, não há diferença entre cenários P2P e de chamada em grupo. O código a seguir é um exemplo genérico mostrando o esquema desses logs.

Registo de métricas de chamadas

Aqui estão duas linhas de exemplo do log de métricas de chamada:

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

Perguntas mais frequentes

Como faço para armazenar logs?

A secção seguinte explica este requisito.

Os logs dos Serviços de Comunicação do Azure não são armazenados em sua conta do Azure por padrão, portanto, você precisa começar a armazená-los para que ferramentas como informações de voz e vídeo, painel e diagnóstico de chamadas funcionem. Para coletar esses logs de chamadas, você precisa habilitar uma configuração de diagnóstico que direcione os dados da chamada para um espaço de trabalho do Log Analytics.

Os dados não são armazenados retroativamente, portanto, você começa a capturar registros de chamadas somente depois de definir a configuração de diagnóstico.

Siga as instruções para adicionar configurações de diagnóstico para seu recurso em Habilitar logs por meio de Configurações de Diagnóstico no Azure Monitor. Recomendamos que você colete inicialmente todos os logs. Depois de entender os recursos do Azure Monitor, determine quais logs você deseja reter e por quanto tempo. Ao adicionar sua configuração de diagnóstico, você será solicitado a selecionar logs. Para coletar todos os logs, selecione allLogs.

O volume, a retenção e o uso de dados no Log Analytics no Azure Monitor são cobrados por meio de medidores de dados existentes do Azure. Recomendamos que você monitore suas políticas de retenção e uso de dados para considerações de custo, conforme necessário. Para obter mais informações, consulte Controlando custos.

Se você tiver várias IDs de recurso dos Serviços de Comunicação do Azure, deverá habilitar essas configurações para cada ID de recurso.

Próximos passos