Compartir:
){kind=small}
Michael es el constructor calvo y barbudo. Aprovechando sus 20 años de experiencia en desarrollo de software y DevOps, este desarrollador con problemas de folclore pasa sus días centrado en ayudar a los demás a tener éxito.
Integre información avanzada para supervisar la calidad del Video
Tiempo de lectura: 6 minutos
Sanidad. Educación. Colaboración. Lo más probable es que te hayas estado comunicando a través de videoconferencias en línea con mucha más frecuencia. Los minutos utilizados por los clientes de la Video API de Vonage aumentaron un 232% sólo de febrero a marzo. En el sector de la salud, los minutos de Video aumentaron un 727%.
Con este aumento de la carga, es más importante que nunca saber qué tipo de calidad de servicio está proporcionando a sus clientes. ¿Los alumnos del Sr. Pates pueden ver y oír claramente sus clases? ¿Es capaz la Dra. Sánchez de proporcionar la calidad de atención que necesitan sus pacientes? Si experimentan problemas, querrá tener respuestas.
Por eso Vonage creó las API Insights y Advanced Insights. Estas API GraphQL te ayudan a crear soluciones escalables y confiables para tus usuarios finales, pero es importante saber qué datos se proporcionan, cuándo están disponibles y durante cuánto tiempo están accesibles.
La API Insights le permite explorar los metadatos de sus sesiones a nivel de proyecto. Estos metadatos incluyen métricas como:
Utilización: Información sobre los minutos publicados en streaming, los minutos suscritos en streaming, el uso de archivo, el uso de difusión y el uso de SIP.
Calidad: Información sobre la calidad del Video
Errores: Los porcentajes de fallos en la conexión a sesiones, la publicación y la suscripción.
Example GraphQL code used with the Insights API
La API permite filtrar y agrupar los datos por tipo de SDK, versión del SDK, país, región, navegador, versión del navegador y, además, segmentar los datos a intervalos diarios, semanales o mensuales.
Los datos de Insights se agregan diariamente a nivel de proyecto. Por ello, no están disponibles en tiempo real. Los datos de la API de Insights tienen una latencia de disponibilidad prevista de 36 a 48 horas.
Timeline displaying retention spans of the Insights API
Durante 60 días, los datos de Insights están disponibles en segmentos agregados diarios. Después, y durante un máximo de 12 meses, están disponibles en agregados mensuales. Transcurridos 12 meses, la API de Insights no conserva los datos.
La API Advanced Insights proporciona datos a nivel de sesión y de flujo. Las sesiones se dividen en reuniones y cada sesión puede constar de muchas reuniones. Se crea una nueva reunión cuando alguien se une a la sesión y ésta no ha tenido participantes durante los 10 minutos anteriores.
Los datos de la sesión incluyen:
Metadatos: Modo multimedia, actas publicadas y actas suscritas
Reuniones: Una matriz de todas las reuniones que se produjeron durante el marco temporal especificado para esta sesión. Incluye:
Conexiones: Una matriz de conexiones que define cada cliente que se unió a la sesión durante la reunión. Incluye SDK utilizado, navegador utilizado, información sobre editores/suscriptores y mucho más.
Metadatos: Actas publicadas, actas suscritas y fecha de creación y destrucción de la reunión.
Editores: Un conjunto de editores que estuvieron presentes durante la reunión. Incluye datos sobre sus flujos, abonados y estadísticas de flujos.
Abonados: Una matriz de suscriptores que estuvieron presentes durante la reunión. Incluye información sobre el flujo del suscriptor y las estadísticas del flujo.
Example GraphQL query for the Advanced Insights API
La potencia de Advanced Insights reside en las estadísticas in-stream. Estos datos incluyen instantáneas de 30 segundos de latencia de audio y vídeo, velocidad de bits, tasa de pérdida de paquetes y códecs. También incluye información sobre la resolución de vídeo y si un flujo incluía audio y/o vídeo en el momento de la instantánea.
Con esta información puede revisar toda la experiencia del usuario en términos de calidad de su flujo y comparar esos datos entre métricas como SDK, navegador, hora del día, etc. Con este nivel de conocimiento, puedes optimizar tus aplicaciones en todas las plataformas para garantizar que tus clientes tengan la mejor experiencia posible.
Los datos de Advanced Insights están disponibles durante 21 días. El período de retención se basa en la hora de creación de una reunión dentro de una sesión. Los datos tienen una latencia de disponibilidad prevista de 5 minutos desde el final de la reunión.
Timeline displaying retention spans of the Advanced Insights API
Es posible que no se pueda acceder a los datos de Advanced Insights durante los periodos de mantenimiento periódico de nuestra base de datos. Todos los datos se recuperarán poco después del periodo de mantenimiento 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 |
En muchos casos, querrá conservar el acceso a sus datos de Insights y Advanced Insights durante más tiempo del que establecen nuestras políticas de retención. Tanto si utiliza funciones sin servidor como tareas programadas, querrá consultar los puntos finales de la API a intervalos regulares para recuperar y cargar los datos en su base de datos. El almacenamiento de estos datos a largo plazo en la base de datos de su elección le ofrece la oportunidad de proporcionar sin problemas información a su equipo y/o clientes y comparar métricas en escalas de tiempo más amplias.
Recuerde que los datos de ambas API se agregan utilizando la hora del Pacífico, así que asegúrese de incluir cualquier diferencia de zona horaria cuando determine la hora del día a la que debe realizar sus consultas.
Dado que la API Insights se agrega diariamente, no debería consultarla más de una vez al día. Bastaría con consultar y almacenar estos datos cada día o incluso cada pocos días.
Los datos de Advanced Insights para una reunión están disponibles 5 minutos después de que la reunión haya finalizado. El momento adecuado para consultar estos datos depende de la necesidad de sus aplicaciones de disponer de datos casi en tiempo real. Asegúrese de tener en cuenta los periodos de mantenimiento de la base de datos de Advanced Insights especificados anteriormente.
Con los datos de Insights & Advanced Insights a su alcance, podrá identificar tendencias en plataformas de clientes, navegadores y capacitar a su equipo para identificar problemas de pérdida de paquetes, tasas de bits de usuarios y latencia en cuestión de minutos. Para obtener más información sobre las API Insights y Advanced Insights y cómo pueden ayudarle a tomar decisiones más informadas, consulte los siguientes enlaces: