Uso de informes de estado mejorados con la API de Elastic Beanstalk

Como los informes de estado mejorados de AWS Elastic Beanstalk tienen requisitos de rol y de pila de soluciones, debe actualizar los scripts y el código que usó antes de que se lanzara la funcionalidad mejorada de informes de estado para poder usarlos. 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.

Los informes de estado mejorados se configuran definiendo el rol del servicio, el perfil de instancia y las opciones de configuración de Amazon CloudWatch 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 utilizar la API, los SDK o la interfaz de línea de comandos (CLI) de AWS con el objetivo de crear un entorno que admita un estado mejorado, debe hacer lo siguiente:

• Crear un rol de servicio y un perfil de instancia con los permisos adecuados

• Crear un nuevo entorno con una nueva versión de la plataforma

• Definir las opciones de configuración 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:launchconfigurationy 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 define las métricas de instancia y del entorno que se publican en 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.