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.
# Monitoreo de entornos en Elastic Beanstalk
Con el monitoreo del estado de Elastic Beanstalk, puede comprobar la disponibilidad de las aplicaciones y crear alertas que se activan cuando las métricas superan los umbrales. Puede usar el monitoreo del estado de Elastic Beanstalk tanto en la consola como en la línea de comandos para realizar un seguimiento del estado de su entorno.
**Topics**
+ [Supervisión del estado del entorno en la consola AWS de administración](environment-health-console.md)
+ [Uso de la CLI de EB para supervisar el estado del entorno](health-enhanced-ebcli.md)
+ [Informes de estado básicos](using-features.healthstatus.md)
+ [Informes y monitoreo de estado mejorados de Elastic Beanstalk](health-enhanced.md)
+ [Administrar alarmas](using-features.alarms.md)
+ [Visualización del historial de cambios de un entorno de Elastic Beanstalk](using-features.changehistory.md)
+ [Visualización de la transmisión de eventos de un entorno de Elastic Beanstalk](using-features.events.md)
+ [Listado y conexión a instancias de servidor](using-features.ec2connect.md)
+ [Visualización de registros de instancias de Amazon EC2 en su entorno de Elastic Beanstalk](using-features.logging.md)
+ [Visualización de los registros de implementación de un entorno de Elastic Beanstalk](environments-deployment-logs.md)
# Supervisión del estado del entorno en la consola AWS de administración
Puede consultar información sobre las operaciones de la aplicación en la consola de Elastic Beanstalk. En la consola se muestra el estado del entorno y de la aplicación de un solo vistazo. En la página **Environments (Entornos)** de la consola y en la página de cada aplicación, los entornos de la lista están codificados por colores para indicar el estado.
**Para supervisar un entorno en la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, seleccione **Supervisión**.
En la página de supervisión, se muestran estadísticas generales sobre el entorno, como el uso de CPU y la latencia media. Además de estadísticas generales, puede ver gráficos de supervisión que representan el uso de los recursos a lo largo del tiempo. Puede hacer clic en cualquiera de los gráficos para ver información más detallada.
**nota**
De forma predeterminada, solo están habilitadas CloudWatch las métricas básicas, que devuelven datos en períodos de cinco minutos. Puede habilitar CloudWatch métricas más detalladas en un minuto editando los ajustes de configuración de su entorno.
## Gráficos de supervisión
La página **Supervisión** muestra información general sobre el estado del entorno. Esto incluye el conjunto predeterminado de métricas que proporcionan Elastic Load Balancing y Amazon EC2, y gráficos que muestran cómo ha cambiado el estado del entorno a lo largo del tiempo.
La barra situada por encima de los gráficos proporciona una variedad de intervalos de tiempo que se pueden seleccionar. Por ejemplo, seleccione **1s** para mostrar la información que abarca la última semana. O seleccione **3h** para mostrar la información de las últimas tres horas.
Para una mayor variedad de selecciones de intervalos de tiempo, elija **Personalizado**. Desde aquí tiene dos opciones de rango: *Absoluto* o *Relativo*. La opción **Absoluto** le permite especificar un intervalo de fechas específico, p. ej., del *1 de enero de 2023 al 30 de junio de 2023*. La opción **Relativo** permite seleccionar un número entero con una unidad de tiempo específica: *minutos**, horas*, *días*, *semanas* o *meses*. Los ejemplos incluyen *10 horas*, *10 días* y *10 meses*.
![\[Sección Environment health monitoring (Supervisión del estado del entorno) en la página de supervisión del entorno de la consola de Elastic Beanstalk\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/environment-monitoring-graphs.png)
## Personalización de la consola de supervisión
Para crear y ver métricas personalizadas, debes usar Amazon CloudWatch. Con CloudWatch él, puede crear paneles personalizados para monitorear sus recursos en una sola vista. Selecciona **Añadir al panel de control** para ir a la CloudWatch consola de Amazon desde la página de **monitorización**. Amazon te CloudWatch ofrece la opción de crear un nuevo panel de control o seleccionar uno existente. Para obtener más información, consulta [Uso de los CloudWatch paneles de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) en la *Guía del CloudWatch usuario de Amazon*.
![\[Sección Environment health monitoring (Supervisión del estado del entorno) en la página de supervisión del entorno de la consola de Elastic Beanstalk\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/environment-monitoring-graphs.png)
EC2Las métricas de [Elastic Load Balancing](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/elb-metricscollected.html) y [Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/ec2-metricscollected.html) están habilitadas para todos los entornos.
Con un [estado mejorado](health-enhanced.md), la EnvironmentHealth métrica está habilitada y se agrega automáticamente un gráfico a la consola de monitoreo. El sistema de estado avanzado también agrega la [página Health](health-enhanced-console.md#health-enhanced-console-healthpage) a la consola de administración. Para ver una lista de las métricas de estado mejorado disponibles, consulte [Publicar métricas CloudWatch personalizadas de Amazon para un entorno](health-enhanced-cloudwatch.md).
# Uso de la CLI de EB para supervisar el estado del entorno
La interfaz de línea de comandos de [Elastic Beanstalk (EB CLI) es una herramienta de línea](eb-cli3.md) de comandos para administrar entornos. AWS Elastic Beanstalk También puede utilizar la CLI de EB para supervisar el estado del entorno en tiempo real y con más detalle que lo que permite actualmente la consola de Elastic Beanstalk.
Después de [instalar](eb-cli3.md#eb-cli3-install) y [configurar](eb-cli3-configuration.md) la CLI de EB, puede lanzar un nuevo entorno e implementar el código en él con el comando **eb create**. Si ya tiene un entorno creado en la consola de Elastic Beanstalk, puede asociarlo a la CLI de EB ejecutando **eb init** en una carpeta del proyecto y siguiendo después las instrucciones (la carpeta del proyecto puede estar vacía).
**importante**
Asegúrese de que está utilizando la última versión de la CLI de EB ejecutando `pip install` con la opción `--upgrade`:
```
$ sudo pip install --upgrade awsebcli
```
Para obtener instrucciones sobre la instalación de la CLI de EB, consulte [Instalación de la CLI de EB con el script de configuración (recomendado)](eb-cli3.md#eb-cli3-install).
Si desea utilizar la CLI de EB para supervisar el estado del entorno, primero debe configurar una carpeta de proyecto local ejecutando **eb init** y siguiendo las instrucciones. Para obtener instrucciones completas, consulte [Configuración de la CLI de EB](eb-cli3-configuration.md).
Si ya tiene un entorno que se ejecuta en Elastic Beanstalk y desea utilizar la CLI de EB para supervisar su estado, siga estos pasos para adjuntarlo al entorno existente.
**Para adjuntar la CLI de EB a un entorno existente**
1. Abra un terminal de línea de comando y desplácese hasta la carpeta del usuario.
1. Cree y abra una nueva carpeta en el entorno.
1. Ejecute el comando **eb init** y seleccione la aplicación y el entorno cuyo estado desea supervisar. Si solo hay un entorno que ejecute la aplicación seleccionada, la CLI de EB lo seleccionará automáticamente y no será necesario que lo elija usted, tal y como se muestra en el ejemplo siguiente.
```
~/project$ eb init
Select an application to use
1) elastic-beanstalk-example
2) [ Create new Application ]
(default is 2): 1
Select the default environment.
You can change this later by typing "eb use [environment_name]".
1) elasticBeanstalkEx2-env
2) elasticBeanstalkExa-env
(default is 1): 1
```
**Para supervisar el estado a través de la CLI de EB**
1. Abra una línea de comando y desplácese hasta la carpeta del proyecto.
1. Ejecute el comando **eb health** para mostrar el estado de las instancias del entorno. En este ejemplo, existen cinco instancias que se ejecutan en un entorno de Linux.
```
~/project $ eb health
elasticBeanstalkExa-env Ok 2015-07-08 23:13:20
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-d581497d Ok
i-d481497c Ok
i-136e00c0 Ok
i-126e00c1 Ok
i-8b2cf575 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000
i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000
i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000
i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000
i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1
i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1
i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0
i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1
instance-id status id version ago deployments
i-d581497d Deployed 1 Sample Application 12 mins
i-d481497c Deployed 1 Sample Application 12 mins
i-136e00c0 Deployed 1 Sample Application 12 mins
i-126e00c1 Deployed 1 Sample Application 12 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
En este ejemplo, hay una sola instancia que se ejecuta en un entorno de Windows.
```
~/project $ eb health
WindowsSampleApp-env Ok 2018-05-22 17:33:19
WebServer IIS 10.0 running on 64bit Windows Server 2016/2.2.0
total ok warning degraded severe info pending unknown
1 1 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-065716fba0e08a351 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 13.7 100.0 0.0 0.0 0.0 1.403 0.970 0.710 0.413 0.079
i-065716fba0e08a351 2.4 100.0 0.0 0.0 0.0 1.102* 0.865 0.601 0.413 0.091
instance-id type az running % user time % privileged time % idle time cpu
i-065716fba0e08a351 t2.large 1b 4 hours 0.2 0.1 99.7
instance-id status id version ago deployments
i-065716fba0e08a351 Deployed 2 Sample Application 4 hours
```
## Descripción de la salida
En la salida, en la parte superior de la pantalla, se muestra el nombre del entorno, el estado general del entorno y la fecha actual.
```
elasticBeanstalkExa-env Ok 2015-07-08 23:13:20
```
Las tres líneas siguientes muestran el tipo de entorno (»WebServer» en este caso), la configuración (Ruby 2.1 con Puma) y un desglose del número de instancias que hay en cada uno de los siete estados.
```
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
```
El resto de la salida está dividida en cuatro secciones. En la primera, el valor de *status* indica el estado, mientras que el valor de *cause* indica la causa del estado del entorno en su conjunto y de cada instancia. En el ejemplo siguiente, se muestran dos instancias del entorno con el estado `Info` y una causa que indica que se ha iniciado una implementación.
```
instance-id status cause health
Overall Ok
i-d581497d Info Performing application deployment (running for 3 seconds)
i-d481497c Info Performing application deployment (running for 3 seconds)
i-136e00c0 Ok
i-126e00c1 Ok
i-8b2cf575 Ok
```
Para obtener más información sobre los estados y los colores, consulte [Colores y estados](health-enhanced-status.md).
En la sección **requests**, se muestra información de los logs de los servidores web de cada instancia. En este ejemplo, cada instancia está atendiendo normalmente las solicitudes y no hay errores.
```
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 13.7 100.0 0.0 0.0 0.0 1.403 0.970 0.710 0.413 0.079
i-d581497d 2.4 100.0 0.0 0.0 0.0 1.102* 0.865 0.601 0.413 0.091
i-d481497c 2.7 100.0 0.0 0.0 0.0 0.842* 0.788 0.480 0.305 0.062
i-136e00c0 4.1 100.0 0.0 0.0 0.0 1.520* 1.088 0.883 0.524 0.104
i-126e00c1 2.2 100.0 0.0 0.0 0.0 1.334* 0.791 0.760 0.344 0.197
i-8b2cf575 2.3 100.0 0.0 0.0 0.0 1.162* 0.867 0.698 0.477 0.076
```
En la sección **cpu**, se muestran las métricas del sistema operativo de cada instancia. La salida difiere según el sistema operativo. A continuación, se muestra la salida para entornos Linux.
```
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-d581497d t2.micro 1a 12 mins 0.0 0.03 0.2 0.0 0.0 99.7 0.1
i-d481497c t2.micro 1a 12 mins 0.0 0.03 0.3 0.0 0.0 99.7 0.0
i-136e00c0 t2.micro 1b 12 mins 0.0 0.04 0.1 0.0 0.0 99.9 0.0
i-126e00c1 t2.micro 1b 12 mins 0.01 0.04 0.2 0.0 0.0 99.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.0 0.01 0.2 0.0 0.1 99.6 0.1
```
Esta es la salida para entornos Windows.
```
instance-id type az running % user time % privileged time % idle time
i-065716fba0e08a351 t2.large 1b 4 hours 0.2 0.0 99.8
```
Para obtener más información sobre las métricas del servidor y del sistema operativo mostradas, consulte [Métricas de la instancia](health-enhanced-metrics.md).
En la última sección, **deployments**, se muestra el estado de implementación de cada instancia. Si se produce un error en una implementación continua, puede utilizar el ID de implementación, el estado y la etiqueta de versión para identificar las instancias del entorno que están ejecutando la versión incorrecta.
```
instance-id status id version ago deployments
i-d581497d Deployed 1 Sample Application 12 mins
i-d481497c Deployed 1 Sample Application 12 mins
i-136e00c0 Deployed 1 Sample Application 12 mins
i-126e00c1 Deployed 1 Sample Application 12 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
## Vista de estado interactiva
El comando **eb health** muestra una instantánea del estado del entorno. Para actualizar la información que aparece cada 10 segundos, utilice la opción `--refresh`.
```
$ eb health --refresh
elasticBeanstalkExa-env Ok 2015-07-09 22:10:04 (1 secs)
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-bb65c145 Ok Application deployment completed 35 seconds ago and took 26 seconds
i-ba65c144 Ok Application deployment completed 17 seconds ago and took 25 seconds
i-f6a2d525 Ok Application deployment completed 53 seconds ago and took 26 seconds
i-e8a2d53b Ok Application deployment completed 32 seconds ago and took 31 seconds
i-e81cca40 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-bb65c145 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000
i-ba65c144 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000
i-f6a2d525 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000
i-e8a2d53b 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000
i-e81cca40 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-bb65c145 t2.micro 1a 12 mins 0.0 0.03 0.2 0.0 0.0 99.7 0.1
i-ba65c144 t2.micro 1a 12 mins 0.0 0.03 0.3 0.0 0.0 99.7 0.0
i-f6a2d525 t2.micro 1b 12 mins 0.0 0.04 0.1 0.0 0.0 99.9 0.0
i-e8a2d53b t2.micro 1b 12 mins 0.01 0.04 0.2 0.0 0.0 99.7 0.1
i-e81cca40 t2.micro 1c 1 hour 0.0 0.01 0.2 0.0 0.1 99.6 0.1
instance-id status id version ago deployments
i-bb65c145 Deployed 1 Sample Application 12 mins
i-ba65c144 Deployed 1 Sample Application 12 mins
i-f6a2d525 Deployed 1 Sample Application 12 mins
i-e8a2d53b Deployed 1 Sample Application 12 mins
i-e81cca40 Deployed 1 Sample Application 1 hour
(Commands: Help,Quit, ▼ ▲ ◄ ►)
```
En este ejemplo, se muestra un entorno que recientemente se ha escalado verticalmente de una a cinco instancias. La operación de escalado se hizo correctamente y todas las instancias están superando las comprobaciones de estado y están listas para atender solicitudes. En el modo interactivo, la información de estado se actualiza cada 10 segundos. En la esquina superior derecha, aparece un temporizador con la cuenta atrás hasta la siguiente actualización.
En la esquina inferior izquierda, aparece una lista de opciones. Para salir del modo interactivo, pulse **Q**. Para desplazarse, pulse las teclas de flecha. Para ver una lista de comandos adicionales, pulse **H**.
## Opciones de la vista de estado interactiva
Si utiliza la vista interactiva con el estado del entorno, puede utilizar las teclas del teclado para ajustar la vista e indicarle a Elastic Beanstalk que reemplace o reinicie determinada instancias. Para ver una lista de los comandos disponibles mientras consulta el informe de estado en modo interactivo, pulse **H**.
```
up,down,home,end Scroll vertically
left,right Scroll horizontally
F Freeze/unfreeze data
X Replace instance
B Reboot instance
<,> Move sort column left/right
-,+ Sort order descending/ascending
P Save health snapshot data file
Z Toggle color/mono mode
Q Quit this program
Views
1 All tables/split view
2 Status Table
3 Request Summary Table
4 CPU%/Load Table
H This help menu
(press Q or ESC to return)
```
# Informes de estado básicos
En este tema se explica la funcionalidad que ofrece el estado básico de Elastic Beanstalk.
AWS Elastic Beanstalk utiliza información de varias fuentes para determinar si su entorno está disponible y procesa las solicitudes de Internet. El estado de un entorno está representado por uno de los cuatro colores y se muestra en la página de [información general del entorno de la consola](environments-console.md) de Elastic Beanstalk. También está disponible en la [DescribeEnvironments](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.html)API y mediante llamadas **eb status** con la [CLI de EB](eb-cli3.md).
El sistema básico de informes de estado proporciona información sobre el estado de las instancias en un entorno de Elastic Beanstalk basada en comprobaciones de estado realizadas por Elastic Load Balancing para entornos con equilibrio de carga, o Amazon Elastic Compute Cloud para entornos de instancia única.
Además de comprobar el estado de las EC2 instancias, Elastic Beanstalk también supervisa los demás recursos de su entorno e informa de los recursos que faltan o están mal configurados, lo que puede provocar que su entorno deje de estar disponible para los usuarios.
Las métricas recopiladas por los recursos de su entorno se publican CloudWatch en Amazon en intervalos de cinco minutos. Esto incluye las métricas del sistema operativo y las métricas de EC2 solicitudes de Elastic Load Balancing. Puede ver los gráficos basados en estas CloudWatch métricas en la [página de monitoreo](environment-health-console.md) de la consola del entorno. En los informes básicos, no se utilizan estas métricas para determinar el estado del entorno.
**Topics**
+ [Colores de estado](#using-features.healthstatus.colors)
+ [Comprobaciones de estado de Elastic Load Balancing](#using-features.healthstatus.understanding)
+ [Comprobaciones de estado de entornos de la capa de trabajo y de una sola instancia](#monitoring-basic-healthcheck-singleinstance)
+ [Comprobaciones adicionales](#monitoring-basic-additionalchecks)
+ [CloudWatch Métricas de Amazon](#monitoring-basic-cloudwatch)
## Colores de estado
Elastic Beanstalk indica el estado de un entorno de servidor web en función de cómo la aplicación que se ejecuta en él responde a la comprobación de estado. Elastic Beanstalk utiliza cuatro colores para describir el estado, tal y como se muestra en la siguiente tabla:
****
| Color | Description (Descripción) |
| --- | --- |
| Gris | El entorno se está actualizando. |
| Green | El entorno ha superado la comprobación de estado más reciente. Al menos una instancia del entorno está disponible y atendiendo solicitudes. |
| Yellow | Su entorno no ha superado una o varias comprobaciones de estado. Algunas solicitudes del entorno no se han superado. |
| Red | El entorno no ha superado tres o más comprobaciones de estado o un recurso de entorno ha dejado de estar disponible. Las solicitudes se consideran erróneas. |
Estas descripciones solo se aplican a los entornos que utilizan informes de estado básicos. Consulte [Colores y estados](health-enhanced-status.md) para obtener información sobre los informes de estado avanzados.
## Comprobaciones de estado de Elastic Load Balancing
En un entorno con balanceo de carga, Elastic Load Balancing envía una solicitud a cada instancia del entorno cada 10 segundos para confirmar que se encuentran en buen estado. De forma predeterminada, el equilibrador de carga está configurado para abrir una conexión TCP en el puerto 80. Si la instancia reconoce la conexión, se considera que su estado es correcto.
Si lo desea, puede anular este ajuste especificando un recurso existente en la aplicación. Si especifica una ruta; por ejemplo, `/health`, la URL de comprobación de estado se establece en `HTTP:80/health`. La URL de comprobación de estado debe establecerse en una ruta que siempre esté atendida por la aplicación. Si se establece una página estática atendida o almacenada en caché por el servidor web que hay delante de la aplicación, las comprobaciones de estado no detectarán problemas con el servidor de aplicaciones ni el contenedor web. Para obtener instrucciones sobre la modificación de la URL de comprobación de estado, consulte [Chequeo de salud](environments-cfg-clb.md#using-features.managing.elb.healthchecks).
Si hay una URL de comprobación de estado configurada, Elastic Load Balancing espera que la solicitud GET que envía devuelva como respuesta `200 OK`. La aplicación no superará la comprobación de estado si no responde en un plazo de 5 segundos o si responde con cualquier otro código de estado HTTP. Después de 5 errores consecutivos de comprobación de estado, Elastic Load Balancing elimina la instancia fuera de servicio.
Para obtener más información acerca de las comprobaciones de estado de Elastic Load Balancing, consulte [Health Check (Comprobación de estado)](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/TerminologyandKeyConcepts.html#healthcheck) en la *Guía de usuario de Elastic Load Balancing*.
**nota**
Si se configura una URL de comprobación de estado, no se modifica el comportamiento de la comprobación de estado de los grupos de escalado automático del entorno. Una instancia en mal estado se elimina del balanceador de cargas, pero no se reemplaza automáticamente por Amazon EC2 Auto Scaling a menos que configure Amazon EC2 Auto Scaling para que utilice la comprobación de estado de Elastic Load Balancing como base para reemplazar las instancias. Para configurar Amazon EC2 Auto Scaling para reemplazar las instancias que no pasen una comprobación de estado de Elastic Load Balancing, consulte[Configuración de la comprobación de estado de escalado automático para su entorno de Elastic Beanstalk](environmentconfig-autoscaling-healthchecktype.md).
## Comprobaciones de estado de entornos de la capa de trabajo y de una sola instancia
En un entorno de instancia única o nivel de trabajo, Elastic Beanstalk determina el estado de la instancia mediante la supervisión del estado de la instancia de Amazon. EC2 La configuración de estado de Elastic Load Balancing, incluida la comprobación de estado de HTTP URLs, no se puede utilizar en estos tipos de entornos.
Para obtener más información sobre las comprobaciones de estado de las EC2 instancias de Amazon, consulta [Monitorización de instancias con comprobaciones de estado](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-system-instance-status-check.html) en la *Guía del EC2 usuario de Amazon*.
## Comprobaciones adicionales
Además de las comprobaciones de estado de Elastic Load Balancing, Elastic Beanstalk supervisa los recursos del entorno y cambia el estado a rojo si no se pueden implementar, no están configurados correctamente o dejan de estar disponibles. Estas comprobaciones confirman que:
+ El grupo de escalado automático del entorno está disponible y tiene al menos una instancia.
+ El grupo de seguridad del entorno está disponible y está configurado para permitir el tráfico entrante en el puerto 80.
+ El CNAME del entorno existe y apunta al equilibrador de carga correcto.
+ En un entorno del trabajador, la cola de Amazon Simple Queue Service (Amazon SQS) se sondea al menos una vez cada tres minutos.
## CloudWatch Métricas de Amazon
Con los informes de estado básicos, el servicio Elastic Beanstalk no publica ninguna métrica en Amazon. CloudWatch Los recursos de su entorno publican las CloudWatch métricas utilizadas para generar gráficos en la [página de monitoreo](environment-health-console.md) de la consola del entorno.
Por ejemplo, EC2 publica las siguientes métricas para las instancias del grupo Auto Scaling de su entorno:
`CPUUtilization`
Porcentaje de unidades de computación que no están en uso actualmente.
`DiskReadBytes``DiskReadOps``DiskWriteBytes``DiskWriteOps`
Número de bytes leídos y escritos, y número de las operaciones de lectura y escritura.
`NetworkIn``NetworkOut`
Número de bytes enviados y recibidos.
Elastic Load Balancing publica las siguientes métricas sobre el equilibrador de carga del entorno:
`BackendConnectionErrors`
Número de errores de conexión entre el equilibrador de carga y las instancias del entorno.
`HTTPCode_Backend_2XX``HTTPCode_Backend_4XX`
Número de códigos de respuesta correctos (2XX) y de errores de cliente (4XX) generados por las instancias del entorno.
`Latency`
Número de segundos entre el momento en el que el equilibrador de carga transmite una solicitud a una instancia y el momento en que se recibe la respuesta.
`RequestCount`
Número de solicitudes completadas.
Estas listas no están completas. Para obtener una lista completa de las métricas que se pueden informar para estos recursos, consulta los siguientes temas de la Guía para CloudWatch desarrolladores de Amazon:
**Métricas**
| Namespace | Topic |
| --- | --- |
| AWS::ElasticLoadBalancing::LoadBalancer | [Métricas y recursos de Elastic Load Balancing](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/elb-metricscollected.html) |
| AWS::AutoScaling::AutoScalingGrupo | [Métricas y recursos de Amazon Elastic Compute Cloud](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/ec2-metricscollected.html) |
| AWS::SQS::Queue | [Dimensiones y métricas de Amazon SQS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/sqs-metricscollected.html) |
| AWS: :RDS: DBInstance | [Dimensiones y métricas de Amazon RDS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/rds-metricscollected.html) |
### Métrica de estado del entorno de trabajo
Solo para entornos de trabajo, el daemon de SQS publica una métrica personalizada del estado del entorno hasta CloudWatch, donde el valor de 1 es verde. Puede revisar los datos de las métricas de CloudWatch estado de su cuenta mediante el `ElasticBeanstalk/SQSD` espacio de nombres. La dimensión de la métrica es `EnvironmentName` y el nombre de la métrica es `Health`. Todas las instancias publican sus métricas en el mismo espacio de nombres.
Si desea habilitar el daemon para publicar las métricas del entorno, el perfil de instancia del entorno debe tener permisos para llamar a `cloudwatch:PutMetricData`. Este permiso está incluido en el perfil de instancia predeterminado. Para obtener más información, consulte [Administración de perfiles de instancia de Elastic Beanstalk](iam-instanceprofile.md).
# Informes y monitoreo de estado mejorados de Elastic Beanstalk
En esta sección se explica la funcionalidad de la característica de estado mejorado de Elastic Beanstalk.
Los informes de estado mejorados son una función que puede habilitar en su entorno AWS Elastic Beanstalk para recopilar información adicional sobre los recursos de su entorno. Elastic Beanstalk analiza la información recopilada para proporcionar una imagen más completa del estado general del entorno y ayudar a identificar los problemas que pueden causar que su aplicación deje de estar disponible.
Además de cambiar el funcionamiento de la codificación por colores del estado, los informes de estado mejorados agregan un descriptor de *estado* que proporciona un indicador de la gravedad de los problemas detectados cuando un entorno tiene el color amarillo o rojo. Cuando haya más información disponible sobre el estado actual, puede elegir el botón **Causes** para ver información detallada sobre el estado en la [página Health](health-enhanced-console.md).
Para proporcionar información detallada sobre el estado de las instancias de Amazon EC2 que se ejecutan en su entorno, Elastic Beanstalk incluye un [agente de estado](#health-enhanced-agent) en la Imagen de Amazon Machine (AMI) para cada versión de plataforma que admite la funcionalidad de informes de estado avanzados. El agente de estado supervisa los logs del servidor web y las métricas del sistema, y envía esta información al servicio de Elastic Beanstalk. Elastic Beanstalk analiza estas métricas y datos de Elastic Load Balancing y Amazon EC2 escalado automático para proporcionar una imagen general del estado de un entorno.
Además de recopilar y presentar información sobre los recursos de su entorno, Elastic Beanstalk supervisa los recursos de su entorno en relación con varias condiciones de error y proporciona notificaciones que le ayudan a evitar los errores y resolver los problemas de configuración. Entre los [factores que influyen en el estado del entorno](#health-enhanced-factors) se incluyen los resultados de cada solicitud servida por la aplicación, las métricas del sistema operativo de las instancias y el estado de la implementación más reciente.
Puede ver el estado en tiempo real mediante la página de [información del entorno](health-enhanced-console.md) de la consola de Elastic Beanstalk o el [comando eb health](health-enhanced-ebcli.md) de la [interfaz de línea de comandos de Elastic Beanstalk (CLI de EB)](eb-cli3.md). Para registrar y realizar un seguimiento del estado del entorno y de las instancias a lo largo del tiempo, puede configurar su entorno para publicar la información recopilada por Elastic Beanstalk a fin de mejorar los informes de estado para CloudWatch Amazon como métricas personalizadas. CloudWatch [Los cargos](https://aws.amazon.com/cloudwatch/pricing/) por las métricas personalizadas se aplican a todas las demás métricas`EnvironmentHealth`, que son gratuitas.
**Notas sobre la plataforma de Windows**
Al habilitar los informes de estado avanzados en un entorno de Windows Server, no cambie [la configuración de registros de IIS](https://docs.microsoft.com/en-us/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis). Para que la supervisión de estado avanzados funcione correctamente, el registro IIS debe estar configurado con el formato **W3C** y los destinos de evento de registro **ETW event only (Solo evento ETW)** o **Both log file and ETW event (Tanto archivo de registro como evento ETW)**.
Además, no deshabilitar o detener el servicio de Windows [agente de estado de Elastic Beanstalk](#health-enhanced-agent) en cualquiera de las instancias de su entorno. Para recopilar y notificar información de estado avanzados en una instancia, este servicio debe estar habilitado y en ejecución.
La primera vez que cree un entorno, Elastic Beanstalk le pedirá que cree los roles necesarios y habilite los informes de estado mejorados de forma predeterminada. Siga leyendo para obtener más información acerca de cómo funcionan los informes de estado mejorados o consulte [Habilitación de informes de estado mejorado de Elastic Beanstalk](health-enhanced-enable.md) para empezar a utilizarlos inmediatamente.
**Topics**
+ [El agente de estado de Elastic Beanstalk](#health-enhanced-agent)
+ [Factores que determinan el estado de las instancias y del entorno](#health-enhanced-factors)
+ [Personalización de reglas de comprobación de estado](#health-enhanced.rules)
+ [Roles de estado mejorados](#health-enhanced-roles)
+ [Autorización de estado mejorada](#health-enhanced-authz)
+ [Eventos de estado mejorados](#health-enhanced-events)
+ [Comportamiento de los informes de estado mejorados durante las actualizaciones, implementaciones y escala](#health-enhanced-effects)
+ [Habilitación de informes de estado mejorado de Elastic Beanstalk](health-enhanced-enable.md)
+ [Supervisión del estado mejorado con la consola de administración del entorno](health-enhanced-console.md)
+ [Colores y estados](health-enhanced-status.md)
+ [Métricas de la instancia](health-enhanced-metrics.md)
+ [Configuración de las reglas de informes de estado avanzados de un entorno](health-enhanced-rules.md)
+ [Publicar métricas CloudWatch personalizadas de Amazon para un entorno](health-enhanced-cloudwatch.md)
+ [Uso de informes de estado mejorados con la API de Elastic Beanstalk](health-enhanced-api.md)
+ [Formato de los registros de estado avanzados](health-enhanced-serverlogs.md)
+ [Notificaciones y solución de problemas](environments-health-enhanced-notifications.md)
+ [Análisis del entorno impulsado por IA](health-ai-analysis.md)
## El agente de estado de Elastic Beanstalk
El agente de estado de Elastic Beanstalk es un proceso daemon (o un servicio, en entornos Windows) que se ejecuta en cada Amazon EC2 instance de su entorno para supervisar las métricas de estado del sistema operativo y la aplicación y registrar los problemas en Elastic Beanstalk. El agente de estado se incluye en todas las versiones de la plataforma Linux a partir de la versión 2.0 de cada plataforma.
El agente de estado informa de métricas similares a las [publicadas CloudWatch](using-features.healthstatus.md#monitoring-basic-cloudwatch) por Amazon EC2 Auto Scaling y Elastic Load Balancing como parte [de los informes de estado básicos](using-features.healthstatus.md), que incluyen la carga de la CPU, los códigos HTTP y la latencia. El agente de estado, sin embargo, registra las métricas directamente en Elastic Beanstalk, con mayor detalle y más a menudo que los informes de estado básicos.
Para los informes de estado básicos, estas métricas se publican cada cinco minutos y se pueden supervisar con gráficos en la consola de administración del entorno. Con un estado mejorado, el agente de estado de Elastic Beanstalk notifica métricas a Elastic Beanstalk cada 10 segundos. Elastic Beanstalk utiliza las métricas proporcionadas por el agente de estado para determinar el estado de cada instancia del entorno y, en combinación con otros [factores](#health-enhanced-factors), determinar el estado general del entorno.
El estado general del entorno se puede ver en tiempo real en la página de información general del entorno de la consola de Elastic Beanstalk, y Elastic Beanstalk lo publica CloudWatch cada 60 segundos. Puede ver métricas detalladas registradas por el agente de estado en tiempo real con el comando [**eb health**](health-enhanced-ebcli.md) de la [CLI de EB](eb-cli3.md).
Por un cargo adicional, puede optar por publicar métricas individuales a nivel de instancia y entorno cada 60 segundos. CloudWatch Las métricas publicadas en CloudWatch se pueden utilizar posteriormente para crear [gráficos de monitorización](environment-health-console.md#environment-health-console-customize) en la [ consola de administración del entorno](environments-console.md).
Los informes de estado mejorados solo se cobran si elige publicar métricas de estado mejoradas en CloudWatch. Cuando se utilizan los informes de estado mejorados, puede publicar igualmente las métricas de estado básicas de forma gratuita, aunque no decida publicar métricas de estado mejoradas.
Consulte [Métricas de la instancia](health-enhanced-metrics.md) para obtener más información sobre las métricas registradas por el agente de estado. Para obtener más información sobre cómo publicar métricas de salud mejoradas en CloudWatch, consulte. [Publicar métricas CloudWatch personalizadas de Amazon para un entorno](health-enhanced-cloudwatch.md)
## Factores que determinan el estado de las instancias y del entorno
Además de las comprobaciones del sistema de informes de estado básicos, incluida [Comprobaciones de estado de Elastic Load Balancing](using-features.healthstatus.md#using-features.healthstatus.understanding) y el [supervisión de recursos](using-features.healthstatus.md#monitoring-basic-additionalchecks), los informes de estado avanzados de Elastic Beanstalk recopilan datos adicionales sobre el estado de las instancias del entorno. Esto incluye las métricas del sistema operativo, los registros del servidor y el estado de las operaciones del entorno en curso, como las implementaciones y las actualizaciones. El servicio de informes de estado de Elastic Beanstalk combina la información de todos los orígenes disponibles y la analiza para determinar el estado general del entorno.
### Operaciones y comandos
Cuando realiza una operación en su entorno, como implementar una nueva versión de una aplicación, Elastic Beanstalk realiza varios cambios que afectan al estado del entorno.
Por ejemplo, cuando implementa una nueva versión de una aplicación en un entorno que ejecuta varias instancias, es posible que vea mensajes similares a los siguientes cuando supervise el estado del entorno [con la CLI de EB](health-enhanced-ebcli.md).
```
id status cause
Overall Info Command is executing on 3 out of 5 instances
i-bb65c145 Pending 91 % of CPU is in use. 24 % in I/O wait
Performing application deployment (running for 31 seconds)
i-ba65c144 Pending Performing initialization (running for 12 seconds)
i-f6a2d525 Ok Application deployment completed 23 seconds ago and took 26 seconds
i-e8a2d53b Pending 94 % of CPU is in use. 52 % in I/O wait
Performing application deployment (running for 33 seconds)
i-e81cca40 Ok
```
En este ejemplo, el estado general del entorno es `Ok` y la causa de este estado es que el *comando está ejecutando 3 de 5 instancias*. Tres de las instancias del entorno tienen el estado *Pending*, lo que indica que una operación está en curso.
Cuando se completa una operación, Elastic Beanstalk registra información adicional sobre la operación. En el ejemplo, Elastic Beanstalk muestra la siguiente información sobre una instancia que ya se ha actualizado con la nueva versión de la aplicación:
```
i-f6a2d525 Ok Application deployment completed 23 seconds ago and took 26 seconds
```
La información de estado de la instancia incluye también detalles sobre la implementación más reciente en cada instancia del entorno. Cada instancia registra un ID y un estado de implementación. El ID de implementación es un entero que aumenta en uno cada vez que implementa una nueva versión de la aplicación o cambia las opciones de configuración de una instancia como las variables de entorno. Puede utilizar la información de implementación para identificar las instancias que ejecutan la versión incorrecta de la aplicación después de una [implementación continua](using-features.rolling-version-deploy.md) que ha producido un error.
En la columna de causa, Elastic Beanstalk incluye mensajes informativos sobre las operaciones realizadas correctamente y otros estados correctos de varias comprobaciones de estado, pero esta información no se conserva de forma indefinida. Las causas de los estados del entorno incorrectos se mantienen hasta que el entorno vuelve a tener un estado correcto.
### Tiempo de espera del comando
Elastic Beanstalk aplica un tiempo de espera del comando desde el momento en que comienza una operación para permitir la transición de una instancia a un estado correcto. Este tiempo de espera se establece en la configuración de la actualización e implementación del entorno (en el espacio de nombres [aws:elasticbeanstalk:command](command-options-general.md#command-options-general-elasticbeanstalkcommand)) y su valor predeterminado es de 10 minutos.
Durante las actualizaciones continuas, Elastic Beanstalk aplica un tiempo de espera distinto a cada lote de la operación. Este tiempo de espera se establece como parte de la configuración de las actualizaciones continuas del entorno (en el espacio de nombres [aws:autoscaling:updatepolicy:rollingupdate](command-options-general.md#command-options-general-autoscalingupdatepolicyrollingupdate)). Si todas las instancias del lote están en buen estado dentro del tiempo de espera de la implementación, la operación continúa con el siguiente lote. De lo contrario, la operación produce un error.
**nota**
Si la aplicación no supera las comprobaciones de estado con el estado **OK** pero está estable en otro nivel, puede definir la opción `HealthCheckSuccessThreshold` en el espacio de nombres [`aws:elasticbeanstalk:command namespace`](command-options-general.md#command-options-general-elasticbeanstalkcommand) para cambiar el nivel en el que Elastic Beanstalk considera que una instancia está en buen estado.
Para que un entorno de servidor web se considere que está en buen estado, cada instancia del entorno o lote debe superar 12 comprobaciones de estado consecutivas en el transcurso de dos minutos. Para el entorno de una capa de trabajo, cada instancia debe superar 18 comprobaciones de estado. Antes de que se agote el tiempo de espera del comando, Elastic Beanstalk no rebaja el estado del entorno cuando no se superan las comprobaciones de estado. Si las instancias del entorno estén en buen estado durante el tiempo de espera del comando, la operación se realizará correctamente.
### Solicitudes HTTP
Cuando no hay ninguna operación en curso en un entorno, la fuente principal de información sobre el estado de las instancias y del entorno son los logs del servidor web de cada instancia. Para determinar el estado de una instancia y el estado general del entorno, Elastic Beanstalk considera el número de solicitudes, el resultado de cada solicitud y la velocidad a la que se resolvió cada solicitud.
En las plataformas basadas en Linux, Elastic Beanstalk lee y analiza los logs del servidor web para obtener información sobre las solicitudes HTTP. En la plataforma Windows Server, Elastic Beanstalk recibe esta información [directamente del servidor web de IIS](health-enhanced-metrics-server-iis.md).
Puede que su entorno no tenga un servidor web activo. Por ejemplo, la plataforma Docker Multicontainer no incluye un servidor web. Otras plataformas incluyen un servidor web y su aplicación podría deshabilitarlo. En estos casos, el entorno requiere configuración adicional para proporcionar al [agente de estado de Elastic Beanstalk](#health-enhanced-agent) los registros en el formato que se necesita para transmitir la información de estado al servicio de Elastic Beanstalk. Para obtener más información, consulte [Formato de los registros de estado avanzados](health-enhanced-serverlogs.md).
### Métricas del sistema operativo
Elastic Beanstalk supervisa las métricas del sistema operativo registradas por el agente de estado para identificar las instancias que se quedan sin recursos del sistema de forma sistemática.
Consulte [Métricas de la instancia](health-enhanced-metrics.md) para obtener más información sobre las métricas registradas por el agente de estado.
## Personalización de reglas de comprobación de estado
Los informes de estado avanzados de Elastic Beanstalk se basan en un conjunto de reglas para determinar el estado de su entorno. Algunas de estas reglas podrían no ser adecuadas para su aplicación específica. Un caso común es una aplicación que devuelve frecuentes errores HTTP 4xx por diseño. Elastic Beanstalk con una de sus reglas predeterminadas, llega a la conclusión de que algo va mal y cambia el estado del entorno OK (Correcto) a Warning (Advertencia), Degraded (Degradado) o Severe (Grave), en función del porcentaje de errores. Para administrar este caso correctamente, Elastic Beanstalk le permite configurar esta regla y hacer caso omiso de los errores HTTP 4xx de la aplicación. Para obtener más información, consulte [Configuración de las reglas de informes de estado avanzados de un entorno](health-enhanced-rules.md).
## Roles de estado mejorados
Los informes de estado mejorados requieren dos roles: un rol de servicio para Elastic Beanstalk y un perfil de instancia para el entorno. El rol de servicio permite a Elastic Beanstalk interactuar AWS con otros servicios en su nombre para recopilar información sobre los recursos de su entorno. El perfil de instancia permite que las instancias del entorno escriban registros en Amazon S3 y comuniquen información de estado mejorada al servicio de Elastic Beanstalk.
Cuando se crea un entorno de Elastic Beanstalk mediante la consola de Elastic Beanstalk o la CLI de EB, Elastic Beanstalk crea un rol de servicio predeterminado y adjunta las políticas administradas necesarias a un perfil de instancia predeterminado para su entorno.
Si utiliza la API, un SDK o el AWS CLI para crear entornos, debe crear estas funciones con antelación y especificarlas durante la creación del entorno para aprovechar el estado mejorado. Para obtener instrucciones sobre cómo crear los roles adecuados para sus entornos, consulte [Roles de servicio, perfiles de instancia y políticas de usuario de Elastic Beanstalk](concepts-roles.md).
Se recomienda utilizar *políticas administradas* para el perfil de instancia y el rol de servicio. Las políticas administradas son políticas AWS Identity and Access Management (IAM) que mantiene Elastic Beanstalk. El uso de políticas administradas garantiza que el entorno tenga todos los permisos necesarios para funcionar correctamente.
Para el perfil de instancia, puede utilizar la política administrada `AWSElasticBeanstalkWebTier` o `AWSElasticBeanstalkWorkerTier`, para un entorno de [nivel de servidor web](concepts-webserver.md) o de [nivel de trabajo](concepts-worker.md) respectivamente. Para obtener más información acerca de estas dos políticas de perfil de instancia administrada, consulte [Administración de perfiles de instancia de Elastic Beanstalk](iam-instanceprofile.md).
## Autorización de estado mejorada
Las políticas administradas por el perfil de instancias de Elastic Beanstalk contienen permisos para la `elasticbeanstalk:PutInstanceStatistics` acción . Esta acción no forma parte de la API de Elastic Beanstalk. Forma parte de una API diferente que las instancias de entorno utilizan de manera interna para comunicar información de estado mejorada al servicio de Elastic Beanstalk. No se llama directamente a esta API.
Cuando crea un nuevo entorno, la autorización para la acción `elasticbeanstalk:PutInstanceStatistics` está habilitada de forma predeterminada. Con el fin de aumentar la seguridad del entorno y evitar la suplantación de datos de estado en su nombre, recomendamos mantener habilitada la autorización para esta acción. Si utiliza políticas administradas para el perfil de instancias, esta característica está disponible en el nuevo entorno sin necesidad de configuraciones adicionales. Sin embargo, si utiliza un *perfil de instancias personalizado* en lugar de una *política administrada*, el entorno podría mostrar un estado **sin datos**. Esto ocurre porque las instancias no están autorizadas para la acción que comunica datos de estado mejorados al servicio.
Para autorizar la acción, incluya la siguiente instrucción en su perfil de instancia.
```
{
"Sid": "ElasticBeanstalkHealthAccess",
"Action": [
"elasticbeanstalk:PutInstanceStatistics"
],
"Effect": "Allow",
"Resource": [
"arn:aws:elasticbeanstalk:*:*:application/*",
"arn:aws:elasticbeanstalk:*:*:environment/*"
]
}
```
Si no desea utilizar la autorización de estado mejorada en este momento, desactívela configurando la opción `EnhancedHealthAuthEnabled` en el espacio de nombre [aws:elasticbeanstalk:healthreporting:system](command-options-general.md#command-options-general-elasticbeanstalkhealthreporting) como `false`. Si esta opción está desactivada, los permisos descritos anteriormente no son necesarios. Puede eliminarlos del perfil de instancia para [ acceso a los privilegios mínimos](security-best-practices.md#security-best-practices.preventive.least-priv) en sus aplicaciones y entornos.
**nota**
Anteriormente, la configuración predeterminada para `EnhancedHealthAuthEnabled` era `false`, lo que dio lugar a que la autorización de la acción `elasticbeanstalk:PutInstanceStatistics` también se deshabilitara de forma predeterminada. A fin de habilitar esta acción para un entorno existente, configure la opción `EnhancedHealthAuthEnabled` en el espacio de nombres [aws:elasticbeanstalk:healthreporting:system](command-options-general.md#command-options-general-elasticbeanstalkhealthreporting) en `true`. Puede configurar esta opción utilizando una [configuración de opción](ebextensions-optionsettings.md) en un [archivo de configuración](ebextensions.md).
## Eventos de estado mejorados
El sistema de informes de estado mejorados genera eventos cuando un entorno cambia de un estado a otro. El siguiente ejemplo muestra los eventos generados por un entorno que pasa por los estados **Info**, **OK** y **Severe**.
![\[La página de información general del entorno de Elastic Beanstalk de la consola de Elastic Beanstalk muestra eventos recientes de estado mejorado\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-events.png)
Cuando el entorno pasa a un estado peor, el evento de estado avanzado incluye un mensaje que indica la causa de la transición.
No todos los cambios en el estado a nivel de instancia hacen que Elastic Beanstalk emita un evento. Para evitar falsas alarmas, Elastic Beanstalk solo genera un evento relacionado con el estado si el problema persiste en varias comprobaciones.
La información de estado del entorno en tiempo real, incluido el estado, el color y la causa, está disponible en la página de [información general del entorno](environments-dashboard.md) de la consola de Elastic Beanstalk y en la [CLI de EB](eb-cli3.md). Si asocia la CLI de EB a su entorno y ejecuta el comando [**eb health**](health-enhanced-ebcli.md), también puede consultar el estado en tiempo real de cada una de las instancias de su entorno.
## Comportamiento de los informes de estado mejorados durante las actualizaciones, implementaciones y escala
Si se habilitan los informes de estado mejorados, el comportamiento del entorno durante las actualizaciones de configuración y las implementaciones puede resultar afectado. Elastic Beanstalk no completará un lote de actualizaciones hasta que todas las instancias superen las comprobaciones de estado de forma consistente. Además, ya que los informes de estado avanzados aplican un listón más alto para considerar que están en buen estado y supervisan otros factores, las instancias que superen la [comprobación de estado ELB](using-features.healthstatus.md#using-features.healthstatus.understanding) de los informes de estado básicos no superarán necesariamente la comprobación de estado de los informes de estado avanzados. Consulte los temas sobre las [actualizaciones de configuración continuas](using-features.rollingupdates.md) y las [implementaciones continuas](using-features.rolling-version-deploy.md) para obtener más información acerca de cómo las comprobaciones de estado afectan al proceso de actualización.
Los informes de estado mejorados también pueden poner de manifiesto la necesidad de definir una [URL de comprobación de estado](environments-cfg-clb.md#using-features.managing.elb.healthchecks) correcta para Elastic Load Balancing. Cuando su entorno se amplía para satisfacer la demanda, las nuevas instancias comienzan a recibir solicitudes en cuanto superan suficientes comprobaciones de estado de ELB. Si no se configura una URL de comprobación de estado, este plazo de tiempo puede ser de tan solo 20 segundos una vez que la instancia es capaz de aceptar una conexión TCP.
Si la aplicación no ha terminado de iniciarse en el momento en que el equilibrador de carga considera que tiene un estado lo suficientemente bueno como para recibir tráfico, verá un flujo de solicitudes fallidas, y su entorno empezará a no superar las comprobaciones de estado. Una URL de comprobación de estado que encuentre una ruta a la que sirve su aplicación puede evitar este problema. Las comprobaciones de estado de ELB no se superarán hasta que una solicitud GET a la URL de comprobación de estado devuelva un código de estado 200.
# Habilitación de informes de estado mejorado de Elastic Beanstalk
En este tema se explica cómo se habilitan los informes de salud mejorados. Proporciona procedimientos para habilitar la característica de estado mejorada en su entorno con la consola de Elastic Beanstalk, la CLI de EB y una configuración de .ebextensions.
Los nuevos entornos creados con las [versiones más recientes de la plataforma](concepts.platforms.md) incluyen el [agente de AWS Elastic Beanstalk salud](health-enhanced.md#health-enhanced-agent), que permite mejorar los informes de salud. Si crea el entorno en la consola de Elastic Beanstalk o la CLI de EB, el sistema de estado avanzado está habilitado de forma predeterminada. También puede establecer sus preferencias respecto a los informes de estado en el código fuente de la aplicación a través de los [archivos de configuración](ebextensions.md).
Los informes de estado avanzados necesitan un [perfil de instancia](concepts-roles-instance.md) y un [rol de servicio](concepts-roles-service.md) con el conjunto de permisos estándar. Cuando se crea un entorno en la consola de Elastic Beanstalk, Elastic Beanstalk crea automáticamente los roles necesarios. Consulte [Cómo empezar a utilizar Elastic Beanstalk](GettingStarted.md) para obtener instrucciones sobre cómo crear el primer entorno.
**Topics**
+ [Habilitación de informes de estado mejorados mediante la consola de Elastic Beanstalk](#health-enhanced-enable-console)
+ [Activación de informes de estado avanzados con la CLI de EB](#health-enhanced-enable-ebcli)
+ [Activación de informes de estado avanzados con un archivo de configuración](#health-enhanced-enable-config)
## Habilitación de informes de estado mejorados mediante la consola de Elastic Beanstalk
**Para habilitar los informes de estado avanzados en un entorno en ejecución con la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, elija **Configuration (Configuración)**.
1. En la categoría de configuración **Monitoring (Supervisión)**, seleccione **Edit (Edición de)**.
1. En **Health reporting (Informes de estado)**, para **System (Sistema)**, seleccione **Enhanced (Mejorado)**.
**nota**
Las opciones para los informes de estado avanzados no aparecerán si utiliza una [plataforma o versión que no es compatible](health-enhanced.md).
1. Para guardar los cambios, elija **Aplicar** en la parte inferior de la página.
La consola de Elastic Beanstalk establece los valores predeterminados de los informes de estado avanzados cuando crea un nuevo entorno con una versión de plataforma número 2 (v2). Puedes desactivar los informes de estado avanzados cambiando la opción correspondiente durante la creación del entorno.
**Para deshabilitar los informes de estado avanzados al crear un entorno a través de la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. [Cree una aplicación](applications.md) o seleccione una existente.
1. [Creación de un entorno](using-features.environments.md). En la página **Create a new environment (Creación de un nuevo entorno)**, antes de elegir **Create environment (Creación de entorno)**, elija **Configure more options (Configuración de más opciones)**.
1. En la categoría de configuración **Monitoring (Supervisión)**, seleccione **Edit (Edición de)**.
1. En **Health reporting (Informes de estado)**, para **System (Sistema)**, seleccione **Basic (Básico)**.
1. Seleccione **Save**.
## Activación de informes de estado avanzados con la CLI de EB
Si crea un nuevo entorno con el comando **eb create**, la CLI de EB habilitará los informes de estado avanzados de forma predeterminada y aplicará el perfil de instancia y el rol de servicio predeterminados.
Puede especificar un rol de servicio distinto utilizando su nombre con la opción `--service-role`.
Si tiene un entorno de datos que se ejecuta con informes de estado básicos en una versión de plataforma versión 2 y desea cambiar a los informes avanzados, siga estos pasos.
**Para habilitar el sistema de estado avanzado en un entorno en ejecución con la [CLI de EB](eb-cli3.md)**
1. Utilice el comando **eb config** para abrir el archivo de configuración en el editor de texto predeterminado.
```
~/project$ eb config
```
1. Busque el espacio de nombres `aws:elasticbeanstalk:environment` en la sección de configuración. Asegúrese de que el valor de `ServiceRole` no es nulo y que coincide con el nombre del [rol de servicio](concepts-roles-service.md).
```
aws:elasticbeanstalk:environment:
EnvironmentType: LoadBalanced
ServiceRole: aws-elasticbeanstalk-service-role
```
1. En el espacio de nombres `aws:elasticbeanstalk:healthreporting:system:`, cambie el valor de `SystemType` a **enhanced**.
```
aws:elasticbeanstalk:healthreporting:system:
SystemType: enhanced
```
1. Guarde el archivo de configuración y cierre el editor de texto.
1. La CLI de EB inicia una actualización del entorno para aplicar los cambios de configuración. Espere a que la operación se complete o pulse **Ctrl\$1C** para salir de forma segura.
```
~/project$ eb config
Printing Status:
INFO: Environment update is starting.
INFO: Health reporting type changed to ENHANCED.
INFO: Updating environment no-role-test's configuration settings.
```
## Activación de informes de estado avanzados con un archivo de configuración
Puede habilitar los informes de estado avanzados incluyendo un [archivo de configuración](ebextensions.md) en el paquete de origen. En el ejemplo siguiente, se muestra un archivo de configuración que habilita los informes de estado avanzados y asigna el rol de servicio y el perfil de instancia predeterminados al entorno:
**Example .ebextensions/enhanced-health.config**
```
option_settings:
aws:elasticbeanstalk:healthreporting:system:
SystemType: enhanced
aws:autoscaling:launchconfiguration:
IamInstanceProfile: aws-elasticbeanstalk-ec2-role
aws:elasticbeanstalk:environment:
ServiceRole: aws-elasticbeanstalk-service-role
```
Si creó su propio perfil de instancia o su propio rol de servicio, cambie el texto resaltado por los nombres de estos roles.
# Supervisión del estado mejorado con la consola de administración del entorno
Al activar los informes de estado mejorados AWS Elastic Beanstalk, puede supervisar el estado del entorno en la [consola de administración del entorno](environments-console.md).
**Topics**
+ [Descripción general del entorno](#health-enhanced-console-overview)
+ [Página de estado del entorno](#health-enhanced-console-healthpage)
+ [Página Monitoring (Supervisión)](#health-enhanced-console-monitoringpage)
## Descripción general del entorno
La [información general del entorno](environments-dashboard.md) muestra el [estado](health-enhanced-status.md) del entorno y enumera los eventos que proporcionan información sobre los últimos cambios en el estado.
**Para ver la información general del entorno**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
Para obtener información detallada sobre el estado del entorno actual, abra la página **Health (Estado)** eligiendo **Causes (Causas)**. O bien, en el panel de navegación, seleccione **Health (Estado)**.
## Página de estado del entorno
La página **Health** muestra el estado de salud, las métricas y las causas del entorno y de cada EC2 instancia de Amazon del entorno.
**nota**
Elastic Beanstalk muestra la página **Health (Estado)** solo si ha [habilitado la supervisión de estado mejorado](health-enhanced-enable.md) para el entorno.
La imagen siguiente muestra la página **Health (Estado)** de un entorno Linux.
![\[La página de estado del entorno de un entorno Linux\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-instances.png)
La imagen siguiente muestra la página **Health (Estado)** de un entorno Windows. Tenga en cuenta que las métricas de CPU son diferentes de las de un entorno Linux.
![\[Página de estado de un entorno Windows\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-instances-win.png)
En la parte superior de la página puede ver el número total de instancias del entorno, así como el número de instancias por estado. Para mostrar únicamente las instancias que tienen un determinado estado, seleccione **Filter By (Filtrar por)** y, a continuación, seleccione un [estado](health-enhanced-status.md).
![\[Página de estado del entorno que muestra el filtro por menú para seleccionar un estado de instancia que mostrar\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-instances-status.png)
Para reiniciar o terminar una instancia en mal estado, seleccione **Instance Actions** y después elija **Reboot** o **Terminate**.
![\[Página de estado del entorno que muestra el menú de acciones de instancia para reiniciar o finalizar instancias con estado incorrecto.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-instances-actions.png)
Elastic Beanstalk actualiza la página **Estado** cada 10 segundos. Registra información sobre el estado del entorno y las instancias.
Para cada EC2 instancia de Amazon del entorno, la página muestra el ID y el [estado](health-enhanced-status.md) de la instancia, el tiempo transcurrido desde el lanzamiento de la instancia, el ID de la implementación más reciente ejecutada en la instancia, las respuestas y la latencia de las solicitudes atendidas por la instancia, y la información de carga y uso de la CPU. La fila **Overall (Información global)** muestra información sobre la respuesta y la latencia promedio de todo el entorno.
La página muestra mucha información en una tabla muy amplia. Para ocultar algunas de las columnas, seleccione ![\[the cog icon.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/cog.png) (**Preferences (Preferencias)**). Marque o desmarque los nombres de las columnas y, a continuación, seleccione **Confirm (Confirmar)**.
![\[Selección de columnas para mostrar en la página de estado del entorno\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-console-preferences.png)
Seleccione el **Instance ID (ID de instancia)** de cualquier instancia para ver más información sobre esta, incluida la zona de disponibilidad y el tipo de instancia.
![\[Métricas del servidor en la página de estado del entorno con información sobre la instancia\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-console-instance.png)
Seleccione el **Deployment ID (ID de implementación)** de cualquier instancia para ver información sobre la última [implementación](using-features.deploy-existing-version.md) llevada a cabo en la instancia.
![\[Métricas del servidor en la página de estado del entorno con información sobre la implementación\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-console-deployment.png)
La información de implementación incluye lo siguiente:
+ **Deployment ID (ID de implementación)**: el identificador único de la [implementación](using-features.deploy-existing-version.md). IDs El despliegue comienza en 1 y aumenta en uno cada vez que se implementa una nueva versión de la aplicación o se cambian los ajustes de configuración que afectan al software o al sistema operativo que se ejecuta en las instancias de su entorno.
+ **Version (Versión)**: la etiqueta de versión del código fuente de la aplicación usada en la implementación.
+ **Status (Estado)**: el estado de la implementación, que puede ser `In Progress`, `Deployed` o `Failed`.
+ **Time (Hora)**: para las implementaciones en curso, la hora a la que se inició la implementación. Para las implementaciones completadas, el momento en que finalizó la implementación.
Si [habilita la integración de X-Ray](environment-configuration-debugging.md) en su entorno e instrumenta su aplicación con el AWS X-Ray SDK, la página **Health** agrega enlaces a la AWS X-Ray consola en la fila de información general.
![\[Métricas de solicitud en la página de estado del entorno\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-console-xray.png)
Elija un enlace para ver los seguimientos relacionados con la estadística resaltada en la AWS X-Ray consola.
## Página Monitoring (Supervisión)
La página **Monitorización** muestra estadísticas resumidas y gráficos de las CloudWatch métricas personalizadas de Amazon generadas por el sistema mejorado de informes de salud. Consulte [Supervisión del estado del entorno en la consola AWS de administración](environment-health-console.md) para obtener instrucciones sobre cómo añadir gráficos y estadísticas a esta página.
# Colores y estados
Los informes de estado avanzados representan el estado de la instancia y el estado general del entorno con cuatro colores, al igual que en los [informes de estado básicos](using-features.healthstatus.md). Los informes de estado avanzados también cuentan con siete estados, que son descriptores formados por una palabra que proporcionan una indicación más detallada del estado del entorno.
## Estado de la instancia y estado del entorno
Cada vez que Elastic Beanstalk ejecuta una comprobación de estado en el entorno, los informes de estado avanzados comprueban el estado de cada instancia del entorno analizando todos [los datos](health-enhanced.md#health-enhanced-factors) disponibles. Si falla alguna comprobación de nivel inferior, Elastic Beanstalk rebaja la salud de la instancia.
Elastic Beanstalk muestra la información de estado de todo el entorno (color, estado y causa) en la [consola de administración del entorno](environments-console.md). Esta información también está disponible en la CLI de EB. Los mensajes sobre el estado y las causas de cada instancia se actualizan cada 10 segundos y están disponibles en la [CLI de EB](eb-cli3.md) cuando se consulta el estado con [**eb health**](health-enhanced-ebcli.md).
Elastic Beanstalk utiliza los cambios en los estados de las instancias para evaluar el estado del entorno, pero no modifica inmediatamente el estado de este. Cuando una instancia no supera una comprobación de estado al menos tres veces en un minuto, Elastic Beanstalk rebaja el estado del entorno. En función del número de instancias del entorno y el problema identificado, una instancia con un estado incorrecto puede hacer que Elastic Beanstalk muestre un mensaje informativo o que cambie el estado del entorno de verde (**OK (Bueno)**) a amarillo (**Warning (Alerta)**) o a rojo (**Degraded (Degradado)** o **Severe (Grave)**).
## OK (verde)
Este estado se muestra cuando:
+ Una instancia está superando las comprobaciones de estado y el agente de estado no informa de ningún problema.
+ La mayoría de las instancias del entorno están superando las comprobaciones de estado y el agente de estado no informa de ningún problema importante.
+ Una instancia está superando las comprobaciones de estado y completando las solicitudes con normalidad.
*Ejemplo:* el entorno se ha implementado recientemente y está aceptando las solicitudes con normalidad. El cinco por ciento de las solicitudes devuelve errores de la serie 400. La implementación se completó normalmente en cada instancia.
*Mensaje (instancia):* la implementación de la aplicación se completó hace 23 segundos y tardó 26 segundos.
## Warning (amarillo)
Este estado se muestra cuando:
+ El agente de estado está notificando un número moderado de solicitudes erróneas u otros problemas en una instancia o en el entorno.
+ Hay una operación en curso en una instancia y está tardando mucho.
*Ejemplo:* una instancia del entorno tiene el estado **Severe**.
*Mensaje (entorno):* hay servicios dañados en 1 de 5 instancias.
## Degraded (rojo)
El estado se muestra cuando el agente de estado está notificando un número elevado de solicitudes erróneas u otros problemas en una instancia o en el entorno.
*Ejemplo:* el entorno está en un proceso de escalado vertical de hasta 5 instancias.
*Mensaje (entorno)*: el número de instancias activas (4) es inferior al tamaño mínimo del grupo de escalado automático (5).
## Severe (rojo)
El estado se muestra cuando el agente de estado está notificando un número muy elevado de solicitudes erróneas u otros problemas en una instancia o en el entorno.
*Ejemplo:* Elastic Beanstalk no puede ponerse en contacto con el equilibrador de carga para obtener el estado de la instancia.
*Mensaje (entorno):* el estado de ELB no es correcto o no está disponible en todas las instancias. Ninguna de las instancias está enviando datos. No se puede asumir el rol «arn:aws:iam: :123456789012:role/». aws-elasticbeanstalk-service-role Compruebe que el rol existe y está configurado correctamente.
*Mensaje (instancias):* hace 37 minutos que el estado de ELB de la instancia no está disponible. No hay datos. La última consulta es de hace 37 minutos.
## Info (verde)
Este estado se muestra cuando:
+ Hay una operación en curso en una instancia.
+ Una operación está en curso en varias instancias de un entorno.
*Ejemplo:* se está implementando una nueva versión de la aplicación en instancias que están en ejecución.
*Mensaje (entorno):* el comando se está ejecutando en 3 de 5 instancias.
*Mensaje (instancia):* implementación de la aplicación en curso (en ejecución durante 3 segundos).
## Pending (gris)
Este estado se muestra cuando hay una operación en curso en una instancia dentro del [periodo de espera del comando](health-enhanced.md#health-enhanced-factors-timeout).
*Ejemplo:* ha creado recientemente el entorno y se están arrancando las instancias.
*Mensaje:* inicialización en curso (en ejecución durante 12 segundos).
## Unknown (gris)
Este estado se muestra cuando Elastic Beanstalk y el agente de estado notifican que hay una cantidad insuficiente de datos en una instancia.
*Ejemplo:* no se están recibiendo datos.
## Suspendido (gris)
Este estado se muestra cuando Elastic Beanstalk detiene la supervisión del estado del entorno. Es posible que el entorno no funcione correctamente. Algunas condiciones de estado graves, si duran mucho tiempo, provocan que Elastic Beanstalk cambie el entorno al estado **Suspendido**.
*Ejemplo:* Elastic Beanstalk no puede acceder al [rol de servicio](iam-servicerole.md)del entorno.
*Ejemplo:* se ha eliminado el [grupo de escalado automático](using-features.managing.as.md) creado por Elastic Beanstalk para el entorno.
*Mensaje:* El estado del entorno ha cambiado de **OK** a **Severe**. No hay instancias. La capacidad deseada del grupo de escalado automático se ha configurado en 1.
# Métricas de la instancia
Las métricas de instancia proporcionan información acerca del estado de las instancias en el entorno. El [agente de estado de Elastic Beanstalk](health-enhanced.md#health-enhanced-agent) se ejecuta en cada instancia. Recopila métricas de las instancias y las envía a Elastic Beanstalk, que las analiza para determinar el estado de las instancias de los entornos.
El agente de estado de Elastic Beanstalk en la instancia recopila métricas sobre las instancias de los servidores web y del sistema operativo. Para obtener información de servidor web sobre plataformas basadas en Linux, Elastic Beanstalk lee y analiza los registros del servidor web. En la plataforma Windows Server, Elastic Beanstalk recibe esta información directamente del servidor web de IIS. Los servidores web proporcionan información sobre las solicitudes HTTP entrantes: cuántas solicitudes llegaron, cuántas generaron errores y cuánto tiempo tardaron en resolverse. El sistema operativo proporciona información instantánea sobre el estado de los recursos de las instancias: la carga de CPU y la distribución del tiempo empleado en cada tipo de proceso.
El agente de estado recopila las métricas del servidor web y el sistema operativo y las transmite a Elastic Beanstalk cada 10 segundos. Elastic Beanstalk analiza los datos y utiliza los resultados para actualizar el estado de cada instancia y del entorno.
**Topics**
+ [Métricas del servidor web](#health-enhanced-metrics-server)
+ [Métricas del sistema operativo](#health-enhanced-metrics-os)
+ [Captura de métricas de servidor web en IIS en Windows Server](health-enhanced-metrics-server-iis.md)
## Métricas del servidor web
En las plataformas basadas en Linux, el agente de estado de Elastic Beanstalk consulta las métricas del servidor web en los registros generados por el contenedor web o el servidor que procesa las solicitudes en cada instancia del entorno. Las plataformas Elastic Beanstalk están configuradas para generar dos registros: uno en lenguaje natural y otro en lenguaje de máquina. El agente de estado retransmite registros legibles por máquina a Elastic Beanstalk cada 10 segundos.
Para obtener más información sobre el formato de registro utilizado por Elastic Beanstalk, consulte [Formato de los registros de estado avanzados](health-enhanced-serverlogs.md).
En la plataforma Windows Server, Elastic Beanstalk agrega un módulo a la canalización de peticiones del servidor web IIS y captura métricas sobre los tiempos de petición HTTP y los códigos de respuesta. El módulo envía estas métricas al agente de estado en la instancia mediante un canal de comunicación entre procesos (IPC) de alto rendimiento. Para conocer los detalles de implementación, consulte [Captura de métricas de servidor web en IIS en Windows Server](health-enhanced-metrics-server-iis.md).Métricas del servidor web notificadas
`RequestCount`
Número de solicitudes administradas por el servidor web por segundo durante los últimos 10 segundos. Se muestra como un valor medio `r/sec` (solicitudes por segundo) en la CLI de EB y en [Página de estado del entorno](health-enhanced-console.md#health-enhanced-console-healthpage).
`Status2xx``Status3xx``Status4xx``Status5xx`
Número de solicitudes que generaron cada tipo de código de estado durante los últimos 10 segundos. Por ejemplo, las solicitudes correctas devuelven 200 OK, las solicitudes redireccionadas devuelven 301 y, si la URL especificada no coincide con ningún recurso de la aplicación, se devuelve 404.
En la CLI de EB y en [Página de estado del entorno](health-enhanced-console.md#health-enhanced-console-healthpage), estas métricas se muestran como la cantidad total de solicitudes de las instancias y como un porcentaje de las solicitudes totales de los entornos.
`p99.9``p99``p95``p90``p85``p75``p50``p10`
Latencia media del porcentaje *x* de solicitudes más lentas durante los últimos 10 segundos, donde *x* es la diferencia entre el número y 100. Por ejemplo, `p99 1.403` indica que la latencia del 1 % más lento de las solicitudes durante los últimos 10 segundos tuvo una latencia media de 1,403 segundos.
## Métricas del sistema operativo
El agente de estado de Elastic Beanstalk notifica las siguientes métricas del sistema operativo. Elastic Beanstalk utiliza estas métricas para identificar las instancias que tienen una carga pesada durante periodos prolongados. Las métricas difieren según el sistema operativo.Métricas del sistema operativo notificadas: Linux
`Running`
Cantidad de tiempo que ha transcurrido desde que se lanzó la instancia.
`Load 1``Load 5`
Carga media durante el último minuto y los últimos cinco minutos. Se muestra como un valor decimal que indica el número medio de procesos que estaban en ejecución en ese momento. Si el número que se muestra es superior al número de v CPUs (subprocesos) disponibles, el resto es el número promedio de procesos que estaban en espera.
Por ejemplo, si el tipo de instancia tiene cuatro v CPUs y la carga es de 4,5, hubo un promedio de 0,5 procesos en espera durante ese período de tiempo, lo que equivale a que un proceso esperó el 50 por ciento del tiempo.
`User %``Nice %``System %``Idle %``I/O Wait %`
Porcentaje de tiempo que la CPU ha pasado en cada estado durante los últimos 10 segundos.Métricas del sistema operativo notificadas: Windows
`Running`
Cantidad de tiempo que ha transcurrido desde que se lanzó la instancia.
`% User Time``% Privileged Time``% Idle Time`
Porcentaje de tiempo que la CPU ha pasado en cada estado durante los últimos 10 segundos.
# Captura de métricas de servidor web en IIS en Windows Server
En la plataforma Windows Server, Elastic Beanstalk agrega un módulo a la canalización de peticiones del servidor web IIS y captura métricas sobre los tiempos de petición HTTP y los códigos de respuesta. El módulo envía estas métricas al agente de estado en la instancia mediante un canal de comunicación entre procesos (IPC) de alto rendimiento. El agente de estado agrega estas métricas, las combina con las métricas del sistema operativo y las envía al servicio de Elastic Beanstalk.
## Detalles de la implementación
Para capturar las métricas de IIS, Elastic Beanstalk implementa un [https://msdn.microsoft.com/en-us/library/system.web.ihttpmodule%28v=vs.110%29.aspx](https://msdn.microsoft.com/en-us/library/system.web.ihttpmodule%28v=vs.110%29.aspx) administrado y se suscribe a los eventos [https://msdn.microsoft.com/en-us/library/system.web.httpapplication.beginrequest(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/system.web.httpapplication.beginrequest(v=vs.110).aspx) y [https://msdn.microsoft.com/en-us/library/system.web.httpapplication.endrequest(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/system.web.httpapplication.endrequest(v=vs.110).aspx). Esto permite al módulo notificar la latencia de solicitudes HTTP y los códigos de respuesta de todas las peticiones web tratadas por IIS. Para agregar el módulo a la canalización de solicitudes de IIS, Elastic Beanstalk registra el módulo en la sección [https://docs.microsoft.com/en-us/iis/configuration/system.webserver/modules/](https://docs.microsoft.com/en-us/iis/configuration/system.webserver/modules/) del archivo de configuración de IIS, `%windir%\System32\inetsrv\config\applicationHost.config`.
El módulo de Elastic Beanstalk en IIS envía las métricas de solicitud web capturadas al agente de estado en la instancia, que es un servicio de Windows llamado `HealthD`. Para enviar estos datos, el módulo utiliza [https://msdn.microsoft.com/en-us/library/system.servicemodel.netnamedpipebinding(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/system.servicemodel.netnamedpipebinding(v=vs.110).aspx), que proporciona un enlace seguro y de confianza que está optimizado para la comunicación en la máquina.
# Configuración de las reglas de informes de estado avanzados de un entorno
AWS Elastic Beanstalk los informes de estado mejorados se basan en un conjunto de reglas para determinar el estado de su entorno. Algunas de estas reglas podrían no ser adecuadas para su aplicación específica. A continuación, se presentan algunos ejemplos comunes:
+ Utiliza herramientas de prueba del lado del cliente. En este caso, se esperan errores de cliente HTTP (4xx) frecuentes.
+ Utilice [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/) junto con el Application Load Balancer de su entorno para bloquear el tráfico entrante no deseado. En este caso, el equilibrador de carga de aplicaciones devuelve HTTP 403 por cada mensaje entrante rechazado.
De forma predeterminada, Elastic Beanstalk incluye todos los errores HTTP 4xx de la aplicación al determinar el estado del entorno. Cambia el estado de su entorno de **Correcto** a **Advertencia**, **Degradado** o **Grave**, en función de la tasa de errores. Para administrar correctamente casos como los ejemplos indicados, Elastic Beanstalk permite configurar algunas reglas de informes de estado avanzados. Puede optar por omitir los errores HTTP 4xx de la aplicación en las instancias del entorno u omitir los errores HTTP 4xx devueltos por el equilibrador de carga del entorno. En este tema se describe cómo realizar estos cambios de configuración.
**nota**
En la actualidad, estas son las únicas personalizaciones de reglas de informes de estado avanzados disponibles. No puede configurar los informes de estado avanzados para ignorar otros errores HTTP además de 4xx.
## Configuración de reglas de mantenimiento mejoradas mediante la consola de Elastic Beanstalk
Puede utilizar la consola de Elastic Beanstalk para configurar reglas de estado avanzado en su entorno.
**Para configurar la comprobación de código de estado HTTP 4xx mediante la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, elija **Configuration (Configuración)**.
1. En la categoría de configuración **Monitoring (Supervisión)**, seleccione **Edit (Edición de)**.
1. En **Health monitoring rule customization (Personalización de la regla de supervisión de estado)**, habilite o deshabilite las opciones **Ignore (Omitir)**.
![\[Sección de personalización de reglas de supervisión de estado en la página de configuración de supervisión de la consola de Elastic Beanstalk\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/enhanced-health-rule-customization.png)
1. Para guardar los cambios, elija **Aplicar** en la parte inferior de la página.
## Configuración de reglas de informes de estado avanzados mediante la CLI de EB
Puede utilizar la CLI de EB para configurar reglas de estado avanzado guardando localmente la configuración del entorno, añadiendo una entrada que configure las reglas de estado avanzado y cargando la configuración en Elastic Beanstalk. Puede aplicar la configuración guardada al entorno durante o después de la creación.
**Para configurar la comprobación de código de estado HTTP 4xx mediante la CLI de EB y las configuraciones guardadas**
1. Inicialice la carpeta del proyecto con [**eb init**](eb-cli3-configuration.md).
1. Cree un entorno ejecutando el comando **eb create**.
1. Guarde una plantilla de configuración localmente ejecutando el comando **eb config save**. En el ejemplo siguiente, se utiliza la opción `--cfg` para especificar el nombre de la configuración.
```
$ eb config save --cfg 01-base-state
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml
```
1. Abra el archivo de configuración guardado en un editor de texto.
1. En `OptionSettings` > `aws:elasticbeanstalk:healthreporting:system:`, agregue una clave `ConfigDocument` para mostrar cada regla de estado avanzado que se va a configurar. El siguiente `ConfigDocument` deshabilita la comprobación de los códigos de estado HTTP 4xx de la aplicación, mientras mantiene habilitada la comprobación del código HTTP 4xx del equilibrador de carga.
```
OptionSettings:
...
aws:elasticbeanstalk:healthreporting:system:
ConfigDocument:
Rules:
Environment:
Application:
ApplicationRequests4xx:
Enabled: false
ELB:
ELBRequests4xx:
Enabled: true
Version: 1
SystemType: enhanced
...
```
**nota**
Puede combinar `Rules` y `CloudWatchMetrics` en el mismo ajuste de opción de `ConfigDocument`. `CloudWatchMetrics` se describen en [Publicar métricas CloudWatch personalizadas de Amazon para un entorno](health-enhanced-cloudwatch.md).
Si ha habilitado previamente `CloudWatchMetrics`, el archivo de configuración que recupere mediante el comando **eb config save** ya tiene una clave `ConfigDocument` con una sección `CloudWatchMetrics`. *No lo elimine*; agrega una sección `Rules` en el mismo valor de la opción `ConfigDocument`.
1. Guarde el archivo de configuración y cierre el editor de texto. En este ejemplo, el archivo de configuración actualizado se ha guardado con otro nombre (`02-cloudwatch-enabled.cfg.yml`) que sea diferente al del archivo de configuración que se descargó. De este modo, se crea una configuración guardada distinta cuando se cargue el archivo. Puede utilizar el mismo nombre que el del archivo descargado para sobrescribir la configuración existente sin crear una nueva.
1. Utilice el comando **eb config put** para cargar el archivo de configuración actualizado a Elastic Beanstalk.
```
$ eb config put 02-cloudwatch-enabled
```
Si utiliza los comandos **eb config** `get` y `put` con configuraciones guardadas, no incluya la extensión de nombre de archivo.
1. Aplique la configuración guardada en el entorno que está en ejecución.
```
$ eb config --cfg 02-cloudwatch-enabled
```
La opción `--cfg` especifica el archivo de configuración designado que se aplica al entorno. Puede guardar el archivo de configuración localmente o en Elastic Beanstalk. Si hay un archivo de configuración con el nombre especificado en las dos ubicaciones, la CLI de EB utiliza el archivo local.
## Configuración de reglas de informes de estado avanzados mediante un documento de configuración
El documento de configuración (config) para reglas de estado avanzado es un documento JSON que contiene una lista de las reglas que se van a configurar.
El siguiente ejemplo muestra un documento de configuración que deshabilita la comprobación de los códigos de estado HTTP 4xx de la aplicación y habilita la comprobación de los códigos de estado HTTP 4xx del equilibrador de carga.
```
{
"Rules": {
"Environment": {
"Application": {
"ApplicationRequests4xx": {
"Enabled": false
}
},
"ELB": {
"ELBRequests4xx": {
"Enabled": true
}
}
}
},
"Version": 1
}
```
En el caso de AWS CLI, se pasa el documento como valor de la `Value` clave de un argumento de configuración de opciones, que a su vez es un objeto JSON. En este caso, las comillas del documento insertado deben escribirse con caracteres de escape. El siguiente comando comprueba si los ajustes de configuración son válidos.
```
$ aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings '[
{
"Namespace": "aws:elasticbeanstalk:healthreporting:system",
"OptionName": "ConfigDocument",
"Value": "{\"Rules\": { \"Environment\": { \"Application\": { \"ApplicationRequests4xx\": { \"Enabled\": false } }, \"ELB\": { \"ELBRequests4xx\": {\"Enabled\": true } } } }, \"Version\": 1 }"
}
]'
```
En los archivos de configuración `.ebextensions` de YAML, puede proporcionar el documento JSON tal y como está.
```
option_settings:
- namespace: aws:elasticbeanstalk:healthreporting:system
option_name: ConfigDocument
value: {
"Rules": {
"Environment": {
"Application": {
"ApplicationRequests4xx": {
"Enabled": false
}
},
"ELB": {
"ELBRequests4xx": {
"Enabled": true
}
}
}
},
"Version": 1
}
```
# Publicar métricas CloudWatch personalizadas de Amazon para un entorno
Puedes publicar los datos recopilados mediante los informes de salud AWS Elastic Beanstalk mejorados en Amazon CloudWatch como métricas personalizadas. Publicar métricas te CloudWatch permite monitorizar los cambios en el rendimiento de las aplicaciones a lo largo del tiempo e identificar posibles problemas mediante el seguimiento de la forma en que el uso de los recursos y la latencia de las solicitudes aumentan en función de la carga.
Al publicar las métricas en CloudWatch, también las pone a disposición para utilizarlas con [gráficos y [alarmas](using-features.alarms.md) de supervisión](environment-health-console.md#environment-health-console-graphs). Una métrica gratuita se activa automáticamente al utilizar los informes de salud mejorados. *EnvironmentHealth* Las métricas personalizadas no *EnvironmentHealth*conllevan [CloudWatch cargos](https://aws.amazon.com/cloudwatch/pricing/) estándar.
Para publicar métricas CloudWatch personalizadas para un entorno, primero debe habilitar los informes de estado mejorados del entorno. Para obtener instrucciones, consulte [Habilitación de informes de estado mejorado de Elastic Beanstalk](health-enhanced-enable.md).
**Topics**
+ [Métricas de informes de estado avanzados](#health-enhanced-cloudwatch-metrics)
+ [Configuración de CloudWatch métricas mediante la consola de Elastic Beanstalk](#health-enhanced-cloudwatch-console)
+ [Configuración de métricas CloudWatch personalizadas mediante la CLI de EB](#health-enhanced-cloudwatch-ebcli)
+ [Proporcionar documentos de configuración de métricas personalizadas](#health-enhanced-cloudwatch-configdocument)
## Métricas de informes de estado avanzados
Al habilitar los informes de estado mejorados en su entorno, el sistema de informes de estado mejorado publica automáticamente una [métrica CloudWatch personalizada](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/publishingMetrics.html), *EnvironmentHealth*. [Para publicar métricas adicionales CloudWatch, configure su entorno con esas métricas mediante la [consola de [Elastic Beanstalk](#health-enhanced-cloudwatch-console),](#health-enhanced-cloudwatch-ebcli) la CLI de EB o .ebextensions.](command-options.md)
Puede publicar las siguientes métricas de estado mejoradas de su entorno en. CloudWatchMétricas disponibles: todas las plataformas
`EnvironmentHealth`
*Solo se aplica al entorno. * Esta es la única CloudWatch métrica que publica el sistema mejorado de informes de salud, a menos que configure métricas adicionales. El estado del entorno está representado por uno de los siete [estados](health-enhanced-status.md). En la CloudWatch consola, estos estados se asignan a los siguientes valores:
+ 0: OK
+ 1: Info
+ 5: Unknown
+ 10: No data
+ 15: Warning
+ 20: Degraded
+ 25: Severe
`InstancesSevere``InstancesDegraded``InstancesWarning``InstancesInfo``InstancesOk``InstancesPending``InstancesUnknown``InstancesNoData`
*Solo se aplica al entorno. * Estas métricas indican el número de instancias del entorno y el estado de cada una. `InstancesNoData` indica el número de instancias para las que no se reciben datos.
`ApplicationRequestsTotal``ApplicationRequests5xx``ApplicationRequests4xx``ApplicationRequests3xx``ApplicationRequests2xx`
*Se aplica a la instancia y al entorno. * Indica el número total de solicitudes completado por la instancia o el entorno, así como el número de solicitudes completadas con el código de estado de cada categoría.
`ApplicationLatencyP10``ApplicationLatencyP50``ApplicationLatencyP75``ApplicationLatencyP85``ApplicationLatencyP90``ApplicationLatencyP95``ApplicationLatencyP99``ApplicationLatencyP99.9`
*Se aplica a la instancia y al entorno. * Indica el período medio de tiempo, en segundos, que tarda en completarse el porcentaje *x* de las solicitudes más rápidas.
`InstanceHealth`
*Se aplica solo a la instancia. * Indica el estado actual de la instancia. El estado de la instancia está representado por uno de los siete [estados](health-enhanced-status.md). En la CloudWatch consola, estos estados se asignan a los siguientes valores:
+ 0: OK
+ 1: Info
+ 5: Unknown
+ 10: No data
+ 15: Warning
+ 20: Degraded
+ 25: SevereMétricas disponibles: Linux
`CPUIrq``CPUIdle``CPUUser``CPUSystem``CPUSoftirq``CPUIowait``CPUNice`
*Se aplica solo a la instancia. * Indica el porcentaje de tiempo que la CPU ha pasado en cada estado durante el último minuto.
`LoadAverage1min`
*Se aplica solo a la instancia. * Carga media de la CPU de la instancia durante el último minuto.
`RootFilesystemUtil`
*Se aplica solo a la instancia. * Indica el porcentaje de espacio en disco que está en uso.Métricas disponibles: Windows
`CPUIdle``CPUUser``CPUPrivileged`
Se aplica solo a la instancia. Indica el porcentaje de tiempo que la CPU ha pasado en cada estado durante el último minuto.
## Configuración de CloudWatch métricas mediante la consola de Elastic Beanstalk
Puede usar la consola de Elastic Beanstalk para configurar su entorno para publicar CloudWatch métricas de informes de estado mejoradas y ponerlas a disposición para su uso con gráficos y alarmas de monitoreo.
**Para configurar métricas CloudWatch personalizadas en la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, elija **Configuration (Configuración)**.
1. En la categoría de configuración **Monitoring (Supervisión)**, seleccione **Edit (Edición de)**.
1. En **Health reporting (Informe de estado)**, seleccione las métricas de instancia y de entorno que desee publicar en CloudWatch. Para seleccionar varias métricas, presione la tecla **Ctrl** mientras hace la selección.
1. Para guardar los cambios, elija **Aplicar** en la parte inferior de la página.
[**Al habilitar las métricas CloudWatch personalizadas, se agregan a la lista de métricas disponibles en la página de monitoreo.**](environment-health-console.md)
## Configuración de métricas CloudWatch personalizadas mediante la CLI de EB
Puede utilizar la CLI de EB para configurar métricas personalizadas. Para ello, guarde la configuración del entorno localmente, agregue una entrada que defina las métricas que se van a publicar y cargue la configuración en Elastic Beanstalk. Puede aplicar la configuración guardada al entorno durante o después de la creación.
**Para configurar métricas CloudWatch personalizadas con la CLI de EB y las configuraciones guardadas**
1. Inicialice la carpeta del proyecto con [**eb init**](eb-cli3-configuration.md).
1. Cree un entorno ejecutando el comando **eb create**.
1. Guarde una plantilla de configuración localmente ejecutando el comando **eb config save**. En el ejemplo siguiente, se utiliza la opción `--cfg` para especificar el nombre de la configuración.
```
$ eb config save --cfg 01-base-state
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml
```
1. Abra el archivo de configuración guardado en un editor de texto.
1. En `OptionSettings` >`aws:elasticbeanstalk:healthreporting:system:`, añada una `ConfigDocument` clave para habilitar cada una de las CloudWatch métricas que desee. Por ejemplo, en el ejemplo siguiente, `ConfigDocument` publica las métricas `ApplicationRequests5xx` y `ApplicationRequests4xx` en el nivel del entorno y la métrica `ApplicationRequestsTotal` en el nivel de la instancia.
```
OptionSettings:
...
aws:elasticbeanstalk:healthreporting:system:
ConfigDocument:
CloudWatchMetrics:
Environment:
ApplicationRequests5xx: 60
ApplicationRequests4xx: 60
Instance:
ApplicationRequestsTotal: 60
Version: 1
SystemType: enhanced
...
```
En el ejemplo, 60 indica el número de segundos entre las mediciones. En la actualidad, este es el único valor que se permite.
**nota**
Puede combinar `CloudWatchMetrics` y `Rules` en el mismo ajuste de opción de `ConfigDocument`. `Rules` se describen en [Configuración de las reglas de informes de estado avanzados de un entorno](health-enhanced-rules.md).
Si ha utilizado previamente `Rules` para configurar las reglas de estado avanzado, a continuación, el archivo de configuración que recupere mediante el comando **eb config save** ya tiene una clave `ConfigDocument` con una sección `Rules`. *No lo elimine*; agrega una sección `CloudWatchMetrics` en el mismo valor de la opción `ConfigDocument`.
1. Guarde el archivo de configuración y cierre el editor de texto. En este ejemplo, el archivo de configuración actualizado se ha guardado con otro nombre (`02-cloudwatch-enabled.cfg.yml`) que sea diferente al del archivo de configuración que se descargó. De este modo, se crea una configuración guardada distinta cuando se cargue el archivo. Puede utilizar el mismo nombre que el del archivo descargado para sobrescribir la configuración existente sin crear una nueva.
1. Utilice el comando **eb config put** para cargar el archivo de configuración actualizado a Elastic Beanstalk.
```
$ eb config put 02-cloudwatch-enabled
```
Si utiliza los comandos **eb config** `get` y `put` con configuraciones guardadas, no incluya la extensión de archivo.
1. Aplique la configuración guardada en el entorno que está en ejecución.
```
$ eb config --cfg 02-cloudwatch-enabled
```
La opción `--cfg` especifica el archivo de configuración designado que se aplica al entorno. Puede guardar el archivo de configuración localmente o en Elastic Beanstalk. Si hay un archivo de configuración con el nombre especificado en las dos ubicaciones, la CLI de EB utiliza el archivo local.
## Proporcionar documentos de configuración de métricas personalizadas
El documento de configuración (config) de las métricas CloudWatch personalizadas de Amazon es un documento JSON en el que se enumeran las métricas que se van a publicar en los niveles de entorno e instancia. En el ejemplo siguiente, se muestra un documento de configuración que habilita todas las métricas personalizadas disponibles en Linux.
```
{
"CloudWatchMetrics": {
"Environment": {
"ApplicationLatencyP99.9": 60,
"InstancesSevere": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"InstancesUnknown": 60,
"ApplicationLatencyP85": 60,
"InstancesInfo": 60,
"ApplicationRequests2xx": 60,
"InstancesDegraded": 60,
"InstancesWarning": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"InstancesNoData": 60,
"InstancesPending": 60,
"ApplicationLatencyP10": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"InstancesOk": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60
},
"Instance": {
"ApplicationLatencyP99.9": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"ApplicationLatencyP85": 60,
"CPUUser": 60,
"ApplicationRequests2xx": 60,
"CPUIdle": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"RootFilesystemUtil": 60,
"LoadAverage1min": 60,
"CPUIrq": 60,
"CPUNice": 60,
"CPUIowait": 60,
"ApplicationLatencyP10": 60,
"LoadAverage5min": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"CPUSystem": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60,
"InstanceHealth": 60,
"CPUSoftirq": 60
}
},
"Version": 1
}
```
En el caso de AWS CLI, se pasa el documento como un valor para la `Value` clave de un argumento de configuración de opciones, que a su vez es un objeto JSON. En este caso, las comillas del documento insertado deben escribirse con caracteres de escape.
```
$ aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings '[
{
"Namespace": "aws:elasticbeanstalk:healthreporting:system",
"OptionName": "ConfigDocument",
"Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": 60,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": 60,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": 60,\"ApplicationRequests2xx\": 60,\"InstancesDegraded\": 60,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": 60,\"InstancesNoData\": 60,\"InstancesPending\": 60,\"ApplicationLatencyP10\": 60,\"ApplicationRequests5xx\": 60,\"ApplicationLatencyP75\": 60,\"InstancesOk\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": 60},\"Instance\": {\"ApplicationLatencyP99.9\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": 60,\"ApplicationLatencyP95\": 60,\"ApplicationLatencyP85\": 60,\"CPUUser\": 60,\"ApplicationRequests2xx\": 60,\"CPUIdle\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": 60,\"LoadAverage1min\": 60,\"CPUIrq\": 60,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": 60,\"LoadAverage5min\": 60,\"ApplicationRequests5xx\": 60,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": 60,\"InstanceHealth\": 60,\"CPUSoftirq\": 60}},\"Version\": 1}"
}
]'
```
En los archivos de configuración `.ebextensions` de YAML, puede proporcionar el documento JSON tal y como está.
```
option_settings:
- namespace: aws:elasticbeanstalk:healthreporting:system
option_name: ConfigDocument
value: {
"CloudWatchMetrics": {
"Environment": {
"ApplicationLatencyP99.9": 60,
"InstancesSevere": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"InstancesUnknown": 60,
"ApplicationLatencyP85": 60,
"InstancesInfo": 60,
"ApplicationRequests2xx": 60,
"InstancesDegraded": 60,
"InstancesWarning": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"InstancesNoData": 60,
"InstancesPending": 60,
"ApplicationLatencyP10": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"InstancesOk": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60
},
"Instance": {
"ApplicationLatencyP99.9": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"ApplicationLatencyP85": 60,
"CPUUser": 60,
"ApplicationRequests2xx": 60,
"CPUIdle": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"RootFilesystemUtil": 60,
"LoadAverage1min": 60,
"CPUIrq": 60,
"CPUNice": 60,
"CPUIowait": 60,
"ApplicationLatencyP10": 60,
"LoadAverage5min": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"CPUSystem": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60,
"InstanceHealth": 60,
"CPUSoftirq": 60
}
},
"Version": 1
}
```
# Uso de informes de estado mejorados con la API de Elastic Beanstalk
Dado que los informes de estado AWS Elastic Beanstalk mejorados tienen requisitos de funciones y conjunto de soluciones, debe actualizar los scripts y el código que utilizó antes de la publicación de los informes de estado mejorados antes de poder utilizarlos. Para mantener la compatibilidad con versiones anteriores, los informes de estado mejorados no están habilitados de forma predeterminada cuando crea un entorno utilizando la API de Elastic Beanstalk.
Para configurar los informes de estado mejorados, defina la función de servicio, el perfil de la instancia y las opciones de CloudWatch configuración de Amazon para su entorno. Puede hacer esto de tres formas: mediante las opciones de configuración de la carpeta `.ebextensions`, con configuraciones guardadas o configurando las opciones directamente en el parámetro `create-environment` de la llamada a `option-settings`.
Para usar la API o la interfaz de línea de AWS comandos (CLI) para crear un entorno que permita mejorar el estado, debe: SDKs
+ Creación de un rol de servicio y un perfil de instancia con los [permisos](concepts-roles.md) adecuados
+ Creación de un nuevo entorno con una nueva [versión de la plataforma](concepts.platforms.md)
+ Definir las [opciones de configuración](command-options.md) de tipo de sistema de estado, perfil de instancia y rol de servicio
Utilice las siguientes opciones de configuración de los espacios de nombres `aws:elasticbeanstalk:healthreporting:system`, `aws:autoscaling:launchconfiguration`y `aws:elasticbeanstalk:environment` para configurar su entorno para que utilice informes de estado mejorados.
## Opciones de configuración de informes de estado mejorados
**SystemType**
Espacio de nombres: `aws:elasticbeanstalk:healthreporting:system`
Para habilitar los informes de estado mejorados, establezca este parámetro en **enhanced**.
**IamInstanceProfile**
Espacio de nombres: `aws:autoscaling:launchconfiguration`
Establezca este parámetro en el nombre de un perfil de instancia configurado para su uso con Elastic Beanstalk.
**ServiceRole**
Espacio de nombres: `aws:elasticbeanstalk:environment`
Establezca este parámetro en un rol de servicio configurado para su uso con Elastic Beanstalk.
**ConfigDocument** (opcional)
Espacio de nombres: `aws:elasticbeanstalk:healthreporting:system`
Un documento JSON que defina las métricas de instancia y entorno en las que se va a publicar CloudWatch. Por ejemplo:
```
{
"CloudWatchMetrics":
{
"Environment":
{
"ApplicationLatencyP99.9":60,
"InstancesSevere":60
}
"Instance":
{
"ApplicationLatencyP85":60,
"CPUUser": 60
}
}
"Version":1
}
```
**nota**
Los documentos config pueden requerir un formato especial, como incluir las comillas en caracteres de escape, en función de cómo los proporcione a Elastic Beanstalk. Para ver ejemplos, consulte [Proporcionar documentos de configuración de métricas personalizadas](health-enhanced-cloudwatch.md#health-enhanced-cloudwatch-configdocument).
# Formato de los registros de estado avanzados
AWS Elastic Beanstalk las plataformas utilizan un formato de registro de servidor web personalizado para transmitir de manera eficiente la información sobre las solicitudes HTTP al sistema mejorado de informes de salud. El sistema analiza los registros, identifica los problemas y determina convenientemente el estado de la instancia y del entorno. Aunque se deshabilite el proxy del servidor web en el entorno y las solicitudes se envíen directamente desde el contenedor web, es posible seguir utilizando informes de estado avanzado. Para ello, configure el servidor de forma que se generen registros en la ubicación y se aplique el formato que utiliza el [agente de estado de Elastic Beanstalk](health-enhanced.md#health-enhanced-agent).
**nota**
La información de esta página solo es relevante para las plataformas basadas en Linux. En la plataforma de Windows Server, Elastic Beanstalk recibe información sobre las solicitudes HTTP directamente del servidor web de IIS. Para obtener más información, consulte [Captura de métricas de servidor web en IIS en Windows Server](health-enhanced-metrics-server-iis.md).
## Configuración de los registros de servidor web
Las plataformas Elastic Beanstalk están configuradas para generar dos registros con información sobre las solicitudes HTTP. El primero de ellos tiene un formato detallado y proporciona información pormenorizada de la solicitud, como los datos del agente de usuario del solicitante y una marca de tiempo en lenguaje natural.
**/var/log/nginx/access.log**
El siguiente ejemplo procede de un proxy nginx que se ejecuta en un entorno de servidor web de Ruby, aunque el formato es similar al de Apache.
```
172.31.24.3 - - [23/Jul/2015:00:21:20 +0000] "GET / HTTP/1.1" 200 11 "-" "curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3" "177.72.242.17"
172.31.24.3 - - [23/Jul/2015:00:21:21 +0000] "GET / HTTP/1.1" 200 11 "-" "curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3" "177.72.242.17"
172.31.24.3 - - [23/Jul/2015:00:21:22 +0000] "GET / HTTP/1.1" 200 11 "-" "curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3" "177.72.242.17"
172.31.24.3 - - [23/Jul/2015:00:21:22 +0000] "GET / HTTP/1.1" 200 11 "-" "curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3" "177.72.242.17"
172.31.24.3 - - [23/Jul/2015:00:21:22 +0000] "GET / HTTP/1.1" 200 11 "-" "curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3" "177.72.242.17"
```
El segundo log tiene un formato más escueto. Solo contiene información que es pertinente para los informes de estado avanzados. Esta log se genera en una subcarpeta llamada `healthd` y rota cada hora. Los logs antiguos se eliminan inmediatamente después de la rotación.
**/.log.2015-07-23-00 var/log/nginx/healthd/application**
En el siguiente ejemplo, se muestra un log con el formato de lectura mecánica.
```
1437609879.311"/"200"0.083"0.083"177.72.242.17
1437609879.874"/"200"0.347"0.347"177.72.242.17
1437609880.006"/bad/path"404"0.001"0.001"177.72.242.17
1437609880.058"/"200"0.530"0.530"177.72.242.17
1437609880.928"/bad/path"404"0.001"0.001"177.72.242.17
```
El formato avanzado del log de estado contiene la siguiente información:
+ Hora de la solicitud, en tiempo Unix
+ Ruta de la solicitud
+ Código de estado HTTP del resultado
+ Tiempo de la solicitud
+ Tiempo de subida
+ Encabezado HTTP `X-Forwarded-For`
En los proxies de nginx, los valores de tiempo se presentan en segundos de punto flotante, con tres decimales. En Apache, se utilizan microsegundos enteros.
**nota**
Si aparece una advertencia similar a la siguiente en un archivo de registro (donde `DATE-TIME` es una fecha y una hora) y utiliza un proxy personalizado (por ejemplo, un entorno de Docker con varios contenedores), debe utilizar .ebextension para configurar el entorno de forma que `healthd` pueda leer los archivos de registro:
```
W, [DATE-TIME #1922] WARN -- : log file "/var/log/nginx/healthd/application.log.DATE-TIME" does not exist
```
Puede comenzar a usar .ebextension en el [ejemplo de Docker Multicontainer](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/docker-multicontainer-v2.zip).
**/etc/nginx/conf.d/webapp\$1healthd.conf**
En el siguiente ejemplo, se muestra la configuración del registro de nginx con el formato del registro de `healthd` resaltado.
```
upstream my_app {
server unix:///var/run/puma/my_app.sock;
}
log_format healthd '$msec"$uri"'
'$status"$request_time"$upstream_response_time"'
'$http_x_forwarded_for';
server {
listen 80;
server_name _ localhost; # need to listen to localhost for worker tier
if ($time_iso8601 ~ "^(\d{4})-(\d{2})-(\d{2})T(\d{2})") {
set $year $1;
set $month $2;
set $day $3;
set $hour $4;
}
access_log /var/log/nginx/access.log main;
access_log /var/log/nginx/healthd/application.log.$year-$month-$day-$hour healthd;
location / {
proxy_pass http://my_app; # match the name of upstream directive which is defined above
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location /assets {
alias /var/app/current/public/assets;
gzip_static on;
gzip on;
expires max;
add_header Cache-Control public;
}
location /public {
alias /var/app/current/public;
gzip_static on;
gzip on;
expires max;
add_header Cache-Control public;
}
}
```
**/etc/httpd/conf.d/healthd.conf**
En el siguiente ejemplo se muestra la configuración de registro de Apache.
```
LogFormat "%{%s}t\"%U\"%s\"%D\"%D\"%{X-Forwarded-For}i" healthd
CustomLog "|/usr/sbin/rotatelogs /var/log/httpd/healthd/application.log.%Y-%m-%d-%H 3600" healthd
```
## Creación de registros para informes de estado avanzados
Para proporcionar logs al agente de estado, debe hacer lo siguiente:
+ Generar logs con el formato correcto, tal y como se explicó en la sección anterior.
+ Generar logs en `/var/log/nginx/healthd/`
+ Asignar un nombre a los logs que tenga el siguiente formato: `application.log.$year-$month-$day-$hour`
+ Rotar los logs una vez por hora.
+ No truncar los logs.
# Notificaciones y solución de problemas
**Pruebe la CLI de Amazon Q Developer para solucionar problemas con ayuda de la IA**
La CLI de Amazon Q Developer puede ayudarle a solucionar rápidamente los problemas de entorno. La CLI de Q permite solucionar problemas comprobando el estado del entorno, revisando eventos, analizando registros y formulando preguntas aclaratorias. Para obtener más información y tutoriales detallados, consulte [Solución de problemas de entornos de Elastic Beanstalk con Amazon](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/) Q Developer CLI en los blogs. AWS
En esta página, se muestran los mensajes sobre problemas comunes y enlaces para obtener más información. Los mensajes se muestran en el [Panel Información general del entorno](environments-dashboard-envoverview.md) de la consola de Elastic Beanstalk y se registran como [eventos](using-features.events.md) cuando los problemas de estado se mantienen durante varias comprobaciones.
## Implementaciones
Elastic Beanstalk supervisa el entorno para mantener la coherencia con las implementaciones posteriores. Si se produce un error en una implementación continua, la versión de la aplicación que se ejecuta en las instancias del entorno podría variar. Esto puede producirse si la implementación de uno o varios lotes se realiza correctamente, pero se produce un error antes de completar todos los lotes.
*Se encontró una versión incorrecta de la aplicación en 2 de las 5 instancias. Se esperaba la versión “v1” (implementación 1).*
*Versión incorrecta de la aplicación en algunas instancias del entorno. Se esperaba la versión “v1” (implementación 1).*
La versión de la aplicación prevista no se está ejecutando en algunas o en ninguna de las instancias de un entorno.
*La versión de la aplicación, “v2” (implementación 2), no es correcta 2). Se esperaba la versión “v1” (implementación 1).*
La aplicación implementada en una instancia es diferente a la versión esperada. Si se produce un error en una implementación, la versión esperada se restablece en la versión de la implementación más reciente que se realizó con éxito. En el ejemplo anterior, la primera implementación (versión “v1”) se realizó correctamente, pero no la segunda implementación (versión “v2”). Por tanto, se considera que todas las instancias que ejecutan “v2” tienen un estado incorrecto.
Para solucionar este problema, debe iniciar otra implementación. Puede [volver a implementar](using-features.deploy-existing-version.md) una versión anterior que sepa que funciona bien o configurar el entorno para que [se omitan las comprobaciones de estado](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console) durante la implementación y vuelva a implementarse a la fuerza la nueva versión hasta que se complete.
También puede identificar y terminar las instancias en las que se ejecuta la versión incorrecta de la aplicación. Elastic Beanstalk lanzará instancias con la versión correcta para sustituir a las instancias terminadas. Utilice el [comando “health” de la CLI de EB](health-enhanced-ebcli.md) para identificar en qué instancias se ejecuta una versión incorrecta de la aplicación.
## Servidor de aplicaciones
*El 15 % de las solicitudes experimentan errores HTTP 4xx*
*El 20 % de las solicitudes dirigidas a ELB experimentan errores HTTP 4xx.*
Hay un alto porcentaje de solicitudes HTTP dirigidas a una instancia o entorno que están experimentando errores 4xx.
Los códigos de estado de la serie 400 indican que el usuario hizo una solicitud incorrecta; por ejemplo, solicitó una página que no existe (404 Archivo no encontrado) o a la que el usuario no tiene acceso (403 Prohibido). Es normal que se produzcan algunos errores 404. Sin embargo, si el número es alto, podría indicar que hay enlaces internos o externos a páginas que no están disponibles. Estos problemas pueden resolverse corrigiendo los enlaces internos erróneos y redireccionando los enlaces externos que no son correctos.
*El 5 % de las solicitudes experimentan errores HTTP 5xx*
*El 3 % de las solicitudes dirigidas a ELB experimentan errores HTTP 5xx.*
Hay un alto porcentaje de solicitudes HTTP dirigidas a una instancia o entorno que están experimentando errores con códigos de estado de la serie 500.
Un código de estado de la serie 500 indica que el servidor de aplicaciones ha detectado un error interno. Estos errores informan de que hay un error en el código de la aplicación que debe identificarse y resolverse rápidamente.
*El 95 % de la CPU está en uso.*
En una instancia, el agente de estado notifica un porcentaje extremadamente alto de uso de la CPU y establece el estado de la instancia en **Warning** o **Degraded**.
Escale el entorno para poder aliviar la carga de las instancias.
## Instancia de trabajo
*Hay 20 mensajes en espera en la cola (hace 25 segundos).*
Se están agregando solicitudes a la cola del entorno de trabajo más rápido de lo que se pueden procesar. Escale el entorno para aumentar la capacidad.
*Hay 5 mensajes en la cola de mensajes fallidos (hace 15 segundos)*
Se están produciendo errores repetidamente en las solicitudes de trabajo, que se están agregando a la [Colas de mensajes fallidos](using-features-managing-env-tiers.md#worker-deadletter) Consulte las solicitudes de la cola de mensajes fallidos para ver por qué están produciendo un error.
## Otros recursos
*4 El número de instancias activas (4) es inferior al tamaño mínimo del grupo de escalado automático 5*
El número de instancias que se ejecutan en el entorno es inferior al número mínimo configurado para el grupo de escalado automático.
*Se han eliminado o modificado notificaciones del grupo de escalado automático (nombreDelGrupo*
Las notificaciones configuradas para el grupo de escalado automático se han modificado fuera de Elastic Beanstalk.
# Análisis del entorno impulsado por IA
AWS Elastic Beanstalk Su análisis basado en la IA identifica las causas fundamentales y recomienda soluciones para los problemas de salud ambiental. Cuando su entorno tenga problemas, puede solicitar un análisis de IA utilizando las operaciones de `RetrieveEnvironmentInfo` API `RequestEnvironmentInfo` y las operaciones de API con ese tipo de información para obtener `analyze` información generada por la IA y obtener soluciones recomendadas.
**nota**
El análisis de IA solo está disponible en Amazon Linux 2 y en las versiones de AL2023 plataforma compatibles publicadas a partir del 16 de febrero de 2026.
## Funcionamiento
Cuando solicitas un análisis de IA, Elastic Beanstalk ejecuta un script en una instancia de tu entorno que recopila los eventos recientes, el estado de la instancia y los registros ([hasta](https://docs.aws.amazon.com/bedrock/latest/userguide/key-definitions.html) 170 000 tokens de datos). A continuación, envía estos datos a Amazon Bedrock en tu cuenta y te proporciona información y recomendaciones sobre los siguientes pasos.
## Requisitos previos
Antes de utilizar el análisis de IA, compruebe que su entorno cumpla los siguientes requisitos:
+ Entorno en el que se ejecuta una [versión de plataforma compatible](#health-ai-analysis-supported-platforms)
+ [Perfil de instancia](iam-instanceprofile.md) con los permisos necesarios (consulte [Permisos necesarios](#health-ai-analysis-permissions) a continuación)
+ **Detalles del caso de uso antrópico**: el análisis de IA utiliza modelos de Claude antrópico a través de Amazon Bedrock. Anthropic requiere que envíe un formulario de detalles del caso de uso único antes de poder invocar sus modelos. Para enviar este formulario, selecciona cualquier modelo Anthropic del catálogo de modelos de la [consola de Amazon Bedrock](https://console.aws.amazon.com/bedrock/) o llama a la [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html)API. Solo tiene que hacerlo una vez por cuenta. AWS Si envía el formulario desde la AWS cuenta de administración de Organizations, cubre automáticamente todas las cuentas de los miembros de la organización. Para obtener más información, consulte los [modelos de base Access Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html).
+ **GovCloud regiones**: si utiliza regiones AWS GovCloud (EE. UU.), debe habilitar el acceso al último modelo Anthropic Claude Sonnet and/or Opus en Amazon Bedrock antes de utilizar el análisis de IA. Para obtener instrucciones sobre cómo habilitar el acceso a los modelos en GovCloud las regiones, consulte [Administrar el acceso a los modelos básicos de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-govcloud). Para obtener información sobre el último modelo Anthropic Claude Sonnet and/or Opus disponible, consulte [Regiones y modelos compatibles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) para ver los perfiles de inferencia.
## Permisos necesarios
Para utilizar el análisis de IA, el perfil de instancia de Amazon EC2 de su entorno debe tener permisos para invocar Amazon Bedrock. Añada los siguientes permisos a su perfil de instancia:
+ `bedrock:InvokeModel`
+ `bedrock:ListFoundationModels`
+ `elasticbeanstalk:DescribeEvents`
+ `elasticbeanstalk:DescribeEnvironmentHealth`
Para obtener más información sobre la configuración de los perfiles de instancia, consulte[Administración de perfiles de instancia de Elastic Beanstalk](iam-instanceprofile.md).
## Uso del análisis de IA en la consola
**De la descripción general del entorno**
Cuando el estado de salud de su entorno es **Advertencia**, **Degradado** o **Grave**, aparece un botón de **análisis de IA** en la sección de información general del entorno. Haga clic en este botón para iniciar un análisis de IA de su entorno.
**Desde la página de registros**
También puede acceder al análisis de la IA desde la página de **registros** del panel de navegación. Haga clic en el botón **Análisis de IA** para solicitar un análisis basado en la IA del estado actual de su entorno.
## Uso del análisis de IA con AWS CLI
Puede utilizar la API de Elastic Beanstalk a través de la para solicitar y recuperar AWS CLI análisis de IA mediante programación.
**Solicite un análisis de IA**
Utilice la [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html)operación con el `InfoType` parámetro establecido en`analyze`.
**Example AWS CLI - Solicita un análisis de IA**
```
aws elasticbeanstalk request-environment-info \
--environment-name my-env \
--info-type analyze \
--region us-east-1
```
**Recupera el análisis de IA**
Utilice la [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html)operación con el `InfoType` parámetro establecido en `analyze` para recuperar los resultados del análisis.
**Example AWS CLI - Recupera los análisis de IA**
```
aws elasticbeanstalk retrieve-environment-info \
--environment-name my-env \
--info-type analyze \
--region us-east-1
```
La respuesta incluye un análisis generado por la IA del estado actual del entorno, junto con las soluciones recomendadas para cualquier problema identificado.
## Uso del análisis de IA con la CLI de EB
Si utiliza la CLI de EB, puede solicitar un análisis de IA con la opción `--analyze` (`-ai`) del **eb logs** comando. El comando solicita el análisis, espera a que se complete y muestra los resultados.
**Example EB CLI: solicite un análisis de IA**
```
$ eb logs --analyze
```
La `--analyze` opción no es compatible con `--instance``--all`,`--zip`, o`--log-group`. Para obtener una referencia completa de los comandos, consulte[**eb logs**](eb3-logs.md).
**nota**
La `--analyze` opción requiere la versión 3.27 o posterior de EB CLI.
## Consideraciones importantes
+ **Precios**: el análisis de IA utiliza Amazon Bedrock para procesar los datos del entorno y se aplican los precios estándar de Amazon Bedrock a las invocaciones de modelos. Para obtener más información sobre precios, consulte [Precios de Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
+ **Requisito de plataforma**: el análisis de IA solo está disponible en Amazon Linux 2 y AL2023 en las versiones de plataforma basadas publicadas a partir del 16 de febrero de 2026. Para utilizar esta función, actualice su entorno a una versión de plataforma compatible. Para obtener más información, consulte [Actualización de la versión de la plataforma del entorno de Elastic Beanstalk](using-features.platform.upgrade.md).
+ **Permisos**: antes de utilizar el análisis de IA, asegúrese de que el perfil de su instancia tenga los permisos de Amazon Bedrock (`bedrock:InvokeModel`y`bedrock:ListFoundationModels`) y los permisos de Elastic `elasticbeanstalk:DescribeEvents` Beanstalk (y) necesarios. `elasticbeanstalk:DescribeEnvironmentHealth`
+ **Privacidad de datos**: el análisis envía los eventos y registros del entorno a Amazon Bedrock en su cuenta para su procesamiento. Para obtener información sobre cómo gestiona Amazon Bedrock sus datos, consulte [Seguridad y conformidad de Amazon Bedrock](https://aws.amazon.com/bedrock/security-compliance/).
+ **Cuotas de servicio**: el análisis de IA utiliza un modelo Anthropic Claude en Amazon Bedrock, que tiene cuotas predeterminadas para las solicitudes por minuto y los tokens por minuto. Si encuentra errores de limitación, puede solicitar un aumento de la cuota. Para obtener más información, consulte [Solicitud de un aumento de cuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).
## Versiones de la plataforma compatibles
El análisis de IA es compatible con Amazon Linux 2 y las versiones de plataformas AL2023 basadas publicadas a partir del [16 de febrero de 2026](RELEASE_NOTES_URL). Para comprobar la versión de la plataforma, consulte las notas de la versión de [Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/welcome.html).
# Administrar alarmas
En este tema, se explican los pasos necesarios para crear alarmas en las métricas que se están supervisando. También se proporcionan instrucciones para ver las alarmas existentes y comprobar su estado.
Puede crear alarmas para las métricas que está supervisando a través de la consola de Elastic Beanstalk. Las alarmas le ayudan a monitorear los cambios en su AWS Elastic Beanstalk entorno para que pueda identificar y mitigar fácilmente los problemas antes de que se produzcan. Por ejemplo, puede configurar una alarma que le avise cuando la utilización de la CPU de un entorno supere un determinado umbral. De este modo, tendrá la seguridad de que se le informa antes de que se produzca un posible problema. Para obtener más información, consulte [Uso de Elastic Beanstalk con Amazon CloudWatch](AWSHowTo.cloudwatch.md).
**nota**
Elastic CloudWatch Beanstalk se usa para monitoreo y alarmas CloudWatch , lo que significa que los costos se aplican AWS a su cuenta por cualquier alarma que use.
Para obtener más información acerca de las métricas específicas de supervisión, consulte [Informes de estado básicos](using-features.healthstatus.md).
**Para comprobar el estado de las alarmas**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, elija **Alarmas**.
La página muestra una lista de alarmas existentes. Si alguna alarma está activa, se marcará con el icono de advertencia (![\[Image of the warning icon.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/warning.png)).
1. Para filtrar alarmas, elija el menú desplegable y a continuación, seleccione un filtro.
1. Para editar o eliminar una alarma, seleccione el icono de edición (![\[Image of a cog, which serves as the edit icon.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/cog.png)) o de eliminación (![\[Image of an x, which servers as the delete icon.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/x.png)), respectivamente.
**Para crear una alarma**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, seleccione **Supervisión**.
1. Busque la métrica para la que desea crear una alarma y a continuación, seleccione el icono de alarma (![\[Image of a bell, which serves as the alarm icon.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/bell.png)). Aparecerá la página **Add alarm (Agregar alarma)** .
1. Especifique los datos de la alarma:
+ **Name**: nombre de la alarma.
+ **Descripción** (opcional): breve descripción sobre la finalidad de la alarma.
+ **Period**: intervalo de tiempo entre lecturas.
+ **Threshold**: describe el comportamiento y el valor que la métrica debe superar para activar una alarma.
+ **Change state after**: periodo de tiempo tras el que se activa un cambio de estado de la alarma cuando se ha excedido un umbral.
+ **Notify (Notificar)**: el tema de Amazon SNS que se notifica cuando una alarma cambia de estado.
+ **Notify when state changes to**:
+ **OK**: la métrica está dentro del umbral definido.
+ **Alarm**: la métrica ha excedido el umbral definido.
+ **Insufficient data**: la alarma acaba de iniciarse, la métrica no está disponible o no hay suficientes datos disponibles en la métrica para determinar el estado de la alarma.
1. Elija **Añadir**. El estado del entorno cambia a gris cuando el entorno se actualiza. Puede ver la alarma creada si selecciona **Alrms (Alarmas)** en el panel de navegación.
# Visualización del historial de cambios de un entorno de Elastic Beanstalk
Este tema explica cómo puede utilizar la consola de administración de Elastic Beanstalk para ver un historial de cambios de configuración realizados en los entornos de Elastic Beanstalk.
Elastic Beanstalk recupera el historial de cambios de los eventos registrados en [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) y los muestra en una lista que puede explorar y filtrar fácilmente.
El panel Change History (Historial de cambios) muestra la siguiente información para los cambios realizados en los entornos:
+ La fecha y la hora en que se realizó un cambio
+ El usuario de IAM responsable de un cambio realizado
+ La herramienta de código abierto (consola o interfaz de línea de comandos de Elastic Beanstalk [CLI de EB]) que se utilizó para realizar el cambio
+ El parámetro de configuración y los nuevos valores que se establecieron
La información confidencial que forma parte del cambio, como los nombres de los usuarios de la base de datos afectados por el cambio, no se muestran en el panel.
**Para ver el historial de cambios, realice lo siguiente:**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Change history (Historial de cambios)**.
La página Change History (Historial de cambios) contiene una lista detallada con los cambios de configuración realizados en los entornos de Elastic Beanstalk.
Tenga en cuenta los siguientes puntos sobre la navegación por la información de esta página:
+ Puede pasar por la lista al seleccionar **<** (anterior) o **>** (siguiente), o un número de página específico.
+ En la columna **Configuration changes (Cambios de configuración)**, seleccione el ícono de flecha para alternar entre expandir y contraer la lista de cambios en el encabezado **Changes made (Cambios realizados)** .
+ Utilice la barra de búsqueda para filtrar los resultados de la lista del historial de cambios. Puede introducir cualquier cadena para acotar la lista de los cambios que se muestran.
Tenga en cuenta lo siguiente acerca del filtrado de los resultados que se muestran:
+ El filtro de búsqueda no distingue entre mayúsculas y minúsculas.
+ Puede filtrar los cambios que se muestran en función de la información de la columna **Configuration changes (Cambios de configuración)**, incluso cuando no esté visible debido a que se ha contraído dentro de **Changes made (Cambios realizados)**.
+ Solo puede filtrar los resultados que se muestran. Sin embargo, el filtro permanece incluso si selecciona ir a otra página para mostrar más resultados. Los resultados filtrados también se agregarán al conjunto de resultados de la página siguiente.
Los siguientes ejemplos muestran cómo se pueden filtrar los datos que se muestran en la pantalla anterior:
+ *Introduzca **GettingStartedApp-env** en el cuadro de búsqueda para restringir los resultados e incluir solo los cambios que se realizaron en el entorno denominado -env. GettingStartedApp*
+ Ingrese **example3** en el cuadro de búsqueda para acotar los resultados e incluir solo los cambios realizados por los usuarios de IAM cuyo nombre de usuario contiene la cadena *example3*.
+ Ingrese **2020-10** en el cuadro de búsqueda para acotar los resultados e incluir solo los cambios realizados durante el mes de octubre de 2020. Cambie el valor de búsqueda **2020-10-16** para filtrar más los resultados que se muestran e incluir solo los cambios realizados el día 16 de octubre de 2020.
+ Ingrese **proxy:staticfiles** en el cuadro de búsqueda para acotar los resultados e incluir solo los cambios realizados en el espacio de nombres llamado *aws:elasticbeanstalk:environment:proxy:staticfiles*. Las filas que se muestran son el resultado del filtro. Esto es cierto incluso para los resultados que se contraen en **Changes made (Cambios realizados)**.
# Visualización de la transmisión de eventos de un entorno de Elastic Beanstalk
Este tema explica cómo obtener acceso a los eventos y notificaciones relacionados con su aplicación.
## Visualización de eventos con la consola de Elastic Beanstalk
**Cómo ver eventos con la consola de Elastic Beanstalk**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, seleccione **Events (Eventos)**.
La página Events (Eventos) muestra una lista de todos los eventos que se han registrado para el entorno. Puede recorrer la lista eligiendo **<** (anterior), **>** (siguiente) o números de página. Puede filtrar por tipo de evento mediante la lista desplegable **Severity (Gravedad)**.
## Visualización de eventos con herramientas de línea de comando
La [CLI de EB](eb-cli3.md) y [AWS CLI](https://aws.amazon.com/cli/) proporcionan comandos para recuperar eventos. Si administra su entorno con la CLI de EB, use [**eb events**](eb3-events.md) para mostrar una lista de eventos. Este comando también tiene una opción `--follow` que continúa mostrando eventos hasta que pulsa **Ctrl\$1C** para detener la salida.
Para extraer eventos mediante el AWS CLI, utilice el `describe-events` comando y especifique el entorno por nombre o ID:
```
$ aws elasticbeanstalk describe-events --environment-id e-gbjzqccra3
{
"Events": [
{
"ApplicationName": "elastic-beanstalk-example",
"EnvironmentName": "elasticBeanstalkExa-env",
"Severity": "INFO",
"RequestId": "a4c7bfd6-2043-11e5-91e2-9114455c358a",
"Message": "Environment update completed successfully.",
"EventDate": "2015-07-01T22:52:12.639Z"
},
...
```
Para obtener más información acerca de estas herramientas de línea de comandos, consulte [Configuración de la interfaz de la línea de comandos de EB (CLI de EB) para administrar Elastic Beanstalk](eb-cli3.md).
# Listado y conexión a instancias de servidor
En este tema se explica cómo ver una lista de las EC2 instancias de Amazon que ejecutan el entorno de aplicaciones de Elastic Beanstalk y cómo conectarse a ellas.
Puede ver una lista de EC2 instancias de Amazon que ejecutan su entorno de AWS Elastic Beanstalk aplicaciones a través de la consola de Elastic Beanstalk. Puede conectarse a las instancias mediante cualquier cliente SSH. Puede conectarse a las instancias que ejecutan Windows a través de Escritorio remoto.
**importante**
Antes de poder acceder a las instancias de Amazon aprovisionadas por Elastic Beanstalk, debe crear un EC2 par de claves de EC2 Amazon y configurar el Amazon aprovisionado por Elastic Beanstalk para que utilice el par de claves de Amazon. EC2instances EC2 Puede configurar sus pares de EC2 claves de Amazon mediante la [consola AWS de administración](https://console.aws.amazon.com/). Para obtener instrucciones sobre cómo crear un key pair para Amazon EC2, consulta la *Guía de EC2 introducción de Amazon*. Para obtener más información sobre cómo configurar tus EC2 instancias de Amazon para que usen un EC2 key pair de Amazon, consulta[EC2 key pair](using-features.managing.security.md#using-features.managing.security.keypair).
De forma predeterminada, Elastic Beanstalk no habilita las EC2 conexiones remotas a las instancias de un contenedor de Windows, excepto a las de los contenedores de Windows heredados. (Elastic EC2 Beanstalk configura las instancias en contenedores de Windows antiguos para que usen el puerto 3389 para las conexiones RDP). Puede habilitar las conexiones remotas a las EC2 instancias que ejecutan Windows añadiendo una regla a un grupo de seguridad que autorice el tráfico entrante a las instancias. Es absolutamente recomendable que elimine la regla cuando finalice la conexión remota. Puede añadir la regla de nuevo la próxima vez que necesite iniciar sesión de forma remota. Para obtener más información, consulte [Adding a Rule for Inbound RDP Traffic to a Windows Instance](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/authorizing-access-to-an-instance.html#authorizing-access-to-an-instance-rdp) y [Connect to Your Windows Instance](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2Win_GetStarted.html#connecting_to_windows_instance) en la *Guía del usuario de Amazon Elastic Compute Cloud para Microsoft Windows*.
**Para ver las EC2 instancias de Amazon de un entorno y conectarse a ellas**
1. Abre la EC2 consola de Amazon en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación de la consola, elija **Load Balancers** (Balanceadores de carga).
1. Los balanceadores de carga creados por Elastic Beanstalk tienen **awseb** en el nombre. Busque el equilibrador de carga para su entorno y haga clic en él.
1. Elija la pestaña **Instances** (Instancias) en el panel inferior de la consola.
Se muestra una lista de las instancias que usa el equilibrador de carga para su entorno de Elastic Beanstalk. Anote el ID de la instancia a la que desea conectarse.
1. En el panel de navegación de la EC2 consola de Amazon, selecciona **Instances** y busca tu ID de instancia en la lista.
1. Haga clic con el botón derecho en el ID de instancia de la EC2 instancia de Amazon que se ejecuta en el balanceador de cargas de su entorno y, a continuación, seleccione **Connect** en el menú contextual.
1. Anote la dirección DNS pública de la instancia que aparece en la pestaña **Description**.
1. Conéctate a una instancia que ejecute Linux mediante el cliente SSH de tu elección y, a continuación, escribe **ssh -i .ec2/mykeypair.pem ec2-user@. of-the-instance
Para obtener más información sobre cómo conectarse a una instancia de Amazon EC2 Linux, consulte [Introducción a las instancias de Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) en la *Guía del EC2 usuario de Amazon*.
*Si su entorno de Elastic Beanstalk [utiliza la plataforma .NET en Windows](create_deploy_NET.container.console.md) Server, [consulte Introducción a las instancias de Amazon Windows en la Guía del usuario de EC2 Amazon](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2_GetStarted.html). EC2 *
# Visualización de registros de instancias de Amazon EC2 en su entorno de Elastic Beanstalk
En este tema se explican los tipos de registros de instancias que proporciona Elastic Beanstalk. También se muestran instrucciones detalladas para recuperarlos y administrarlos.
Las instancias EC2 de Amazon en el entorno de Elastic Beanstalk generan registros que se pueden consultar para solucionar problemas relacionados con la aplicación o los archivos de configuración. Los registros los crean el servidor web, el servidor de aplicaciones y los scripts CloudFormation de la plataforma Elastic Beanstalk y se almacenan localmente en instancias individuales. Puede recuperarlos de forma sencilla a través de la [consola de administración del entorno](environments-console.md) o la CLI de EB. También puede configurar su entorno para transmitir los registros a Amazon CloudWatch Logs en tiempo real.
Los registros de finalización son las últimas 100 líneas de los archivos de registro que se utilizan con más frecuencia: los registros operativos de Elastic Beanstalk y los registros del servidor web o del servidor de aplicaciones. Cuando se solicita un registro de finalización utilizando la consola de administración del entorno o **eb logs**, una instancia del entorno concatena las entradas del registro más frecuentes en un archivo de texto y lo carga a Amazon S3.
Los registros de paquete son registros completos para un mayor conjunto de archivos de registro, como los registros yum y cron o diversos registros de CloudFormation. Cuando solicita los registros de paquete, una instancia del entorno empaqueta todos los archivos de registro en un archivo ZIP y los carga a Amazon S3.
Para cargar los registros rotados en Amazon S3, las instancias del entorno deben tener un [perfil de instancia](concepts-roles-instance.md) con permiso para escribir en el bucket de Elastic Beanstalk de Amazon S3. Estos permisos están incluidos en el perfil de instancia predeterminado que Elastic Beanstalk le pide que cree cuando lanza un entorno en la consola de Elastic Beanstalk por primera vez.
**Para recuperar los registros de instancias:**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. En el panel de navegación, elija **Logs (Registros)**.
1. Seleccione **Request logs (Solicitar registro)**, y, a continuación, elija el tipo de registros que desea recuperar. Para obtener los registros de finalización, seleccione **Last 100 Lines**. Para obtener los registros de paquete, seleccione **Full Logs (Registros completos)**.
1. Cuando Elastic Beanstalk termine de recuperar sus registros, elija **Descargar**.
Elastic Beanstalk almacena los registros de finalización y de paquetes en un bucket de Amazon S3 y genera una URL de Amazon S3 prefirmada que puede utilizar para acceder a sus registros. Elastic Beanstalk elimina los archivos de Amazon S3 después de una duración de 15 minutos.
**aviso**
Cualquier persona en posesión de la URL prefirmada de Amazon S3 puede acceder a los archivos antes de que se eliminen. Haga que la URL esté disponible únicamente para partes de confianza.
**nota**
La política de usuario debe tener el permiso `s3:DeleteObject`. Elastic Beanstalk utiliza sus permisos de usuario para eliminar los registros de Amazon S3.
Si desea conservar los registros, puede configurar el entorno para que los publique en Amazon S3 automáticamente después de rotarlos. Para habilitar la rotación de registros en Amazon S3, siga el procedimiento en [Configuración de la visualización de registros de instancias](environments-cfg-logging.md#environments-cfg-logging-console). Las instancias del entorno intentarán cargar los logs que se han rotado una vez cada hora.
Si la aplicación genera registros en una ubicación que no forma parte de la configuración predeterminada de la plataforma del entorno, puede extender la configuración predeterminada con los archivos de configuración (`[.ebextensions](ebextensions.md)`). Puede agregar los archivos log de la aplicación a los logs de finalización, los logs de paquete o la rotación de logs.
Para la transmisión de registros en tiempo real y el almacenamiento a largo plazo, configure su entorno para [transmitir los registros a Amazon CloudWatch Logs](#health-logs-cloudwatchlogs).
Para obtener un análisis basado en inteligencia artificial de los registros, los eventos y el estado de las instancias de su entorno a fin de identificar las causas fundamentales y las soluciones de los problemas de salud, consulte. [Análisis del entorno impulsado por IA](health-ai-analysis.md)
**Topics**
+ [Ubicación de registro en instancias de Amazon EC2](#health-logs-instancelocation)
+ [Ubicación de registro en Amazon S3](#health-logs-s3location)
+ [Configuración de rotación de registros en Linux](#health-logs-logrotate)
+ [Ampliación de la configuración predeterminada de la tarea de registro](#health-logs-extend)
+ [Transmisión de archivos de registro a Amazon CloudWatch Logs](#health-logs-cloudwatchlogs)
## Ubicación de registro en instancias de Amazon EC2
Los registros se almacenan en ubicaciones estándar de las instancias Amazon EC2 de su entorno. Elastic Beanstalk genera los siguientes registros.
**Amazon Linux 2**
+ `/var/log/eb-engine.log`
**AMI de Amazon Linux (AL1)**
**nota**
[El 18 de julio de 2022,](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2022-07-18-linux-al1-retire.html) **Elastic Beanstalk estableció el estado de todas las ramas de plataforma basadas en la AMI AL1 de Amazon Linux () como retiradas.** Para obtener más información sobre la migración a una ramificación de la plataforma Amazon Linux 2023 actual y totalmente compatible, consulte [Migración de su aplicación de Linux de Elastic Beanstalk a Amazon Linux 2023 o Amazon Linux 2](using-features.migration-al.md).
+ `/var/log/eb-activity.log`
+ `/var/log/eb-commandprocessor.log`
**Windows Server**
+ `C:\Program Files\Amazon\ElasticBeanstalk\logs\`
+ `C:\cfn\log\cfn-init.log`
Estos registros contienen mensajes sobre las actividades de implementación, como mensajes relacionados con los archivos de configuración ([`.ebextensions`](ebextensions.md)).
Cada aplicación y cada servidor web guarda los logs en su propia carpeta:
+ **Apache**: `/var/log/httpd/`
+ **IIS**: `C:\inetpub\wwwroot\`
+ **Node.js**: `/var/log/nodejs/`
+ **nginx**: `/var/log/nginx/`
+ **Passenger**: `/var/app/support/logs/`
+ **Puma**: `/var/log/puma/`
+ **Python**: `/opt/python/log/`
+ **Tomcat**: `/var/log/tomcat/`
## Ubicación de registro en Amazon S3
Cuando solicita los registros de finalización o de paquete del entorno o cuando las instancias cargan registros rotados, se guardan en el bucket de Elastic Beanstalk de Amazon S3. Elastic Beanstalk crea un `elasticbeanstalk-region-account-id` bucket con el nombre de cada región en la que se crean AWS los entornos. En este bucket, los logs se guardan en la ruta `resources/environments/logs/logtype/environment-id/instance-id`.
Por ejemplo, los registros de la instancia`i-0a1fd158`, en el AWS entorno de Elastic `e-mpcwnwheky` Beanstalk `us-west-2` en la región de la cuenta, se `123456789012` almacenan en las siguientes ubicaciones:
+ **Registros de finalización**:
`s3://elasticbeanstalk-us-west-2-123456789012/resources/environments/logs/tail/e-mpcwnwheky/i-0a1fd158`
+ **Registros de paquete**:
`s3://elasticbeanstalk-us-west-2-123456789012/resources/environments/logs/bundle/e-mpcwnwheky/i-0a1fd158`
+ **Registros rotados**:
`s3://elasticbeanstalk-us-west-2-123456789012/resources/environments/logs/publish/e-mpcwnwheky/i-0a1fd158`
**nota**
Encontrará el ID del entorno en la consola de administración del entorno.
Elastic Beanstalk elimina automáticamente los registros de finalización y de paquetes de Amazon S3 15 minutos después de su creación. Los registros rotados se mantienen hasta que se eliminan o se transfieren a Amazon Glacier.
## Configuración de rotación de registros en Linux
En plataformas Linux, Elastic Beanstalk utiliza `logrotate` para rotar registros periódicamente. Si se ha configurado de este modo, cuando un registro ha rotado localmente, la tarea de rotación de registros lo selecciona y lo carga en Amazon S3. Los registros que han rotado localmente no aparecen de forma predeterminada en los registros de finalización o de paquete.
Puede encontrar los archivos de configuración de Elastic Beanstalk para `logrotate` en `/etc/logrotate.elasticbeanstalk.hourly/`. Esta configuración de rotación es específica de la plataforma y puede cambiar en futuras versiones de la plataforma. Para obtener más información sobre los ajustes disponibles y configuraciones de ejemplo, ejecute `man logrotate`.
Los archivos de configuración se invocan mediante trabajos cron en `/etc/cron.hourly/`. Para obtener más información acerca de `cron`, ejecute `man cron`.
## Ampliación de la configuración predeterminada de la tarea de registro
Elastic Beanstalk utiliza archivos que se encuentran en las subcarpetas de `/opt/elasticbeanstalk/tasks` (Linux) o de `C:\Program Files\Amazon\ElasticBeanstalk\config` (Windows Server) de la instancia de Amazon EC2 para configurar tareas en los registros de finalización, los registros de paquete y la rotación de registros.
**En Amazon Linux:**
+ **Registros de finalización**:
`/opt/elasticbeanstalk/tasks/taillogs.d/`
+ **Registros de paquete**:
`/opt/elasticbeanstalk/tasks/bundlelogs.d/`
+ **Registros rotados**:
`/opt/elasticbeanstalk/tasks/publishlogs.d/`
**En Windows Server:**
+ **Registros de finalización**:
`c:\Program Files\Amazon\ElasticBeanstalk\config\taillogs.d\`
+ **Registros de paquete**:
`c:\Program Files\Amazon\ElasticBeanstalk\config\bundlelogs.d\`
+ **Registros rotados**:
`c:\Program Files\Amazon\ElasticBeanstalk\config\publogs.d\`
Por ejemplo, el archivo `eb-activity.conf` en Linux agrega dos archivos de registro a la tarea de registros de finalización.
**`/opt/elasticbeanstalk/tasks/taillogs.d/eb-activity.conf `**
```
/var/log/eb-commandprocessor.log
/var/log/eb-activity.log
```
Puede utilizar archivos de configuración del entorno (`[.ebextensions](ebextensions.md)`) para agregar sus propios archivos `.conf` a estas carpetas. Un archivo `.conf` muestra los archivos de registro específicos de su aplicación que Elastic Beanstalk agrega a las tareas de archivo de registro.
Utilice la sección `files` para agregar archivos de configuración a las tareas que desea modificar. Por ejemplo, el siguiente texto de configuración inserta un archivo de configuración de log en cada instancia del entorno. Este archivo de configuración de log, `cloud-init.conf`, añade `/var/log/cloud-init.log` a los registros de cola.
```
files:
"/opt/elasticbeanstalk/tasks/taillogs.d/cloud-init.conf" :
mode: "000755"
owner: root
group: root
content: |
/var/log/cloud-init.log
```
Agregue este texto a un archivo que tenga la extensión de nombre de archivo `.config` en el paquete de código fuente dentro de una carpeta llamada `.ebextensions`.
```
~/workspace/my-app
|-- .ebextensions
| `-- tail-logs.config
|-- index.php
`-- styles.css
```
En las plataformas Linux también puede utilizar caracteres comodín en las configuraciones de tareas de registro. Este archivo de configuración agrega todos los archivos con la extensión de nombre de archivo `.log` de la carpeta `log` de la raíz de la aplicación a los logs de paquete.
```
files:
"/opt/elasticbeanstalk/tasks/bundlelogs.d/applogs.conf" :
mode: "000755"
owner: root
group: root
content: |
/var/app/current/log/*.log
```
Las configuraciones de tarea de registro no admiten comodines en las plataformas de Windows.
**nota**
Para familiarizarse con los procedimientos de personalización de registros, puede implementar una aplicación de muestra mediante la [CLI de EB](eb-cli3.md). Para ello, la CLI de EB crea un directorio de aplicación local que contiene un subdirectorio de `.ebextentions` con una configuración de ejemplo. También puede utilizar los archivos de registro de la aplicación de muestra para explorar la característica de recuperación de registros descrita en este tema.
Para obtener más información sobre cómo usar archivos de configuración, consulte [Personalización avanzada de entornos con archivos de configuración (`.ebextensions`)](ebextensions.md).
De forma parecida a la ampliación de registros de finalización y los registros de paquete, puede ampliar lo rotación de registros con un archivo de configuración. Siempre que Elastic Beanstalk rota sus propios registros y los carga a Amazon S3, también rota y carga los registros adicionales. La extensión de rotación de registros se comporta de forma distinta en función del sistema operativo de la plataforma. En las siguientes secciones se describen los dos casos.
### Ampliación de la rotación de registros en Linux
Como se explica en [Configuración de rotación de registros en Linux](#health-logs-logrotate), Elastic Beanstalk utiliza `logrotate` para rotar registros en plataformas Linux. Al configurar los archivos de registro de su aplicación para la rotación de registros, la aplicación no necesita crear copias de los archivos de registro. Elastic Beanstalk configura `logrotate` para crear una copia de los archivos de registro de la aplicación para cada rotación. Por lo tanto, la aplicación debe mantener archivos de registro desbloqueados cuando no escriba en ellos de forma activa.
### Ampliación de la rotación de registros en Windows Server
En Windows Server, al configurar los archivos de registro de su aplicación para la rotación de registros, la aplicación debe rotarlos periódicamente. Elastic Beanstalk busca los archivos con los nombres que comiencen por el patrón que ha configurado y los elige para cargarlos a Amazon S3. Además, se ignoran los puntos en el nombre de archivo y Elastic Beanstalk considera que el nombre hasta el punto será el nombre de archivo de registro base.
Elastic Beanstalk carga todas las versiones de un archivo de registro base excepto la más reciente, puesto que considera que es le archivo de registro de aplicación activo, que podría estar bloqueado. Por lo tanto, la aplicación puede mantener el archivo de registro bloqueado entre las rotaciones.
Ejemplo: su aplicación escribe en un archivo de registro denominado `my_log.log` y especifica este nombre en su archivo `.conf`. La aplicación rota de forma periódica el archivo. Durante el ciclo de rotación de Elastic Beanstalk, encuentra los siguientes archivos en la carpeta del archivo de registro: `my_log.log`, `my_log.0800.log`, `my_log.0830.log`. Elastic Beanstalk los considera a todos como versiones del nombre base `my_log`. El archivo `my_log.log` tiene la hora de modificación más reciente, por lo que Elastic Beanstalk carga solo los otros dos archivos, `my_log.0800.log` y `my_log.0830.log`.
## Transmisión de archivos de registro a Amazon CloudWatch Logs
[Puede configurar su entorno para transmitir los registros a Amazon CloudWatch Logs en la consola de Elastic Beanstalk o mediante las opciones de configuración.](command-options.md) Con CloudWatch Logs, cada instancia de su entorno transmite los registros a grupos de registros que puede configurar para que se conserven durante semanas o años, incluso después de cerrar el entorno.
El conjunto de registros transmitidos varía en función del entorno, pero siempre incluye los registros `eb-engine.log` y de acceso del servidor proxy de nginx o Apache que se ejecuta delante de la aplicación.
Puede configurar la transmisión de registros en la consola de Elastic Beanstalk [durante la creación de entorno](environments-create-wizard.md#environments-create-wizard-software) o [para un entorno existente](environments-cfg-logging.md#environments-cfg-logging-console). Puede configurar las siguientes opciones desde la consola: habilitar o deshabilitar la transmisión de CloudWatch registros a los registros, establecer el número de días de retención y seleccionar una de las opciones de ciclo de vida. En el siguiente ejemplo, los registros se guardan durante un máximo de siete días, incluso cuando el entorno ha terminado.
![\[Imagen de pantalla de la configuración de CloudWatch Logs en la consola de Elastic Beanstalk.\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/log-streaming-screen.png)
El siguiente [archivo de configuración](ebextensions.md) habilita la transmisión de registros con 180 días de retención, incluso si el entorno ha terminado.
**Example .ebextensions/log-streaming.config**
```
option_settings:
aws:elasticbeanstalk:cloudwatch:logs:
StreamLogs: true
DeleteOnTerminate: false
RetentionInDays: 180
```
# Visualización de los registros de implementación de un entorno de Elastic Beanstalk
Elastic Beanstalk genera un registro de implementación para cada implementación en su entorno. El registro de implementación proporciona una vista cronológica consolidada de lo que ocurrió durante una implementación, incluida la instalación de las dependencias, el resultado de la compilación, el inicio de la aplicación y cualquier error encontrado. Puede usar los registros de implementación para diagnosticar rápidamente las implementaciones fallidas sin necesidad de utilizar SSH en las instancias ni correlacionar varios archivos de registro.
Los registros de implementación se escriben en cada instancia de forma local. En el caso de las implementaciones activadas mediante la consola, la CLI, la API o las actualizaciones gestionadas, una instancia carga su registro de forma continua en Amazon S3 durante la implementación. La consola de Elastic Beanstalk lee el registro de Amazon S3 para que pueda supervisar el progreso sin necesidad de conectarse a la instancia.
Los registros de implementación están diseñados para ser concisos. En caso de éxito, el registro muestra solo los mensajes resumidos (por ejemplo, qué comandos se ejecutaron y qué se completaron). En caso de error, el registro incluye hasta 50 líneas de salida del paso fallido, para que pueda ver el error sin tener que revisar los resultados detallados.
**nota**
Los registros de implementación están disponibles en las versiones de plataforma [Amazon Linux 2](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2.html) [y Amazon Linux 2023](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2023.html) publicadas a partir del 11 de marzo de 2026. Las plataformas Windows no son compatibles actualmente.
## Operaciones admitidas
Los registros de implementación se generan para las siguientes operaciones:
+ **Implementaciones de aplicaciones**: implementación de una nueva versión de la aplicación en su entorno.
+ **Actualizaciones de configuración**: cambiar los ajustes de configuración del entorno que requieren actualizaciones de instancias.
+ **Creación del entorno**: la implementación inicial al crear un entorno nuevo.
+ **Reiniciar el servidor de aplicaciones**: reiniciar el servidor de aplicaciones en las instancias.
Las operaciones que no modifican el estado de la aplicación o la configuración de las instancias, como la solicitud de registros, el intercambio o la actualización de etiquetas CNAMEs, no generan registros de implementación.
## Contenido del registro de implementación
Un registro de implementación captura la siguiente información durante una implementación:
+ **Ciclo de vida de la implementación**: mensajes de inicio y finalización de cada fase de la implementación, como `Starting Application deployment` y`Completed Application deployment`.
+ **Resultado de.ebextensions**: en caso de éxito, los nombres de los comandos que se ejecutaron. En caso de error, las últimas 50 líneas de `cfn-init` salida ayudan a diagnosticar el problema.
+ **Salida de enlaces de plataforma**: en caso de éxito, los nombres de los scripts de enlace que se ejecutaron. En caso de error, salen las últimas 50 líneas del gancho.
+ **Instalación de dependencias**: salida de administradores de paquetes como **npm install****pip install**,**composer install**, y**bundle install**. En caso de éxito, solo se registra un mensaje de finalización. En caso de error, se incluyen las últimas 50 líneas de salida.
+ **Salida de compilación**: salida de comandos de compilación como **docker build****go build**, y compilaciones de Java. En caso de error, se incluyen las últimas 50 líneas de salida.
+ **Salida de inicio de la aplicación**: salida inicial de la aplicación después de que se inicie. La fuente depende de la plataforma:
+ *Docker*: contiene registros de **docker logs** o **docker compose logs**
+ *Java SE, Go, Node.js, Python, Ruby, .NET: registros* stdout de procesos
+ Salida del *registro Tomcat* — Catalina
+ *PHP: registros* de errores maestros y de grupos de PHP-FPM
+ *ECS*: registros de contenedores de cada contenedor de tareas
**nota**
El resultado de la aplicación se captura a partir de 2 segundos después de que se inicie la aplicación. Solo se incluyen los mensajes de inicio iniciales; si la aplicación tarda más en generar resultados, no aparecerá en el registro de implementación. Para ver los registros completos de la aplicación, solicita los registros del paquete o conéctate directamente a la instancia. Para obtener más información, consulte [Consulta de los registros de instancias](using-features.logging.md).
Cuando se produce un error en un paso de implementación, el registro lo marca con un máximo de 50 líneas de salida del paso fallido `[ERROR]` e incluye hasta 50 líneas de salida. Si el registro de implementación no contiene suficientes detalles, puedes recuperar los registros completos de la instancia (incluidos `eb-engine.log` los registros de las aplicaciones y los de las aplicaciones) desde la pestaña **Registros**. `eb-hooks.log` Para obtener más información, consulte [Visualización de registros de instancias de Amazon EC2 en su entorno de Elastic Beanstalk](using-features.logging.md).
## Ver los registros de implementación en la consola
La consola de Elastic Beanstalk **incluye** una pestaña Implementaciones en el panel del entorno en la que puede ver el historial y los registros de las implementaciones.
### Visualización del historial de despliegues
**Para ver el historial de despliegues**
1. Abra la consola de [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk) y, **en** la lista Regiones, seleccione su. Región de AWS
1. En el panel de navegación, elija **Environments** (Entornos) y, a continuación, elija el nombre del entorno en la lista.
1. **En el panel de control del entorno, elija la pestaña Implementaciones.**
La pestaña Despliegues muestra una tabla de despliegues para el entorno. Cada fila incluye la siguiente información:
+ **ID de solicitud**: el identificador único de la implementación.
+ **Estado**: *exitoso*, *fallido* o *en curso*.
+ **Tipo**: el tipo de implementación, como *creación del entorno*, *implementación de aplicaciones*, actualización de *configuración, actualización* de *plataforma gestionada*, *reinicio del servidor de aplicaciones*, *reconstrucción del entorno*, *entorno de restauración*, *intercambio de dominio del entorno* o *finalización del entorno*.
+ **Hora de inicio**: cuando comenzó la implementación.
+ **Duración**: cuánto tiempo tardó en completarse la implementación.
Cuando hay una implementación en curso, la pestaña sondea automáticamente las actualizaciones. También puede pulsar el botón de actualización para volver a cargar la lista manualmente.
### Ver los detalles y los registros de la implementación
**Para ver los detalles de la implementación**
1. En la pestaña **Implementaciones**, elija el enlace de **ID de solicitud** de la implementación que desee inspeccionar.
1. La página de detalles del despliegue muestra una sección de resumen con el identificador de la solicitud, el estado, el tipo de despliegue, la hora de inicio, la duración y la política de despliegue. *La política de despliegue (por ejemplo, «*Todo a la vez*», «*Continuación por lotes*», «*Inmutable*» o «*División del tráfico*») se muestra cuando se puede determinar a partir de los eventos de despliegue.*
1. Debajo del resumen, elija una de las siguientes pestañas:
+ **Eventos**: cronología de los eventos relacionados con esta implementación, filtrada para mostrar solo los eventos de la implementación seleccionada.
+ **Registros de despliegue**: el registro de despliegue consolidado de la instancia. Puede buscar, filtrar por nivel de registro y descargar el archivo de registro.
En el caso de las implementaciones en curso, la pestaña de registros se actualiza automáticamente para mostrar las nuevas entradas de registro a medida que se escriben. Una vez completada la implementación, la consola recupera el estado final del registro para garantizar que veas el resultado completo.
**importante**
Para ver los registros de implementación en la consola, se requiere `s3:GetObject` permiso en el depósito de almacenamiento Amazon S3 del entorno (`elasticbeanstalk-region-account-id`). Si su política de IAM no incluye este permiso, el historial de implementación y los eventos seguirán estando disponibles, pero la pestaña de registros mostrará un error.
## Archivos de registro de despliegue en las instancias
Los registros de implementación se escriben en el `/var/log/deployments/` directorio de cada instancia. El nombre del archivo de registro depende de cómo se haya activado la implementación:
+ **Implementaciones controladas por el flujo de trabajo** (activadas a través de la consola, la CLI o la API):`eb-deployment-request-id.log`, donde *request-id* está el identificador único de la solicitud de implementación.
+ **Implementaciones de inicio automático** (inicio de instancias o reinicio del servidor de aplicaciones) —. `eb-deployment-unix-timestamp.log`
Elastic Beanstalk rota automáticamente estos archivos y conserva los 50 registros de implementación más recientes en cada instancia.
En el caso de las implementaciones controladas por el flujo de trabajo, el registro se carga en Amazon S3 en la siguiente ruta:
```
s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename
```
En entornos de varias instancias, la primera instancia que comience a cargarse asume la función de toda la implementación. Esa instancia carga su registro en Amazon S3 durante la implementación. Todas las instancias siguen escribiendo los registros de implementación de forma local.
**importante**
Para cargar los registros de implementación en Amazon S3 se requiere `s3:PutObject` permiso en el depósito de almacenamiento de Amazon S3 del entorno en el perfil de la instancia, y la configuración de la VPC debe permitir la conectividad a Amazon S3.
Las cargas de los registros de implementación tienen un límite de 1 MB por archivo. Si un registro de despliegue supera este tamaño, la versión cargada se trunca con un mensaje que indica que el registro completo está disponible en la instancia.
### Inhabilitar las cargas de registros de S3
Para evitar que los registros de implementación se carguen en Amazon S3, defina la siguiente propiedad de entorno en su entorno:
```
option_settings:
- namespace: aws:elasticbeanstalk:application:environment
option_name: EB_DEPLOYMENT_LOG_S3_DISABLED
value: true
```
Cuando se establece esta propiedad del entorno, los registros de implementación se siguen escribiendo localmente `/var/log/deployments/` en cada instancia, pero no se cargan en Amazon S3 y no estarán disponibles en la pestaña **Implementaciones** de la consola. También puede establecer esta propiedad en la página de **configuración**, en **Software**, o mediante la CLI de EB o AWS CLI.