Compartilhar via

Pesquisa de final de chamada

  • Artigo

Observação

No momento, o Inquérito de Fim de Chamada tem suporte somente no nosso SDK do JavaScript / Web .

Como usar os logs de chamada

Recomendamos que você colete todos os logs de chamada disponíveis em um recurso de análise de logs para 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 liberamos.

Há duas ferramentas principais que você pode usar para monitorar suas chamadas e melhorar a qualidade da chamada.

É recomendável usar o Painel de insights de voz e vídeo para iniciar as investigações de qualidade e usar o Diagnóstico de chamadas conforme necessário para explorar chamadas individuais quando precisar de detalhes granulares.

Pré-requisitos

Os Serviços de Comunicação do Azure fornecem recursos de monitoramento e análise por meio da Visão geral de Logs do Azure Monitor e Métricas do Azure Monitor. Cada recurso do Azure requer sua própria configuração de diagnóstico, o que define os seguintes critérios:

  • As categorias de logs e os dados de métrica enviados aos destinos definidos na configuração. As categorias disponíveis variam para diferentes tipos de recursos.
  • Um ou mais destinos para enviar os logs. Os destinos atuais incluem o workspace do Log Analytics, os Hubs de Eventos e o Armazenamento do Microsoft Azure.
  • Uma única configuração de diagnóstico pode definir apenas um de cada um dos destinos. Se você quiser enviar dados para mais de um tipo de destino específico (por exemplo, dois workspaces do Log Analytics diferentes), crie várias configurações. Cada recurso pode ter até cinco configurações de diagnóstico.

Importante

Você deve habilitar uma Configuração de Diagnóstico no Azure Monitor para enviar os dados de log de suas pesquisas para um workspace do Log Analytics, Hubs de Eventos ou uma conta de armazenamento do Azure para receber e analisar os dados da pesquisa. Caso não envie dados da pesquisa para uma dessas opções, os dados da pesquisa não serão armazenados e serão perdidos. A seguir estão instruções para configurar seu recurso Azure Monitor para começar a criar logs e métricas para seus Serviços de Comunicação. Para ver a documentação detalhada sobre como usar Configurações de Diagnóstico em todos os recursos do Azure, consulte Habilitar o registro em log em Configurações de Diagnóstico

Observação

No nome da configuração de diagnóstico, selecione “Pesquisa de chamadas” para habilitar os registros para pesquisa de fim de chamada.

Captura de tela das configurações de diagnóstico para pesquisa de chamadas.

Visão geral

A implementação de registros de pesquisa de fim de chamada representa uma funcionalidade ampliada dentro dos Serviços de Comunicação do Azure (Azure Communication Services), permitindo que a Contoso envie pesquisas para coletar feedback subjetivo dos clientes sobre sua experiência de chamada. Essa abordagem visa complementar a avaliação da qualidade das chamadas além de métricas objetivas, como taxa de bits de áudio e vídeo, jitter e latência, que podem não capturar totalmente se um cliente teve uma experiência satisfatória ou insatisfatória. Ao aproveitar os logs do Azure para publicar e examinar dados de pesquisa, a Contoso obtém insights para análise e identificação de áreas que precisam de melhorias. Os resultados desta pesquisa servem como um recurso valioso para que os Serviços de Comunicação do Azure monitorem e aprimorem continuamente a qualidade e a confiabilidade. Para mais detalhes sobre Pesquisa de fim de chamada

A Pesquisa de Fim de Chamada é uma ferramenta valiosa que permite coletar insights sobre como os usuários finais percebem a qualidade e a confiabilidade da sua solução de chamada JavaScript/Web SDK. Os logs que acompanham contêm dados cruciais que ajudam a avaliar a experiência dos usuários finais, incluindo:

Chamada geral: as respostas indicam como um participante da chamada percebeu a qualidade geral da chamada.

  • Áudio: As respostas indicam se o usuário percebeu algum problema de áudio.
  • Vídeo: as respostas indicam se o usuário percebeu algum problema com o vídeo.
  • Compartilhamento de tela: as respostas indicam se o usuário percebeu algum problema de compartilhamento de tela. Além do acima, as marcas opcionais nas respostas oferecem mais insights sobre tipos específicos de problemas relacionados a áudio, vídeo ou compartilhamento de tela.

Ao analisar os dados capturados nos registros da Pesquisa de Fim de Chamada, você pode identificar áreas que precisam de melhorias, melhorando assim a experiência geral do usuário.

Categorias de log de recursos

Os Serviços de Comunicação seguintes tipos de logs que você pode habilitar:

  • Registros da pesquisa de fim de chamada - fornece informações básicas relacionadas à pesquisa no final da chamada

Propriedades

Essa tabela descreve cada propriedade.

