Consultar logs de chamadas

  • Artigo

Visão geral e acesso

Para aproveitar o Log Analytics em seus logs dos Serviços de Comunicação, primeiro siga as etapas descritas em Habilitar registro em log nas Configurações de Diagnóstico. Depois de habilitar os logs e um Workspace do Log Analytics, você terá acesso a vários pacotes de consulta padrão úteis para visualizar e entender rapidamente os dados disponíveis nos logs, que estão descritos abaixo. Por meio do Log Analytics, você também obtém acesso a mais Insights dos Serviços de Comunicação por meio das Pastas de Trabalho do Azure Monitor, a capacidade de criar nossas próprias consultas e pastas de trabalho e a visão geral das APIs do Log Analytics para qualquer consulta.

Access

Você pode acessar as consultas começando na página do recurso dos Serviços de Comunicação e clicando em "Logs" no painel de navegação à esquerda dentro da seção Monitor:

Navegação no Log Analytics

A partir daí, você receberá uma tela modal que contém todos os pacotes de consulta padrão disponíveis para seus Serviços de Comunicação, com a lista de Pacotes de Consultas disponíveis para navegação à esquerda.

Tela restrita de consultas do Log Analytics

Se você fechar a tela modal, ainda poderá navegar para os vários pacotes de consulta, acessar diretamente os dados na forma de tabelas com base no esquema dos logs e métricas que você ativou na Configuração de diagnóstico. Aqui, você pode criar suas consultas usando os dados com KQL (Kusto). Saiba mais sobre como usar, editar e criar consultas em: Consultas do Log Analytics

Consultas do Log Analytics no recurso

Tabelas do Log Analytics no recurso

Pacotes de consulta padrão para logs de resumo da chamada e de diagnóstico de chamada

Veja a seguir as descrições de cada consulta no pacote de consultas padrão, para os Logs de resumo de chamada e de diagnóstico de chamada, incluindo exemplos de código e saídas de exemplo para cada consulta disponível:

Consultas de visão geral da chamada

Número de participantes por chamada

// Count number of calls and participants,
// and print average participants per call
ACSCallSummary
| distinct CorrelationId, ParticipantId, EndpointId
| summarize num_participants=count(), num_calls=dcount(CorrelationId)
| extend avg_participants = todecimal(num_participants) / todecimal(num_calls)

Saída de exemplo:

consulta de visão geral da chamada

Número de participantes por chamada de grupo

// Count number of participants per group call
ACSCallSummary
| where CallType == 'Group'
| distinct CorrelationId, ParticipantId
| summarize num_participants=count() by CorrelationId
| summarize participant_counts=count() by num_participants
| order by num_participants asc 
| render columnchart with  (xcolumn = num_participants, title="Number of participants per group call")

Saída de exemplo:

consulta de participantes por chamada de grupo

Taxa de tipos de chamada

// Ratio of call types
ACSCallSummary
| summarize call_types=dcount(CorrelationId) by CallType
| render piechart title="Call Type Ratio"

Saída de exemplo:

consulta de taxa de tipo de chamada

Distribuição da duração da chamada

// Call duration histogram
ACSCallSummary
| distinct CorrelationId, CallDuration
|summarize duration_counts=count() by CallDuration
| order by CallDuration asc
| render columnchart with (xcolumn = CallDuration, title="Call duration histogram")

Saída de exemplo:

consulta de duração da chamada

Percentual de duração da chamada

// Call duration percentiles
ACSCallSummary
| distinct CorrelationId, CallDuration
| summarize avg(CallDuration), percentiles(CallDuration, 50, 90, 99)

Saída de exemplo:

consulta de percentil de duração da chamada

Consultas de informações de ponto de extremidade

Número de pontos de extremidade por chamada

// Count number of calls and endpoints,
// and print average endpoints per call
ACSCallSummary
| distinct CorrelationId, EndpointId
| summarize num_endpoints=count(), num_calls=dcount(CorrelationId)
| extend avg_endpoints = todecimal(num_endpoints) / todecimal(num_calls)

Saída de exemplo:

consulta de pontos de extremidade por chamada

Taxa de versões do SDK

// Ratio of SDK Versions
ACSCallSummary
| distinct CorrelationId, ParticipantId, EndpointId, SdkVersion
| summarize sdk_counts=count() by SdkVersion
| order by SdkVersion asc
| render piechart title="SDK Version Ratio"

Saída de exemplo:

Gráfico de pizza mostrando a taxa de versões do SDK.Tabela mostrando as versões do SDK

Taxa de versões do sistema operacional (nome do SO simplificado)

// Ratio of OS Versions (simplified OS name)
ACSCallSummary
| distinct CorrelationId, ParticipantId, EndpointId, OsVersion
| extend simple_os = case(  indexof(OsVersion, "Android") != -1, tostring(split(OsVersion, ";")[0]),
                            indexof(OsVersion, "Darwin") != -1, tostring(split(OsVersion, ":")[0]),
                            indexof(OsVersion, "Windows") != -1, tostring(split(OsVersion, ".")[0]),
                            OsVersion
                        )
| summarize os_counts=count() by simple_os
| order by simple_os asc
| render piechart title="OS Version Ratio"

Saída de exemplo:

Gráfico de pizza mostrando as taxas do sistema operacionalTabela mostrando as versões do sistema operacional

Consultas de fluxo de mídia

Fluxos por chamada

// Count number of calls and streams,
// and print average streams per call
ACSCallDiagnostics
| summarize num_streams=count(), num_calls=dcount(CorrelationId)
| extend avg_streams = todecimal(num_streams) / todecimal(num_calls)

Saída de exemplo:

consulta de fluxos por chamada

Fluxos por histograma de chamada

// Distribution of streams per call
ACSCallDiagnostics
| summarize streams_per_call=count() by CorrelationId
| summarize stream_counts=count() by streams_per_call
| order by streams_per_call asc
| render columnchart title="Streams per call histogram"

fluxos por histograma de chamada

Taxa de tipos de mídia

// Ratio of media types by call
ACSCallDiagnostics
| summarize media_types=count() by MediaType
| render piechart title="Media Type Ratio"

gráfico de pizza mostrando as taxas de tipo de mídia

Consultas de métricas de qualidade

Valores médios de telemetria

// Average telemetry values over all streams
ACSCallDiagnostics
| summarize Avg_JitterAvg=avg(JitterAvg),
            Avg_JitterMax=avg(JitterMax),
            Avg_RoundTripTimeAvg=avg(RoundTripTimeAvg),
            Avg_RoundTripTimeMax=avg(RoundTripTimeMax),
            Avg_PacketLossRateAvg=avg(PacketLossRateAvg),
            Avg_PacketLossRateMax=avg(PacketLossRateMax)

valores médios de telemetria

Histograma JitterAvg

// Jitter Average Histogram
ACSCallDiagnostics
| where isnotnull(JitterAvg)
| summarize JitterAvg_counts=count() by JitterAvg
| order by JitterAvg asc
| render columnchart with (xcolumn = JitterAvg, title="JitterAvg histogram")

Histograma de tremulação média

Histograma JitterMax

// Jitter Max Histogram
ACSCallDiagnostics
| where isnotnull(JitterMax)
|summarize JitterMax_counts=count() by JitterMax
| order by JitterMax asc
| render columnchart with (xcolumn = JitterMax, title="JitterMax histogram")

histograma de tremulação máxima

Histograma PacketLossRateAvg

// PacketLossRate Average Histogram
ACSCallDiagnostics
| where isnotnull(PacketLossRateAvg)
|summarize PacketLossRateAvg_counts=count() by bin(PacketLossRateAvg, 0.01)
| order by PacketLossRateAvg asc
| render columnchart with (xcolumn = PacketLossRateAvg, title="PacketLossRateAvg histogram")

histograma de perda média de pacotes

Histograma PacketLossRateMax

// PacketLossRate Max Histogram
ACSCallDiagnostics
| where isnotnull(PacketLossRateMax)
|summarize PacketLossRateMax_counts=count() by bin(PacketLossRateMax, 0.01)
| order by PacketLossRateMax asc
| render columnchart with (xcolumn = PacketLossRateMax, title="PacketLossRateMax histogram")

histograma de perda máxima de pacotes

Histograma RoundTripTimeAvg

// RoundTripTime Average Histogram
ACSCallDiagnostics
| where isnotnull(RoundTripTimeAvg)
|summarize RoundTripTimeAvg_counts=count() by RoundTripTimeAvg
| order by RoundTripTimeAvg asc
| render columnchart with (xcolumn = RoundTripTimeAvg, title="RoundTripTimeAvg histogram")

Histograma de média de RTT

Histograma RoundTripTimeMax

// RoundTripTime Max Histogram
ACSCallDiagnostics
| where isnotnull(RoundTripTimeMax)
|summarize RoundTripTimeMax_counts=count() by RoundTripTimeMax
| order by RoundTripTimeMax asc
| render columnchart with (xcolumn = RoundTripTimeMax, title="RoundTripTimeMax histogram")

Histograma de RTT máximo

Qualidade de tremulação ruim

// Get proportion of calls with poor quality jitter
// (defined as jitter being higher than 30ms)
ACSCallDiagnostics
| extend JitterQuality = iff(JitterAvg > 30, "Poor", "Good")
| summarize count() by JitterQuality
| render piechart title="Jitter Quality"

qualidade de tremulação

Qualidade de PacketLossRate

// Get proportion of calls with poor quality packet loss
// rate (defined as packet loss being higher than 10%)
ACSCallDiagnostics
| extend PacketLossRateQuality = iff(PacketLossRateAvg > 0.1, "Poor", "Good")
| summarize count() by PacketLossRateQuality
| render piechart title="Packet Loss Rate Quality"

qualidade da taxa de perda de pacotes

Qualidade de RoundTripTime

// Get proportion of calls with poor quality packet loss
// rate (defined as packet loss being higher than 10%)
ACSCallDiagnostics
| extend PacketLossRateQuality = iff(PacketLossRateAvg > 0.1, "Poor", "Good")
| summarize count() by PacketLossRateQuality
| render piechart title="Packet Loss Rate Quality"

Qualidade de RTT

Consultas parametrizadas

Chamadas diárias na última semana

// Histogram of daily calls over the last week
ACSCallSummary
| where CallStartTime > now() - 7d
| distinct CorrelationId, CallStartTime
| extend hour  = floor(CallStartTime, 1d)
| summarize event_count=count() by day
| sort by day asc
| render columnchart title="Number of calls in last week"

chamadas diárias na última semana

Chamadas por hora no último dia

// Histogram of calls per hour in the last day
ACSCallSummary
| where CallStartTime > now() - 1d
| distinct CorrelationId, CallStartTime
| extend hour = floor(CallStartTime, 1h)
| summarize event_count=count() by hour
| sort by hour asc
| render columnchart title="Number of calls per hour in last day"

chamadas por hora no último dia