# Supervisión del streaming en tiempo real de Amazon IVS Este documento proporciona detalles sobre las opciones disponibles para monitorear su aplicación de transmisión en tiempo real de IVS. ## ¿Qué es la sesión de una fase? La *sesión* de una fase comienza cuando el primer participante se une a una fase y finaliza unos minutos después de que el último participante deje de publicar en dicha fase. Las sesiones de las fases ayudan a depurar las fases de larga duración al separar los eventos y los participantes en sesiones de corta duración. ## Ver sesiones de fases y participantes ### Instrucciones de la consola 1. Abra la [consola de Amazon IVS](https://console.aws.amazon.com/ivs). (También puede acceder a la consola de Amazon IVS a través de la [Consola de administración de AWS](https://console.aws.amazon.com/)). 1. En el panel de navegación elija **Fases**. (Si el panel de navegación está contraído, ábralo primero eligiendo el icono de hamburguesa). 1. Elija la fase para ir a la página de detalles correspondiente. 1. Desplácese hacia abajo en la página hasta que vea la sección **Sesiones de fase** y, a continuación, seleccione la sesión de una fase para ver la página de detalles. 1. Para ver los participantes de la sesión, desplácese hacia abajo hasta que vea la sección **Participantes** y, a continuación, seleccione un participante para ver la página de detalles pertinente, incluidos los gráficos de las métricas de Amazon CloudWatch. ## Ver eventos de un participante Los eventos se envían cuando el estado de un participante en de un escenario cambia. Por ejemplo, cuando se une a un escenario o se produce un error al intentar publicar en uno de ellos. No todos los errores provocan eventos; por ejemplo, los errores de red del lado del cliente y los errores de firma de los tokens no se envían como eventos. Para gestionar estos errores en la aplicación cliente, utilice los [SDK de transmisión de IVS](broadcast.md). ### Instrucciones de la consola 1. Vaya a la página de detalles del participante tal y como se ha indicado anteriormente. 1. Desplácese hacia abajo hasta que vea la sección **Eventos**. Se muestra una lista ordenada de los eventos del participante. Consulte [Uso de Amazon EventBridge con Amazon IVS](eventbridge.md) para obtener más información sobre los eventos que se emiten para los participantes. ### Instrucciones de la CLI El acceso a los eventos de sesiones de escenarios con la AWS CLI es una opción avanzada y requiere que antes descargue y configure la CLI en su equipo. Para obtener más información, consulte la [Guía del usuario de la Interfaz de la línea de comandos de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). 1. Enumere las sesiones de una fase para encontrar una en particular: ``` aws ivs-realtime list-stage-sessions --stage-arn ``` 1. Enumere los participantes de la sesión de una fase para encontrar un participante: ``` aws ivs-realtime list-participants --stage-arn –session-id ``` 1. Enumere los eventos de la sesión de una fase y un participante: ``` aws ivs-realtime list-participant-events --stage-arn --session-id –-participant-id ``` A continuación, se muestra una respuesta de ejemplo a la llamada `list-participant-events`: ``` { "events": [ { "eventTime": "2023-04-04T22:48:41+00:00", "name": "JOINED", "participantId": "AdRezBl021t0" }, { "eventTime": "2023-04-04T22:48:41+00:00", "name": "SUBSCRIBE_STARTED", "participantId": "AdRezBl021t0", "remoteParticipantId": "Ou5b5n5XLMdC" }, { "eventTime": "2023-04-04T22:49:45+00:00", "name": "SUBSCRIBE_STOPPED", "participantId": "AdRezBl021t0", "remoteParticipantId": "Ou5b5n5XLMdC" }, { "eventTime": "2023-04-04T22:49:45+00:00", "name": "LEFT", "participantId": "AdRezBl021t0" } ] } ``` ## Acceso a métricas de CloudWatch Para que las métricas de CloudWatch estén disponibles, se requieren las siguientes versiones del SDK de transmisión de IVS: Web 1.5.0 o posterior, Android 1.12.0 o posterior o iOS 1.12.0 o posterior. ### Instrucciones de la consola de CloudWatch 1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. En el panel de navegación lateral, expanda el menú desplegable **Metrics** (Métricas) y, a continuación, seleccione **All metrics** (Todas las métricas). 1. En la pestaña **Explorar**, mediante el menú desplegable sin etiqueta de la izquierda, seleccione su región de “inicio”, donde se crearon los canales. Para obtener más información sobre las regiones, consulte [Solución global, control regional](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws). Para obtener una lista de las regiones admitidas, consulte la [Página de Amazon IVS](https://docs.aws.amazon.com/general/latest/gr/ivs.html) en la *Referencia general de AWS*. 1. En la parte inferior de la pestaña **Explorar**, seleccione el espacio de nombres **IVSRealTime**. 1. Realice una de las siguientes acciones: 1. En la barra de búsqueda, ingrese el ID de recurso (parte del ARN, `arn:::ivs:stage/`). A continuación, seleccione **IVSRealTime > Estado de las métricas.** 1. Si **IVSRealTime** aparece como un servicio seleccionable en **Espacios de nombres de AWS**, selecciónelo. Se mostrará si utiliza transmisión en tiempo real de Amazon IVS y envía métricas a Amazon CloudWatch. (Si **IVSRealTime** no está en la lista, no tiene ninguna métrica de Amazon IVS). Luego, elija la agrupación de *dimensiones* que desee; las dimensiones disponibles se muestran a continuación en [Métricas de CloudWatch](#stage-health-cloudwatch-metrics). 1. Elija métricas para agregarlas al gráfico. Las métricas disponibles se muestran a continuación en [Métricas de CloudWatch](#stage-health-cloudwatch-metrics). También puede acceder al gráfico de CloudWatch de la sesión de transmisión desde la página de detalles de la sesión de transmisión, seleccionando el botón **View in CloudWatch** (Ver en CloudWatch). ### Instrucciones de la CLI También puede obtener acceso a las métricas mediante la AWS CLI. Esto requiere que primero descargue y configure la CLI en su equipo. Para obtener más información, consulte la [Guía del usuario de la interfaz de línea de comandos de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). A continuación, para obtener acceso a las métricas de transmisión en tiempo real de Amazon IVS mediante AWS CLI: + En el símbolo del sistema, ejecute: ``` aws cloudwatch list-metrics --namespace AWS/IVSRealTime ``` Para obtener más información, consulte [Uso de las métricas de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) en la *Guía del usuario de Amazon CloudWatch*. ## Métricas de CloudWatch: streaming en tiempo real de IVS Amazon IVS proporciona las siguientes métricas en el espacio de nombres de **AWS/IVSRealTime**. Para que las métricas de CloudWatch estén disponibles, se debe usar SDK de transmisión web 1.5.2 o una versión posterior. La dimensión puede tener los siguientes valores válidos: + La dimensión `Stage` es un ID de recurso (parte del ARN, `arn:::stage/`). + La dimensión de `Participant` es una `participantID`. + El valor de `SimulcastLayer` puede ser «alto», «medio», «bajo» o «ninguno» para un `MediaType` de «video» o «ninguno» para un `MediaType` de «audio». Este valor también puede estar vacío. + La dimensión de `MediaType` es “video” o “audio” (cadena). En el caso de la replicación de participantes, para la fase de destino, las métricas de estado de la fase existentes incluyen a todos los participantes replicados (publicadores en la fase de origen que son participantes de réplica en la fase de destino). | Métrica | Dimensiones | Descripción | | --- | --- | --- | | `ConcurrentPublishers` | — | Número de participantes que pueden publicar en todos los escenarios de una región de AWS.
Unidad: recuento
Estadísticas válidas: Promedio, Máximo, Mínimo | | `ConcurrentSubscriptions` | — | Número de conexiones simultáneas entre publicador y suscriptor en todas las etapas de una región de AWS.
Unidad: recuento
Estadísticas válidas: Promedio, Máximo, Mínimo | | `DownloadPacketLoss` | — | Porcentaje de paquetes que se perdieron durante la descarga del servidor de IVS por los suscriptores.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Platform` | Filtra `DownloadPacketLoss` por plataforma de suscriptores.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Platform, SDKVersion` | Filtra `DownloadPacketLoss` por plataforma de suscriptor y versión del SDK.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Stage` | Filtra `DownloadPacketLoss` por fase de suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Stage, Participant` | Filtra `DownloadPacketLoss` por participante, para los suscriptores que también son publicadores. Las muestras representan el porcentaje de paquetes que perdió un suscriptor durante la descarga del servidor de IVS. Las muestras se emiten solo cuando el participante también es publicador.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DownloadPacketLoss` | `Stage, Platform` | Filtra `DownloadPacketLoss` por escenario y plataforma del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Stage, Platform, SDKVersion` | Filtra `DownloadPacketLoss` por escenario, plataforma y versión del SDK del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `Stage, SubscriberCountryCode` | Filtra `DownloadPacketLoss` por escenario y código de país (ISO 3166) del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DownloadPacketLoss` | `SubscriberCountryCode` | Filtra `DownloadPacketLoss` por código de país del suscriptor (ISO 3166).
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) pérdida de paquetes durante el intervalo configurado | | `DroppedFrames` | `—` | Para suscriptores: el porcentaje de fotogramas de video descartados, calculado al agregar los fotogramas recibidos y los fotogramas descartados de todos los publicadores a los que el suscriptor está suscrito.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Platform` | Filtra `DroppedFrames` por la plataforma del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Platform, SDKVersion` | Filtra `DroppedFrames` por la plataforma del suscriptor y la versión del SDK.
Porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Stage` | Filtra `DroppedFrames` por escenario.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Stage, Participant` | Filtra `DroppedFrames` por escenario y participante. Solo se emite para suscriptores que también son publicadores.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Stage, Platform` | Filtra `DroppedFrames` por escenario y por la plataforma del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Stage, Platform, SDKVersion` | Filtra `DroppedFrames` por escenario, por la plataforma del suscriptor y por la versión del SDK.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `Stage, SubscriberCountryCode` | Filtra `DroppedFrames` por escenario y por país del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `DroppedFrames` | `SubscriberCountryCode` | Filtra `DroppedFrames` por país del suscriptor.
Unidad: porcentaje
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de fotogramas descartados durante el intervalo configurado | | `PublishBitrate` | `—` | a tasa total a la que un publicador envía datos de video y audio (sumados en todas las capas de transmisión simultánea). Esto incluye los datos retransmitidos. La tasa de bits puede inflarse debido a la pérdida de paquetes de subida y a las retransmisiones, ya que refleja lo que el publicador envía y puede no coincidir con lo que IVS recibe o entrega a los suscriptores.
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `PublishBitrate` | `Platform` | Filtra `PublishBitrate` por la plataforma del publicador.
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `PublishBitrate` | `Stage` | Filtra `PublishBitrate` por escenario.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `PublishBitrate` | `Stage, Participant, SimulcastLayer, MediaType` | Filtra `PublishBitrate` por escenario, participante, capa de simulcast y tipo de medio. El ID de la capa de transmisión simultánea lo establece el SDK de transmisión. Cuando la transmisión simultánea está deshabilitada, este ID de capa se establece como “deshabilitado”. El tipo de medio puede ser “video” o “audio”.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `Publishers` | `Stage` | Número de participantes que publican en el escenario.
Unidad: recuento
Estadísticas válidas: Promedio, Máximo, Mínimo | | `PublishFramerate` | `Stage, Participant` | Frecuencia con la que se reciben fotogramas de video de un publicador determinado. Esta métrica solo está disponible para los participantes que publican en RTMP.
Unidad: recuento por segundo
Estadísticas válidas: promedio, máximo, mínimo: número promedio, número mayor o número menor (respectivamente) de velocidad de fotogramas durante el intervalo configurado | | `PublishFramerate` | `Stage, Participant, SimulcastLayer, MediaType` | Frecuencia con la que se reciben fotogramas de video de un publicador determinado. Esta métrica solo está disponible para los participantes que publican en RTMP.
Unidad: recuento por segundo
Estadísticas válidas: promedio, máximo, mínimo: número promedio, número mayor o número menor (respectivamente) de velocidad de fotogramas durante el intervalo configurado | | `PublishResolution` | `Stage, Participant, SimulcastLayer, MediaType` | Número de píxeles en el ancho o alto más pequeño del marco. Por ejemplo, para un marco horizontal de 1920 x 1080, la PublishResolution es 1080. Para un marco de retrato de tamaño 720 x 1280, la PublishResolution es 720.
Unidad: recuento
Estadísticas válidas: Promedio, Máximo, Mínimo | | `SubscribeBitrate` | `—` | La tasa total a la que un suscriptor determinado recibe datos de video y audio.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Platform` | Filtra `SubscribeBitrate` por la plataforma del suscriptor.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Platform, SDKVersion` | Filtra `SubscribeBitrate` por la plataforma del suscriptor y la versión del SDK.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Stage` | Filtra `SubscribeBitrate` por escenario.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Stage, Participant, MediaType` | Filtra `SubscribeBitrate` por escenario, participante y tipo de medio. El tipo de medio puede ser “video” o “audio”. Esta métrica solo se emite mientras el participante suscriptor también está publicando.
Unidad: bits por segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Stage, Platform` | Filtra `SubscribeBitrate` por escenario y por la plataforma del suscriptor.
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Stage, Platform, SDKVersion` | Filtra `SubscribeBitrate` por escenario, por la plataforma del suscriptor y por la versión del SDK.
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `Stage, SubscriberCountryCode` | Filtra `SubscribeBitrate` por escenario y el código de país del suscriptor.
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `SubscribeBitrate` | `SubscriberCountryCode` | Filtra `SubscribeBitrate` por el código de país del suscriptor (ISO 3166-1 alfa-2).
Bits/segundo
Estadísticas válidas: promedio, máximo, mínimo: número medio, número mayor o menor (respectivamente) de tasas de bits durante el intervalo configurado | | `Subscribers` | `Stage` | Número de participantes suscritos al escenario. Tenga en cuenta que los participantes que publican y se suscriben activamente se cuentan tanto como editores como suscriptores.
Unidad: recuento
Estadísticas válidas: Promedio, Máximo, Mínimo |