Propriedade Descrição
Timegenerated Esse campo representa o registro de data e hora (UTC) de quando o log foi gerado
CorrelationId O ID para eventos correlacionados pode ser usado para identificar eventos correlacionados entre várias tabelas
Category A categoria de log do evento. Logs com a mesma categoria de log e tipo de recurso terão os mesmos campos de propriedades
ResourceId O identificador completo do recurso do usuário
OperationName A operação associada ao registro de log
OperationVersion A versão da API está associada à operação ou versão da operação se o operationName foi executado usando uma API
CallId O identificador da chamada usada para correlacionar. Pode ser usado para identificar eventos correlacionados entre várias tabelas
ParticipantId A identificação do participante
SurveyId O identificador de uma pesquisa enviada por um participante. Pode ser usado para identificar eventos correlacionados entre várias tabelas
OverallCallIssues Esse campo indica qualquer problema relacionado à chamada geral e seus valores são uma lista de descrições separadas por vírgulas.
AudioIssues Esse campo indica qualquer problema relacionado à experiência de áudio e seus valores são uma lista de descrições separadas por vírgulas
VideoIssues Esse campo indica qualquer problema relacionado à experiência do vídeo e seus valores são uma lista de descrições separadas por vírgulas
ScreenshareIssues Esse campo indica qualquer problema relacionado à experiência de compartilhamento de tela e seus valores são uma lista de descrições separadas por vírgulas
OverallRatingScore Esse campo representa a experiência geral da chamada avaliada pelo participante
OverallRatingScoreLowerBound Esse campo representa o valor mínimo da escala OverallRatingScore
OverallRatingScoreUpperBound Esse campo representa o valor máximo da escala OverallRatingScore
OverallRatingScoreThreshold Esse campo indica o valor acima do qual o OverallRatingScore indica melhor qualidade
AudioRatingScore Esse campo representa a experiência de áudio avaliada pelo participante
AudioRatingScoreLowerBound Esse campo representa o valor mínimo da escala AudioRatingScore
AudioRatingScoreUpperBound Esse campo representa o valor máximo da escala AudioRatingScore
AudioRatingScoreThreshold Esse campo indica o valor acima do qual o AudioRatingScore indica melhor qualidade
VideoRatingScore Esse campo representa a experiência de vídeo avaliada pelo participante
VideoRatingScoreLowerBound Esse campo representa o valor mínimo da escala VideoRatingScore
VideoRatingScoreUpperBound Esse campo representa o valor máximo da escala VideoRatingScore
VideoRatingScoreThreshold Esse campo indica o valor acima do qual o VideoRatingScore indica melhor qualidade
ScreenshareRatingScore Esse campo representa a experiência de compartilhamento de tela avaliada pelo participante
ScreenshareLowerBound Esse campo representa o valor mínimo da escala ScreenshareRatingScore
ScreenshareUpperBound Esse campo representa o valor máximo da escala ScreenshareRatingScore
ScreenshareRatingThreshold Esse campo indica o valor acima do qual o ScreenshareRatingScore indica melhor qualidade

Exemplos de logs

Exemplo para a chamada geral

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-b924-4885-96a4-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "OverallCallIssues":"CallCannotJoin",
        "OverallRatingScore":7,
        "OverallRatingScoreLowerBound":0,
        "OverallRatingScoreUpperBound":10,
        "OverallRatingScoreThreshold":5        
    }

}
]

Exemplo para a qualidade de áudio

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-xxxx-4885-96a4-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "AudioIssues":"NoRemoteAudio",      
        "AudioRatingScore":6,
        "AudioRatingScoreLowerBound":0,
        "AudioRatingScoreUpperBound":10,
        "AudioRatingScoreThreshold":4        	
    }
]

Exemplo de qualidade de vídeo

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc87f7f-ce69-eeed-7777-b036051faea4",
        "SurveyId":"a6dd61c4-zzzz-4885-tttt-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "VideoIssues":"NoVideoReceived",
        "VideoRatingScore":9,
        "VideoRatingScoreLowerBound":0,
        "VideoRatingScoreUpperBound":10,
        "VideoRatingScoreThreshold":7
    }
}
]

Exemplo para compartilhamento de tela

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"1237f7f-ce69-ffff-b73f-b036051f6666",
        "SurveyId":"a6dd6bbb-b924-zzzz-96a4-a991d4c01000",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "ScreenshareIssues":"StoppedUnexpectedly,CannotPresent",
        "ScreenshareRatingScore":2,
        "ScreenshareRatingScoreLowerBound":0,
        "ScreenshareRatingScoreUpperBound":10,
        "ScreenshareRatingScoreThreshold":3
    }
}
]

Perguntas frequentes

Como armazenar logs?

A seção a seguir explica esse 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 as ferramentas como painel de insights de voz e vídeo e o diagnóstico de chamadas funcionem. Para coletar esses logs de chamadas, habilite uma configuração de diagnóstico que direcione os dados de chamada para um workspace do Log Analytics.

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

Siga as instruções para adicionar configurações de diagnóstico ao seu recurso em Habilitar logs via Configurações de Diagnóstico no Azure Monitor. Recomendamos que você inicialmente colete todos os logs. Depois de entender as funcionalidades no Azure Monitor, determine quais logs você deseja manter 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 a utilização de dados no Log Analytics no Azure Monitor são cobrados por meio de medidores de dados existentes do Azure. Recomendamos que você monitore o uso de dados e as políticas de retenção em relação às considerações de custo, conforme necessário. Para obter mais informações, confira Como controlar os 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óximas etapas