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. # Supervisión de las implementaciones con las herramientas de Amazon CloudWatch Puede supervisar CodeDeploy las implementaciones con las siguientes CloudWatch herramientas: Amazon CloudWatch Events, CloudWatch alarmas y Amazon CloudWatch Logs. Revisar los registros creados por el CodeDeploy agente y las implementaciones puede ayudarle a solucionar las causas de los errores de implementación. Como alternativa a revisar CodeDeploy los registros de una instancia a la vez, puede usar CloudWatch los registros para monitorear todos los registros en una ubicación central. Para obtener información sobre el uso de CloudWatch alarmas y CloudWatch eventos para monitorear CodeDeploy las implementaciones, consulta los siguientes temas. **Topics** + [Supervisión de las implementaciones con CloudWatch alarmas en CodeDeploy](monitoring-create-alarms.md) + [Supervisión de despliegues con Amazon Events CloudWatch](monitoring-cloudwatch-events.md) # Supervisión de las implementaciones con CloudWatch alarmas en CodeDeploy Puede crear una CloudWatch alarma para una instancia o grupo de Amazon EC2 Auto Scaling que utilice en CodeDeploy sus operaciones. Una alarma vigila una única métrica durante un período de tiempo que usted especifique y realiza una o más acciones en función del valor de la métrica en relación con un umbral determinado durante varios períodos de tiempo. CloudWatch las alarmas invocan acciones cuando su estado cambia (por ejemplo, de `OK` a`ALARM`). Con la funcionalidad de CloudWatch alarma nativa, puede especificar cualquiera de las acciones que se admiten CloudWatch cuando se produce un error en una instancia que está utilizando en una implementación, como enviar una notificación de Amazon SNS o detener, terminar, reiniciar o recuperar una instancia. Para sus CodeDeploy operaciones, puede configurar un grupo de despliegues para que detenga un despliegue cada vez que se active cualquier CloudWatch alarma que asocie al grupo de despliegues. Puede asociar hasta diez CloudWatch alarmas a un grupo CodeDeploy de despliegue. Si se activa cualquiera de las alarmas especificadas, la implementación se detiene y el estado se actualiza a Stopped. Para utilizar esta opción, debe conceder CloudWatch permisos a su función CodeDeploy de servicio. Para obtener información sobre la configuración de CloudWatch alarmas en la CloudWatch consola, consulte [Creación de CloudWatch alarmas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*. Para obtener información sobre cómo asociar una CloudWatch alarma a un grupo de despliegues en CodeDeploy, consulte [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md) y[Cambie la configuración del grupo de implementación con CodeDeploy](deployment-groups-edit.md). **Topics** + [Otorgue CloudWatch permisos a un rol CodeDeploy de servicio](monitoring-create-alarms-grant-permissions.md) # Otorgue CloudWatch permisos a un rol CodeDeploy de servicio Antes de poder utilizar la supervisión de CloudWatch alarmas en sus despliegues, debe concederse permiso a la función de servicio que utilice en sus CodeDeploy operaciones para acceder a los CloudWatch recursos. **Para conceder CloudWatch permisos a un rol de servicio** 1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En el panel de navegación de la consola de IAM, elija **Roles**. 1. Elija el nombre de la función de servicio que utiliza en sus AWS CodeDeploy operaciones. 1. En la pestaña **Permissions**, en el área **Inline Policies**, elija **Create Role Policy**. –o bien– Si el botón **Create Role Policy** no está disponible, expanda el área **Inline Policies** y después elija **click here**. 1. En la página **Set Permissions**, elija **Custom Policy** y después **Select**. 1. En la página **Review Policy**, en el campo **Policy Name**, escriba un nombre que identifique esta política, como `CWAlarms`. 1. Pegue la siguiente información en el campo **Policy Document:** ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloudwatch:DescribeAlarms", "Resource": "*" } ] } ``` ------ 1. Seleccione **Apply Policy**. # Supervisión de despliegues con Amazon Events CloudWatch Puede usar Amazon CloudWatch Events para detectar cambios en el estado de una instancia o un despliegue (un «evento») en sus CodeDeploy operaciones y reaccionar ante ellos. Luego, en función de las reglas que cree, CloudWatch Events invocará una o más acciones objetivo cuando una implementación o instancia entre en el estado que especifique en una regla. En función del tipo de cambio de estado, es posible que desee enviar notificaciones, capturar información de estado, tomar medidas correctivas, iniciar eventos o adoptar otras medidas. Puede seleccionar los siguientes tipos de objetivos cuando utilice CloudWatch Events como parte de sus CodeDeploy operaciones: + AWS Lambda funciones + Flujos de Kinesis + Colas de Amazon SQS + Destinos integrados (`EC2 CreateSnapshot API call`, `EC2 RebootInstances API call`, `EC2 StopInstances API call` y `EC2 TerminateInstances API call`) + Temas de Amazon SNS A continuación se indican algunos casos de uso: + Utilice una función Lambda para pasar una notificación a un canal de Slack siempre que se produzcan errores en las implementaciones. + Envíe datos acerca de las implementaciones o instancias a un flujo de Kinesis para permitir una monitorización completa del estado en tiempo real. + Utilice acciones de CloudWatch alarma para detener, finalizar, reiniciar o recuperar automáticamente las EC2 instancias de Amazon cuando se produzca un evento de implementación o instancia que especifique. El resto de este tema describe el procedimiento básico para crear una regla de CloudWatch eventos para CodeDeploy. Sin embargo, antes de crear reglas de eventos para utilizarlas en sus CodeDeploy operaciones, debe hacer lo siguiente: + Complete los requisitos previos de los CloudWatch eventos. Para obtener más información, consulte los [requisitos previos de Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_Prerequisites.html). + Familiarícese con los eventos, las reglas y los objetivos de CloudWatch Events. Para obtener más información, consulta [¿Qué es Amazon CloudWatch Events?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) y [nuevos CloudWatch eventos: realice un seguimiento de los cambios en sus AWS recursos y responda a ellos](https://aws.amazon.com/blogs/aws/new-cloudwatch-events-track-and-respond-to-changes-to-your-aws-resources/). + Crear el destino o los destinos que se utilizarán en las reglas de eventos. **Para crear una regla de CloudWatch eventos para CodeDeploy:** 1. Abre la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. En el panel de navegación, elija **Events (Eventos)**. 1. Elija **Create rule (Crear regla)** y, a continuación, en **Event selector (Selector de eventos)**, elija **AWS CodeDeploy**. 1. Especifique un tipo de detalle: + Para crear una regla que se aplique a todos los cambios de estado de las instancias y las implementaciones, elija **Any detail type (Cualquier tipo de detalle)** y continúe en el paso 6. + Para crear una regla que se aplique solo a las instancias, elija un **tipo de detalle específico** y, a continuación, elija **Notificación de cambio de estado de la CodeDeploy instancia**. + Para crear una regla que se aplique únicamente a las implementaciones, elija un **tipo de detalle específico** y, a continuación, elija Notificación de cambio de **estado de la CodeDeploy implementación**. 1. Especifique los cambios de estado a los que se aplica la regla: + Para crear una regla que se aplique a todos los cambios de estado, elija **Any state (Cualquier estado)**. + Para crear una regla que se aplique únicamente a algunos cambios de estado, seleccione **Specific state(s) (Estados específicos)** y luego elija uno o varios valores de estado de la lista. En la siguiente tabla se muestran los valores de estado que puede elegir: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/monitoring-cloudwatch-events.html) 1. Especifique a qué CodeDeploy aplicaciones se aplica la regla: + Para crear una regla que se aplique a todas las aplicaciones, elija **Any application (Cualquier aplicación)** y continúe en el paso 8. + Para crear una regla que se aplique únicamente a una aplicación, seleccione **Specific application (Aplicación específica)** y luego elija el nombre de la aplicación en la lista. 1. Especifique los grupos de implementaciones a los que se aplica la regla: + Para crear una regla que se aplique a todos los grupos de implementaciones asociados a la aplicación seleccionada, elija **Any deployment group (Cualquier grupo de implementaciones)**. + Para crear una regla que se aplique únicamente a uno de los grupos de implementaciones asociados a la aplicación seleccionada, seleccione **Specific deployment group(s) (Grupos de implementaciones específicos)** y, a continuación, elija el nombre del grupo de implementaciones en la lista. 1. Revise la configuración de las reglas para asegurarse de que se ajusta a los requisitos de monitorización de eventos. 1. En el área **Targets**, seleccione **Add target\$1**. 1. En la lista **Select target type**, elija el tipo de destino que haya preparado para usarlo con esta regla y luego configure las opciones adicionales que requiera dicho tipo. 1. Seleccione **Configurar los detalles**. 1. En la página **Configure rule details (Configurar detalles de la regla)**, escriba un nombre y la descripción de la regla, y, a continuación, elija la casilla **State (Estado)** para habilitar la regla ahora. 1. Si está satisfecho con la regla, elija **Create rule (Crear regla)**.