Visión general del inspector

El inspector de sesiones es una herramienta que ayuda a comprender lo que sucedió en un video específico de Vonage. sesiones. Los usuarios pueden introducir un ID de sesión o utilizar el panel de control de sesiones para acceder a la siguiente información sobre una sesión:

• Estadísticas generales
• Datos del usuario
• Errores
• Calidad de vídeo y audio
• Eventos

Session Inspector se utiliza principalmente para depuración de sesiones problemáticas que se hayan producido en tu solicitud.

Debes iniciar sesión en tu cuenta de Vonage Video API para acceder al inspector, y sólo podrás ver las sesiones creadas desde los ID de aplicaciones asociados con tu cuenta.

Búsqueda de sesiones

Antes de profundizar en la información detallada de una sesión, primero debes localizarla. La mejor forma de hacerlo es registrar el ID de cada sesión creada en tu aplicación para facilitar la depuración.

Sin embargo, si no conoces el ID de la sesión, puedes utilizar el Panel de control de la sesión para ver las sesiones activas recientemente, así como las sesiones inspeccionadas recientemente.

Guía del inspector

Tras seleccionar o buscar una sesión única, accederá a la vista de sesión del Inspector, donde podrá ver los datos de esa sesión.

En la parte superior del Inspector, seleccione la zona horaria en la que desea mostrar los datos de la sesión. El selector de zona horaria está etiquetado como "Hora mostrada en", a la derecha del banner del Inspector en la parte superior de la página.

La vista de la sesión se divide en varias secciones, que se describen a continuación:

Resumen y estadísticas

En la parte superior de la vista se encuentran las secciones «Resumen» y «Estadísticas». Estas secciones ofrecen una visión general de lo que ha ocurrido en una sesión.

Estos datos pueden ser útiles para comprender rápidamente la topología, la longitud y la diversidad de la sesión.

También es útil para verificar que estás viendo la sesión correcta cuando depuras.

En algunos casos, es posible que quieras profundizar en aspectos específicos reuniones dentro de una sesión más amplia; para ello, haga clic en el selector de reuniones de la esquina superior derecha y seleccione el segmento de la reunión que le interese ver.

En los casos en que una sesión incluye muchas reuniones distintas, esto puede ayudar a simplificar la vista para facilitar la depuración.

El panel de Estadísticas de Reuniones incluye la siguiente información:

• El tipo de llamada. Puede ser multipartita, uno a uno, uno a cero o de difusión.
• Número de usuarios individuales, conexiones, secuencias publicadas y abonados a las secuencias de la reunión. Si hay Usuarios SIP Además de los datos relativos a la reunión, también se indica el número de usuarios de SIP.
• El número total de minutos retransmitidos en la reunión.
• Número de incidencias en la reunión.
• La cantidad de diferentes SDK de Vonage Video utilizados en la reunión. Pasa el mouse sobre la entrada SDK para ver una lista de los diferentes SDK y la cantidad de usuarios de cada uno.
• El número de puntos de conexión diferentes utilizados en la reunión. Un punto de conexión puede ser una versión de navegador (como Chrome 98) para los clientes que utilizan OpenTok.js; un SDK de Vonage Video o SIP. Pasa el cursor por encima de la entrada «puntos de conexión» para ver una lista de los diferentes puntos de conexión y el número de usuarios de cada uno.

Datos del usuario

Al depurar una sesión problemática, suele ser útil entender "quién es quién" en Inspector.

Por ejemplo, uno de los participantes en la sesión puede haber experimentado problemas de conectividad, por lo que usted querría ver los datos sobre ese usuario específico en Inspector para comprender mejor por qué puede haberse producido el problema.

Para facilitar esta identificación, el módulo Datos de usuario proporciona información de alto nivel sobre cada usuario, como su ubicación, dispositivo, SDK y el número de errores que ha experimentado.

Puedes hacer clic en un usuario para ver más información sobre él, incluidos detalles sobre su conexiones y arroyos que publicaron. Este punto de vista es especialmente útil para comprender que se han suscrito con éxito a un flujo determinado, que puede ver en la columna de la derecha de la lista de flujos.

Haz clic en el Ver más detalles Enlace situado a la derecha de la lista para ver más información sobre las transmisiones y las conexiones del usuario. Para cada conexión, esto incluye lo siguiente:

• Hora y duración de la conexión
• Tipo de transporte de la conexión
• Si la conexión utiliza el Direcciones IP permitidas función
• El sistema, ya sea un navegador (como Chrome) o un Video API native client SDK
• El agente de usuario (para un cliente basado en web)

Para cada flujo, los detalles adicionales incluyen lo siguiente:

• Hora y duración del flujo
• El origen del vídeo de la retransmisión (por ejemplo, «cámara» o «pantalla compartida»)
• Si el flujo utiliza vídeo escalable función
• El sistema, ya sea un navegador (como Chrome) o un Video API native client SDK
• El agente de usuario (para un cliente basado en web)

La tabla Usuarios muestra un GUID (identificador único global) único para cada usuario. Este GUID se reutiliza para identificar al mismo usuario en múltiples conexiones a una sesión. Por ejemplo, si un usuario del Client SDK se reconecta a una sesión en múltiples sesiones de navegador, Inspector lista las conexiones separadas bajo el mismo listado de usuario en la tabla Usuarios. Utilice el ID de conexión para identificar la conexión del cliente a la sesión. (Puede utilizar los SDK de cliente para obtener el ID de conexión de un usuario).

Los clientes SIP se identifican como "SIP" en la tabla (por ejemplo, SIP1 y SIP2). Haga clic en la flecha de expansión ( > ) a la izquierda del cliente SIP de la lista para ver detalles adicionales. Y haga clic en el icono Ver más detalles Enlace para ver el ID de la llamada SIP, el ID de la conferencia, el URI SIP y más.

Para saber más sobre cómo se conectan, publican y suscriben los clientes, consulte Conceptos básicos de la Video API.

Registro de errores

Si se ha producido algún error en la sesión, se mostrará en la sección Registro de errores.

En esta sección también se muestra la tasa de fallos de los intentos de conexión, publicación y suscripción realizados durante la sesión o la reunión.

Este porcentaje se calcula dividiendo el número de fallos por el número total de intentos.

Métricas de calidad

El módulo de métricas de calidad es útil para comprender tasa de bits, pérdida de paquetesy latencia a lo largo del tiempo para cada usuario. Aunque estas estadísticas no pueden determinar directamente la calidad subjetiva que experimentan los usuarios de tu aplicación, sí pueden ayudar a comprender qué factores pueden haber contribuido a una calidad deficiente. A continuación encontrarás una breve explicación de cada uno de estos conceptos:

Bitrate — Esto representa la cantidad de bits (datos) que se envían a través de la conexión del usuario. El gráfico de métricas de calidad incluye tanto la tasa de bits de audio como la de vídeo, además de la tasa de bits combinada. Pasa el ratón por encima de cualquier punto de una línea trazada para ver estas velocidades de bits en un momento dado, junto con el códec de vídeo, la resolución y la frecuencia de fotogramas (en el caso de una transmisión que incluya vídeo). Aunque la tasa de bits no puede vincularse directamente a la calidad, las tasas de bits muy bajas (menos de 150 kbps para el vídeo y menos de 25 kbps para el audio) suelen estar asociadas a una calidad deficiente. Para comprender mejor qué calidad cabe esperar en función de estas tasas de bits, consulta nuestra Artículo del Centro de ayuda.

Pérdida de paquetes — En una videollamada, los datos se envían en unidades denominadas «paquetes». En muchas ocasiones, algunos de estos paquetes se pierden durante la transmisión, lo que significa que no llegan al terminal del usuario. La pérdida de paquetes se calcula como el porcentaje de paquetes perdidos respecto al total de paquetes enviados. Por ejemplo, si se envían 100 paquetes y solo se reciben 99, la pérdida de paquetes es del 1 %. En una videollamada es normal que se produzca una pequeña pérdida de paquetes sin que ello afecte a la calidad, pero si supera el 3-5 %, es muy probable que la calidad se vea afectada.

Latencia - representa el tiempo que tarda un paquete de datos en llegar de un extremo a otro. Cualquier latencia superior a 300 ms puede tener un efecto negativo en la calidad.

Puede hacer clic en el gráfico y arrastrarlo para ampliar una sección específica del gráfico. Puede filtrar los datos que se muestran en función de las casillas de verificación situadas encima del gráfico: Mostrar vídeo, Mostrar audio, Editores y Suscriptores. También puede filtrar por usuarios utilizando las opciones de filtro de la parte izquierda de la página.

Métricas de calidad de la interconexión SIP

El módulo de métricas de calidad de interconexión SIP proporciona tasa de bits, pérdida de paquetes, latenciay MOS Datos de la «puntuación media de opinión» (Mean Opinion Score) a lo largo del tiempo para cada cliente SIP de la sesión. Las métricas de calidad proceden de la llamada SIP, no del flujo WebRTC.

