Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Supervise el agente Edge de Amazon Kinesis Video Streams con CloudWatch
Puede monitorizar el Amazon Kinesis Video Streams Edge Agent con CloudWatch Amazon, que recopila y procesa datos sin procesar para convertirlos en métricas legibles y prácticamente en tiempo real. Estas estadísticas se registran durante un período de 15 meses. Con esta información histórica, puede obtener una mejor perspectiva del rendimiento de su aplicación web o del servicio Amazon Kinesis Video Streams Edge Agent.
Para ver las métricas, haga lo siguiente:
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el menú de navegación de la izquierda, en **Métricas**, selecciona **Todas las métricas**.
1. Selecciona la pestaña **Explorar** y, a continuación, selecciona el espacio de nombres **EdgeRuntimeAgent**personalizado.
El agente Edge de Amazon Kinesis Video Streams publica las siguientes métricas en el espacio de nombres: `EdgeRuntimeAgent`
- ** Nombre de la transmisión, `RecordJob` **
- **Estado:** Ejecutar / **Description (Descripción):** Se publica de forma continua cuando `RecordJob` está en ejecución. Unidades: ninguna. «1" se publica mientras `RecordJob` esté en este estado.
- **Estado:** FatalError / **Description (Descripción):** Se publica si se produce `RecordJob` un error grave. Unidades: ninguna. «1" se publica una vez, cuando se produce este evento. Consulte los registros para obtener información adicional.
- **Estado:** Completado / **Description (Descripción):** Publica cuando `RecordJob` se completa un. Unidades: ninguna. «1" se publica una vez, cuando se produce este evento.
- ** Nombre de la transmisión, `UploadJob` **
- **Estado:** Ejecutar / **Description (Descripción):** Se publica de forma continua cuando `UploadJob` está en ejecución. Unidades: ninguna. «1" se publica mientras `UploadJob` esté en este estado.
- **Estado:** FatalError / **Description (Descripción):** Se publica si se produce `UploadJob` un error grave. Unidades: ninguna. «1" se publica una vez, cuando se produce este evento. Consulte los registros para obtener información adicional.
- **Estado:** Completado / **Description (Descripción):** Se publica cuando `UploadJob` se completa. Unidades: ninguna. «1" se publica una vez, cuando se produce este evento.
- ** Nombre de flujo **
- **Estado:** PercentageSpaceUsed
- **Description (Descripción):** Es el porcentaje utilizado del espacio total asignado en las configuraciones de Amazon Kinesis Video Streams Edge Agent para los soportes de grabación. Para obtener más información, consulte [LocalSizeConfig](API_LocalSizeConfig.md). Unidades: porcentaje (escala 0—1).
- ** Nombre de cosa **
- **Estado:** ¡Vivo / **Description (Descripción):** Publica cada minuto desde el agente Edge de Amazon Kinesis Video Streams, independientemente de las configuraciones que se estén ejecutando en él. Esto se puede utilizar para saber si el agente Edge de Amazon Kinesis Video Streams está activo y preparado para aceptar configuraciones. Unidades: ninguna. Se publica «1» cada minuto.
- **Estado:** RecordJobs.HealthyJobCount / **Description (Descripción):** Recuento total de trabajos de grabación programados y en ejecución en Amazon Kinesis Video Streams Edge Agent. Unidad: recuento.
- **Estado:** UploadJobs.HealthyJobCount / **Description (Descripción):** Recuento total de trabajos de carga programados y en ejecución en Amazon Kinesis Video Streams Edge Agent. Unidad: recuento.
- **Estado:** RecordJobs.UnhealthyJobCount / **Description (Descripción):** Recuento total de trabajos de registro con errores actualmente. Unidad: recuento.
- **Estado:** UploadJobs.UnhealthyJobCount / **Description (Descripción):** Recuento total de trabajos de carga con errores actualmente. Unidad: recuento.
- **Estado:** RecordJobs.RunningJobCount / **Description (Descripción):** Recuento total de trabajos de registro en ejecución activa. Unidad: recuento.
- **Estado:** UploadJobs.RunningJobCount / **Description (Descripción):** Recuento total de trabajos de carga en ejecución activa. Unidad: recuento.
- **Estado:** RecordJobs.EdgeConfigCount / **Description (Descripción):** Recuento total de configuraciones de grabación en proceso en Amazon Kinesis Video Streams Edge Agent. Unidad: recuento.
- **Estado:** UploadJobs.EdgeConfigCount / **Description (Descripción):** Recuento total de configuraciones de carga en proceso en Amazon Kinesis Video Streams Edge Agent. Unidad: recuento.
## CloudWatch guía de métricas para Amazon Kinesis Video Streams Edge Agent
CloudWatch las métricas pueden resultar útiles para encontrar respuestas a las siguientes preguntas:
**Topics**
+ [¿El agente Edge de Amazon Kinesis Video Streams tiene suficiente espacio para grabar?](#monitoring-edge-space)
+ [¿Está activo el agente Edge de Amazon Kinesis Video Streams?](#monitoring-edge-alive)
+ [¿Hay trabajos insalubres?](#monitoring-edge-unhealthy)
+ [¿Hay algún trabajo que necesite intervención externa?](#monitoring-edge-intervention)
### ¿El agente Edge de Amazon Kinesis Video Streams tiene suficiente espacio para grabar?
**Métricas relevantes:** `PercentageSpaceUsed`
**Acción:** no es necesaria ninguna acción.
### ¿Está activo el agente Edge de Amazon Kinesis Video Streams?
**Métricas relevantes:** `Alive`
**Acción:** Si en algún momento deja de recibir esta métrica, significa que el agente Edge de Amazon Kinesis Video Streams **ha detectado uno o varios** de los siguientes factores:
+ Un problema de tiempo de ejecución de la aplicación: limitación de memoria u otros recursos, error, etc.
+ El AWS IoT dispositivo que el agente está ejecutando se apagó, se bloqueó o se cerró
+ El AWS IoT dispositivo no tiene conectividad de red
### ¿Hay trabajos insalubres?
**Métricas relevantes:**
+ `RecordJobs.UnhealthyJobCount`
+ `UploadJobs.UnhealthyJobCount`
**Acción:** inspeccione los registros y busque la `FatalError` métrica.
+ Si la `FatalError` métrica **está** presente, se ha producido un error grave y es necesario reiniciar el trabajo manualmente. Inspeccione los registros y solucione el problema antes `StartEdgeConfigurationUpdate` de reiniciarlos manualmente.
+ Si la `FatalError` métrica **no está** presente, se ha producido un error transitorio (no grave) y Amazon Kinesis Video Streams Edge Agent está reintentando el trabajo.
**nota**
Para que el agente vuelva a intentar un trabajo en el que se cometió un error grave, utilice. [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md)
### ¿Hay algún trabajo que necesite intervención externa?
**Métricas relevantes:**
+ `PercentageSpaceUsed`— Si supera un valor determinado, el trabajo de grabación se detiene y se reanuda solo cuando hay espacio disponible (cuando el material deja de retenerse). Puede enviar una configuración actualizada con un valor superior `MaxLocalMediaSizeInMB` para actualizar el trabajo inmediatamente.
+ `RecordJob.FatalError`/`UploadJob.FatalError`— Investigue los registros del agente y vuelva a enviar la configuración para que se reanude el trabajo.
**Acción:** Realice una llamada a la API con la configuración para reiniciar los trabajos que tengan este problema.