Partilhar via

Esquema de log de séries cronológicas de estatísticas de mídia do cliente de chamadas

  • Artigo

O log de séries cronológicas de estatísticas de mídia do cliente de chamada fornece informações do lado do cliente sobre os fluxos de mídia entre participantes individuais envolvidos em uma chamada. Esses logs estão atualmente em visualização limitada e fornecem dados detalhados de séries cronológicas nos vapores de mídia de compartilhamento de áudio, vídeo e tela entre os participantes com um intervalo de agregação padrão de 10 segundos. Os logs contêm informações granulares de séries cronológicas sobre o tipo de fluxo de mídia, direção, codec e propriedades de taxa de bits (por exemplo, max, min, average).

Esse log fornece informações mais detalhadas do que o log de diagnóstico de chamadas para entender a qualidade dos vapores de mídia entre os participantes. Ele pode ser usado para visualizar e investigar problemas de qualidade para suas chamadas por meio de diagnósticos de chamada para seu Recurso de Serviços de Comunicação do Azure. Saiba mais sobre o diagnóstico de chamadas

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.

Definições de dados

Esquema de log de séries cronológicas de estatísticas de mídia do cliente de chamadas

Esta tabela descreve cada propriedade.

Property Description
OperationName A operação associada ao registro de log.
CallId O ID exclusivo de uma chamada. Ele identifica eventos correlacionados de todos os participantes e pontos de extremidade que se conectam durante uma única chamada, e você pode usá-lo para unir dados de logs diferentes. É semelhante ao correlationId no log de resumo de chamadas e no log de diagnóstico de chamadas.
CallClientTimeStamp O carimbo de data/hora quando as estatísticas de mídia são gravadas.
MetricName O nome das estatísticas da mídia, como Bitrate, JitterInMs, PacketsPerSecond, e assim por diante.
Count O número de pontos de dados amostrados em um determinado carimbo de data/hora.
Sum A soma dos valores métricos de todos os pontos de dados amostrados.
Average O valor métrico médio dos pontos de dados amostrados. Média = Soma/Contagem.
Minimum O mínimo de valores métricos de todos os pontos de dados amostrados.
Maximum O máximo de valores métricos de todos os pontos de dados amostrados.
MediaStreamDirection A direção do fluxo de mídia. Pode ser send ou receive.
MediaStreamType O tipo de fluxo de mídia. Pode ser video, audioou screen.
MediaStreamCodec O codec usado para codificar/decodificar o fluxo de mídia, como H264, OPUS, VP8e assim por diante.
ParticipantId O ID exclusivo gerado para representar cada ponto de extremidade na chamada.
ClientInstanceId A ID exclusiva que representa o objeto Call Client criado no SDK de chamada.
EndpointId A ID exclusiva que representa cada ponto de extremidade conectado à chamada. O EndpointId pode persistir para o mesmo usuário em várias chamadas (callIds) para clientes nativos, mas é exclusivo para cada chamada quando o cliente é um navegador da Web. O EndpointId não está atualmente instrumentado neste log. Quando implementado, ele corresponde aos valores nos logs CallSummary/Diagnostics
RemoteParticipantId A ID exclusiva que representa o ponto de extremidade remoto no fluxo de mídia. Por exemplo, um usuário pode renderizar vários fluxos de vídeo para os outros usuários na mesma chamada. Cada fluxo de vídeo tem um arquivo RemoteParticipantId.
RemoteEndpointId O mesmo que EndpointId, mas representa o usuário no lado remoto do fluxo.
MediaStreamId Um ID exclusivo que representa cada fluxo de mídia na chamada. MediaStreamId atualmente não é instrumentado em clientes. Quando implementado, ele corresponde à streamId coluna nos logs do CallDiagnostics.
AggregationIntervalSeconds O intervalo de tempo para agregar as estatísticas da mídia. Atualmente, no SDK de chamada, as métricas de mídia são amostradas a cada 1 segundo e, quando relatamos no log, agregamos todas as amostras a cada 10 segundos. Assim, cada linha desta tabela tem, no máximo, 10 pontos de amostragem.

Dados de exemplo para vários tipos de chamada

Registros de estatísticas de mídia do cliente de chamadas para P2P e chamadas em grupo

Para o log de séries cronológicas de estatísticas de mídia do cliente de chamada, não há diferença entre cenários P2P e de chamada em grupo. O número de logs depende das operações do SDK e da duração da chamada. O código a seguir é um exemplo genérico mostrando o esquema desses logs.

Registro de séries cronológicas de estatísticas de mídia do cliente de chamadas

Aqui está um exemplo de registro de séries cronológicas de estatísticas de mídia. Ele mostra a métrica de Jitter do participante para receber um fluxo de áudio em um carimbo de data/hora específico.

"properties": {
    "TenantId":                     "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":                "2024-01-10T07:36:51.771Z",
    "OperationName":                "CallClientMediaStatsTimeSeries" ,  
    "CallId":                       "92d800c4-abde-40be-91e9-3814ee786b19", 
    "CallClientTimeStamp":          "2024-01-09T15:07:56.066Z",
    "MetricName":                   "JitterInMs",
    "Count":                        "2",
    "Sum":                          "34",
    "Average":                      "17",
    "Minimum":                      "10",
    "Maximum":                      "25",
    "MediaStreamDirection":         "recv",
    "MediaStreamType":              "audio",
    "MediaStreamCodec":             "OPUS",
    "ParticipantId":                "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
     "ClientInstanceId":            "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "AggregationIntervalSeconds":   "10",
    "Type":                         "ACSCallClientMediaStatsTimeSeries"
}

Cada participante pode ter muitas métricas de estatísticas de mídia diferentes para uma chamada. A consulta a seguir pode ser executada no Log Analytics no portal do Azure para mostrar todas as métricas possíveis nesse log:

ACSCallClientMediaStatsTimeSeries | distinct MetricName

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