El Inspector sólo muestra el módulo de Métricas de Calidad de Interconexión SIP para sesiones que incluyen clientes SIP.

En cada gráfico, puedes pasar el ratón por encima de cualquier punto de una línea trazada para ver cada valor en un momento determinado. El ConnectionID que se muestra corresponde al ID de conexión del cliente SIP en la sesión de la Video API de Vonage. Este ID de conexión se devuelve en el Llamada a la API REST para iniciar una conexión SIP en la sesión de la Video API (o en las llamadas correspondientes de los SDK del servidor de la Video API de Vonage).

Bitrate - Esto representa la cantidad de bits (datos) que se envían y reciben desde la puerta de enlace SIP de la Video API de Vonage. Puedes alternar entre la velocidad de bits de audio y video. Si bien la tasa de bits no puede relacionarse directamente con la calidad, las tasas de bits muy bajas generalmente pueden asociarse con una calidad deficiente.

Pérdida de paquetes - Los datos SIP se envían en unidades llamadas paquetes. Este gráfico muestra la pérdida de paquetes (como porcentaje) para cada conexión SIP en la sesión. La pérdida de paquetes que se muestra corresponde a los datos enviados y recibidos desde la puerta de enlace SIP de la Video API de Vonage.

Latencia — Esto representa la latencia de los datos SIP enviados y recibidos desde la pasarela SIP de la Video API de Vonage. Es probable que cualquier latencia superior a 300 ms afecte negativamente a la calidad.

MOS - La puntuación media de opinión (MOS) es una medida objetiva de la calidad global de la llamada experimentada por el usuario. La escala va de 1, que representa una mala calidad de llamada, a 5, que significa una calidad de llamada excelente. Por lo general, las puntuaciones MOS oscilan entre 3 y 4,5 para una calidad aceptable. Esta cifra puede depender de varios factores, como el códec utilizado en la llamada.

Puede hacer clic en el gráfico y arrastrarlo para ampliar una sección específica del gráfico. Puede filtrar los datos que se muestran en función de las casillas de verificación situadas encima del gráfico: Mostrar vídeo y Mostrar audio. También puede filtrar por usuarios SIP utilizando las opciones de filtro de la parte izquierda de la página.

Información de difusión

El módulo de información sobre emisiones proporciona información sobre las emisiones de la sesión. Si hay varias emisiones, seleccione el ID de la emisión que le interese en la parte derecha de la cabecera Información de emisión. Haga clic en la flecha ( > ) de la parte izquierda de la cabecera para ver la información, incluida la resolución de la emisión, el tipo de emisión (HLS y/o RTMP), la duración de la emisión y el número total de bytes servidos.

Registro de sucesos

El registro de eventos enumera los eventos relacionados con la conexión, publicación y suscripción que se produjeron en la sesión o reunión que está inspeccionando. Esto es útil para comprender el contexto de los fallos de conexión, publicación o suscripción, y también puede ser útil para ver rápidamente por qué los usuarios se desconectan, anulan la publicación o la suscripción.

Puede filtrar los eventos mediante la función filtro de texto en la esquina superior izquierda de dos maneras:

• Para ver sólo los eventos que incluyen una cadena específica, por ejemplo "conectar", introduzca esa cadena en el campo de filtro de texto y haga clic en el símbolo "+".
• Para excluir todos los eventos que contengan una cadena de texto concreta, introduce dicha cadena en el campo de filtro de texto y haz clic en el símbolo «-».

También puede filtrar por usuario con los filtros de la barra lateral del Inspector.

Subtítulos en directo

Una vista específica para analizar los datos de Live Caption, que ofrece:

• Una pestaña específica cuando hay eventos de subtítulos.
• Línea de tiempo de los subtítulos para mostrar cuándo se activaron/desactivaron los subtítulos durante una sesión.
• Visibilidad de la actividad de los pies de foto de los editores y suscriptores mediante controles de filtrado sencillos.

Sesiones vs. Reuniones

Todas las interacciones se producen dentro de una sesión (para más información, véase Conceptos básicos de la Video API) - puedes pensar en una sesión como en una "habitación". Las sesiones se crean utilizando la función SDK de servidory cada sesión está asociada a un identificador de sesión.

