Compartilhar:
){kind=small}
Michael é o construtor careca e barbudo. Com seus 20 anos de experiência em desenvolvimento de software e DevOps, esse desenvolvedor com pouco cabelo dedica seus dias a ajudar os outros a terem sucesso.
Integre análises avançadas para monitorar a qualidade do Video
Tempo de leitura: 6 minutos
Saúde. Educação. Colaboração. É provável que você tenha passado a se comunicar por meio de videoconferências com muito mais frequência. Os minutos utilizados pelos clientes da Video API da Vonage aumentaram 232% somente de fevereiro a março. No setor de saúde, os minutos de vídeo aumentaram 727%.
Com esse aumento na carga de trabalho, é mais importante do que nunca saber que tipo de qualidade de serviço você está oferecendo aos seus clientes. Os alunos do Sr. Pates conseguem ver e ouvir claramente suas aulas? A Dra. Sanchez consegue oferecer a qualidade de atendimento de que seus pacientes precisam? Se eles enfrentarem problemas, você vai querer ter respostas.
É por isso que a Vonage criou as APIs Insights e Advanced Insights. Essas APIs GraphQL ajudam você a criar soluções escaláveis e confiáveis para seus usuários finais, mas é importante saber quais dados são fornecidos, quando estão disponíveis e por quanto tempo permanecem acessíveis.
A API do Insights permite que você explore os metadados das suas sessões no nível do projeto. Esses metadados incluem métricas como:
Uso: Informações sobre minutos de transmissão publicados, minutos de transmissão assinados, uso do arquivo, uso de transmissão e uso de SIP
Qualidade: Informações sobre a qualidade do Video
Erros: As taxas de falha na conexão com sessões, na publicação e na assinatura
Example GraphQL code used with the Insights API
A API permite filtrar e agrupar os dados por tipo de SDK, versão do SDK, país, região, navegador e versão do navegador; além disso, permite segmentar os dados em intervalos diários, semanais ou mensais.
Os dados do Insights são agregados diariamente no nível do projeto. Por esse motivo, não estão disponíveis em tempo real. Os dados da API do Insights têm uma latência de disponibilidade prevista de 36 a 48 horas.
Timeline displaying retention spans of the Insights API
Por 60 dias, os dados do Insights ficam disponíveis em segmentos agregados diariamente. Após esse período, e por até 12 meses, eles ficam disponíveis em agregados mensais. Após 12 meses, os dados não são mais mantidos pela API do Insights.
A API do Advanced Insights fornece dados no nível da sessão e do fluxo. As sessões são divididas em reuniões, e cada sessão pode consistir em várias reuniões. Uma nova reunião é criada quando alguém entra na sessão e esta não tiver tido participantes nos últimos 10 minutos.
Os dados da sessão incluem:
Metadados: Modo de mídia, minutos publicados e minutos assinados
Reuniões: Uma lista de todas as reuniões que ocorreram durante o período especificado para esta sessão. Ela inclui:
Conexões: Uma matriz de conexões que define cada cliente que se conectou à sessão durante a reunião. Ela inclui o SDK utilizado, o navegador utilizado, informações sobre emissores/assinantes e muito mais
Metadados: Atas publicadas, atas assinadas e as datas de criação e exclusão da reunião
Editores: Uma lista de editores que estiveram presentes durante a reunião. Ela inclui dados sobre suas transmissões, inscritos e estatísticas de transmissão
Assinantes: Uma lista dos assinantes que estavam presentes durante a reunião. Ela inclui informações sobre o stream do assinante e as estatísticas do stream
Example GraphQL query for the Advanced Insights API
O poder do Advanced Insights reside nas estatísticas em tempo real. Esses dados incluem instantâneos de 30 segundos da latência de áudio e vídeo, taxa de bits, taxa de perda de pacotes e codecs. Também incluem informações sobre a resolução do Video e se uma transmissão continha áudio e/ou Video no momento do instantâneo.
Com essas informações, você pode analisar toda a experiência do usuário em termos da qualidade da transmissão e comparar esses dados com base em métricas como SDK, navegador, horário do dia e muito mais. Com esse nível de análise, você pode otimizar suas Applications em todas as plataformas para garantir que seus clientes tenham a melhor experiência possível.
Os dados do Advanced Insights ficam disponíveis por 21 dias. O período de retenção é baseado na hora de criação de uma reunião dentro de uma sessão. Os dados têm uma latência de disponibilidade prevista de 5 minutos a partir do término da reunião.
Timeline displaying retention spans of the Advanced Insights API
Durante nossos intervalos regulares de manutenção do banco de dados, os dados do Advanced Insights podem ficar indisponíveis. Todos os dados serão repostos logo após o período de manutenção especificado.
| Day | Time | Data Available By | |
|---|---|---|---|
| Daily database maintenance | Monday - Sunday | 9pm - 11pm PT | 11:30pm PT |
| Weekly database maintenance | Sunday | 4am - 7am PT | 8am PT |
Em muitos casos, você vai querer manter o acesso aos seus dados do Insights e do Advanced Insights por um período mais longo do que o previsto em nossas políticas de retenção. Seja usando funções sem servidor ou tarefas agendadas, é recomendável consultar os endpoints da API em intervalos regulares para recuperar e carregar os dados em seu banco de dados. Armazenar esses dados a longo prazo no banco de dados de sua escolha oferece a oportunidade de fornecer insights de forma integrada à sua equipe e/ou aos seus clientes e comparar métricas em intervalos de tempo mais longos.
Lembre-se de que os dados em ambas as APIs são agregados com base no horário do Pacífico; portanto, certifique-se de incluir eventuais diferenças de fuso horário ao determinar a hora do dia para executar suas consultas.
Como a API do Insights é atualizada diariamente, você não deve consultá-la mais de uma vez por dia. Consultar e armazenar esses dados diariamente ou mesmo a cada poucos dias já seria suficiente.
Os dados do Advanced Insights relativos a uma reunião ficam disponíveis 5 minutos após o término da reunião. O momento adequado para consultar esses dados depende da necessidade de suas Applications em relação a dados quase em tempo real. Certifique-se de levar em conta os períodos de manutenção do banco de dados do Advanced Insights especificados acima.
Com os dados do Insights e do Advanced Insights ao seu alcance, você poderá identificar tendências nas plataformas e nos navegadores dos clientes, além de capacitar sua equipe a identificar problemas relacionados à perda de pacotes, taxas de bits dos usuários e latência em questão de minutos. Para saber mais sobre as APIs do Insights e do Advanced Insights e como elas podem ajudá-lo a tomar decisões mais bem informadas, confira os links abaixo: