Configurar o registro em log e o monitoramento de reuniões do SDK do Amazon Chime

O registro de log ajuda você a coletar informações, como eventos de reuniões do lado do servidor e logs do console do navegador do lado do cliente.

O Amazon Chime SDK fornece eventos de reunião do lado do servidor que você pode enviar para a Amazon e os registros de eventos da Amazon. EventBridge CloudWatch Você pode criar CloudWatch métricas e insights e usá-los em seu painel para monitoramento. A postagem do blog Logging and Monitoring of Amazon Chime SDK events no lado do servidor explica como habilitar as métricas, os insights e o CloudWatch painel.

O SDK do Amazon Chime fornece eventos do lado do cliente para problemas de qualidade de áudio e vídeo, largura de banda da rede e conectividade. A postagem no blog de eventos Monitoramento e solução de problemas com o Amazon Chime SDK Meeting explica como habilitar CloudWatch métricas, insights e painel para falhas de junção, problemas de qualidade de áudio e falhas na configuração do microfone e da câmera. Para obter informações adicionais sobre eventos de reunião, consulte Eventos de reunião no Github.

Opções para métricas de solução de problemas

Para coletar eventos de solução de problemas, você tem as opções a seguir.

• Envie métricas em todos os eventos

• Eventos em lote a cada N segundos

• Envie métricas no final da reunião

• Nível de registro de log para logs do console do navegador

Métricas recomendadas

No mínimo, você deve coletar e gerar log das seguintes métricas.

• Plataforma e versão do SDK

• Versão do navegador

• Sistema operacional

• Núcleos lógicos

• Reunião iniciada

• Reunião encerrada

• Participante ingressou

• Participante saiu

• Participantes caíram

Além disso, dependendo dos problemas que você enfrenta, as métricas a seguir podem fornecer informações sobre problemas de conectividade, largura de banda e qualidade. Você pode registrar todas as ocorrências dessas métricas ou apenas contá-las. A contagem pode fornecer uma visão resumida dos problemas subjacentes:

• connectionDidSuggestStopVideo

• connectionDidBecomeBom

• connectionDidBecomePobre

• Tempo de ingresso do participante > t segundos

• MeetingStartFailed

• MeetingFailed

Como habilitar o registro de log do lado do cliente

Você pode habilitar os registros de log do navegador no nível de INFO do navegador passando LogLevel.INFO para o objeto ConsoleLogger.

const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController); 

Você também pode usar o POSTLogger componente no SDK do Amazon Chime JavaScript para capturar logs do navegador em seu back-end, como o Amazon Logs. CloudWatch POSTLoggerfaz HTTP POST solicitações para carregar os registros do navegador para o URL fornecido no POSTLoggerconstrutor. Por exemplo, a demonstração sem servidor do Amazon Chime SDK GitHub usa o POSTLogger para enviar registros do navegador ao Amazon CloudWatch Logs para futuras investigações.

Como habilitar o registro de log do lado do servidor

O Amazon Chime SDK para JavaScript também chama o método eventDidReceive observador com os principais eventos de reunião, como e. MeetingStartFailed MeetingFailed Os eventos de reunião geralmente incluem motivos específicos para falhas. Por exemplo, digamos que um grande grupo de clientes tenha falhas. Seu aplicativo web pode coletar esses eventos de reunião e depois compartilhá-los conosco para solucionar a causa raiz. Para obter mais informações sobre eventos de reunião, consulte o guia de eventos da reunião e a postagem do blog sobre GitHub Monitoramento e solução de problemas com eventos de reunião do Amazon Chime SDK.