Aunque recomendamos generar una nueva sesión para cada "reunión" entre participantes -por ejemplo, si un equipo se reúne para una conferencia de grupo-, a veces los identificadores de sesión se reutilizan en varias "reuniones".

Esta reutilización de sesiones puede causar problemas a la hora de depurar una sesión en Inspector, ya que resulta difícil identificar a un usuario o un problema cuando se visualizan varias reuniones a la vez.

Reuniones en Inspector

Para facilitar la depuración de este tipo de sesiones, Inspector divide automáticamente las sesiones en varias reuniones.

Cuando todos los participantes se desconectan de una sesión, la reunión se considera "finalizada", y si nuevos (o los mismos) participantes se unen a la sesión más adelante, se crea una nueva reunión y se muestra en el Inspector.

Por defecto, el Inspector muestra todos reuniones cuando se carga una nueva sesión. Para acceder a una reunión concreta, utiliza el menú desplegable de reuniones situado en la esquina superior derecha de Inspector.

Conexiones, usuarios y flujos en el Inspector

Las conexiones y secuencias forman parte de las funciones básicas de la plataforma Video API.

En esta sección se describe cómo se hace referencia a estos objetos (junto con el objeto "usuario") en Inspector, pero si desea obtener una visión más completa de estos conceptos, consulte Conceptos básicos de la Video API.

Conexiones

Para participar en una sesión, debe establecerse una conexión entre un cliente y la plataforma de vídeo (excepto en un transmitido sesión, en la que los clientes se conectan directamente).

Esta conexión está asociada a un identificador de conexión único. El identificador de conexión es importante a la hora de depurar una sesión en Inspector, ya que cualquier flujo publicado en la sesión está asociado a la conexión desde la que se publicó.

Para saber más sobre cómo se conectan, publican y suscriben los clientes, consulte Conceptos básicos de la Video API.

Puede ver los identificadores de conexión y sus flujos asociados en la sección Datos del usuario sección de Inspector.

También puedes consultar la calidad de cada conexión en el Métricas de calidad sección de Inspector.

Usuarios

Para poder relacionar las conexiones con los usuarios finales reales de una sesión, Inspector también incluye un objeto de usuario.

El usuario está asociado a un punto final de cliente único. Por ejemplo, el navegador o el dispositivo móvil de un usuario final, cuyo seguimiento se realiza mediante cookies.

Aunque un usuario final puede tener varias conexiones (si se desconecta y vuelve a conectar varias veces), siempre estará asociado a un solo usuario en Inspector.

El objeto usuario del Inspector incluye algunas propiedades para identificar quién es quién:

• Ubicación: lugar desde el que se ha conectado el usuario (p. ej., San Francisco, CA)
• Sistema: el navegador y/o el dispositivo desde el que se ha conectado el usuario (p. ej., Chrome, macOS)
• SDK: el SDK de vídeo que utiliza la aplicación cliente del usuario (p. ej., JS-2.28.1)
• Región del servidor: la región del servidor de vídeo utilizada (por ejemplo, California)
• Tiempo de conexión: tiempo de conexión y desconexión de la sesión (incluido el tiempo de conexión)
• IP permitida: si la conexión utiliza la Lista de IP permitidas opción o no

Esto es especialmente útil cuando se trata de depurar problemas que afectan sólo a un usuario específico.

Una vez identificado el usuario en Inspector en función de su ubicación o dispositivo, puedes examinar las conexiones y los flujos de datos de ese usuario para detectar problemas de calidad o de conectividad.

Es importante tener en cuenta que un usuario puede tener varias conexiones, pero una conexión no puede tener varios usuarios.

Puedes consultar la información de los usuarios, así como sus conexiones y transmisiones asociadas, en el Datos del usuario sección de Inspector.

Corrientes

Una vez conectado a una sesión, un usuario puede publicar a corriente y suscríbase a a otros flujos publicados en la sesión.

Cada flujo está asociado a un ID de flujo, que puede utilizarse en Inspector para ver quién en una sesión publicó y se suscribió con éxito a un flujo. Inspector proporciona una variedad de información sobre los flujos:

• La sección «Datos de usuario» ofrece información sobre quiénes han publicado y quiénes se han suscrito a las transmisiones.
• La sección «Métricas de calidad» ofrece información y tendencias sobre la calidad de las transmisiones.
• La sección Registro de eventos proporciona información cronológica sobre los flujos publicados, suscritos y destruidos.

Revisión de sesiones extensas

Si una sesión incluye más de 25 abonados, el tipo de información mostrada en Inspector cambiará, incluyendo la adición de dos módulos, descritos a continuación:

Resumen de la conexión
En esta sección se muestra una línea temporal con los intentos de conexión, los éxitos y los fallos que se han producido durante la sesión.

Resumen de abonados
Esta sección ofrece una cronología visual de los intentos de suscripción, los éxitos y los fracasos de la sesión.

También es importante señalar que los abonados no pueden verse en la sección de métricas de calidad para grandes sesiones.

Esta medida se implementó para mejorar el tiempo de carga en sesiones de gran volumen: si Inspector intentaba cargar visualizaciones de calidad para más de 100 suscriptores, la herramienta tardaba hasta una hora o más en cargar todos los datos, lo que afectaba significativamente a la usabilidad.

Guardar sesiones

De forma predeterminada, puedes consultar las sesiones hasta 20 días después de que haya finalizado una sesión (véase Retención de datos y latencia).

Dentro de este periodo de conservación de 20 días, puede guardar una sesión y seguir inspeccionándola hasta 24 meses.

Para guardar una sesión, visualícela en el Inspector y haga clic en el botón Botón «Guardar» en el encabezado de la página.

Proporcione un nombre para la sesión guardada (obligatorio) y proporcione hasta tres etiquetas personalizadas (opcional).

Para ver una sesión guardada, ve al panel de control de sesiones y haz clic en la pestaña «Sesiones guardadas».

Puedes guardar hasta 1.000 sesiones por Account.

Para editar el nombre o la etiqueta de una sesión, visualice la sesión en el Inspector y haga clic en el icono Botón «Editar» en el encabezado de la página.

Si una sesión está guardada y aún se encuentra dentro del período de retención de 20 días de Inspector, puede sobrescribir los datos de la sesión guardados anteriormente con información actualizada visualizando la página de Inspector para esa sesión y haciendo clic en el botón (Guardar) en la cabecera de la página.

Para eliminar una sesión de la lista de sesiones guardadas:

• Visualice la sesión en el Inspector y haga clic en el botón Botón «Eliminar» en el encabezado de la página.
• Visualice la lista de Sesiones guardadas en el Panel de control de sesiones y haga clic en el botón (Eliminar) de la sesión que desea eliminar. O seleccione varias sesiones y haga clic en el botón Eliminar seleccionadas en la parte superior de la lista Sesiones guardadas.

Nota: Las sesiones guardadas se almacenan durante un máximo de 24 meses y Vonage se reserva el derecho de eliminar cualquier sesión guardada que tenga más de 24 meses.

Retención de datos y latencia

Conservación de datos: 20 días

Nota: El periodo de conservación se basa en la hora de creación de una reunión dentro de la sesión. Las reuniones sólo pueden consultarse dentro de un período de 7 días dentro de la sesión. El buenas prácticas para crear un nuevo ID de sesión para cada chat de vídeo distinto en su aplicación.

Latencia prevista: 5 minutos

Consulta la sección sobre Sesiones vs. Reuniones para más información.

Puede guardar una sesión para ver sus datos después del periodo de retención de datos de 20 días. Consulte Guardar sesiones.

Actualizaciones

26 de junio de 2025

Se añaden las siguientes actualizaciones al Inspector:

• Nuevas descripciones de los eventos de «Acceso denegado» en la tabla «Usuario»:

• Nuevo gráfico de visualización de la puntuación MOS para abonados:

• Nueva visualización de la puntuación MOS:

18 de marzo de 2025

Se añaden las siguientes actualizaciones al Inspector:

• Visualización de estadísticas de las actas de los participantes para Clientes de Advanced Insights
• Detalles mejorados sobre el MOTIVO DE LA FINALIZACIÓN en Tablas de datos de usuario

7 de octubre de 2024

Se añaden las siguientes actualizaciones al Inspector:

• Hay un selección de la zona horaria opción.
• El inspector ahora incluye datos de resolución y frecuencia de imagen. Pasa el cursor por cualquier punto de una línea representada en el gráfico de tasa de bits del módulo «Métricas de calidad» para ver los datos de resolución y frecuencia de fotogramas.
• El Inspector incluye ahora los datos de uso de la lista de IP permitidas. Haga clic en el enlace Ver más detalles a la derecha de una conexión listada en el Datos del usuario módulo para comprobar si la conexión utiliza la lista de direcciones IP permitidas.
• Inspector también incluye ahora datos de métricas de calidad de interconexión SIP. Consulte Métricas de calidad de la interconexión SIP.