Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation des rapports améliorés sur l'état à l'aide de l'API Elastic Beanstalk
<a name="health-enhanced-api"></a>

Étant donné que les rapports d'état AWS Elastic Beanstalk améliorés ont des exigences en matière de rôles et de solutions, vous devez mettre à jour les scripts et le code que vous utilisiez avant la publication des rapports d'état améliorés avant de pouvoir les utiliser. Pour assurer la rétrocompatibilité, les rapports améliorés sur l'état ne sont pas activés par défaut lorsque vous créez un environnement à l'aide de l'API Elastic Beanstalk.

Vous configurez des rapports de santé améliorés en définissant le rôle de service, le profil d'instance et les options CloudWatch de configuration Amazon pour votre environnement. Vous pouvez le faire de trois façons : en définissant les options de configuration dans le dossier `.ebextensions`, avec des configurations enregistrées ou en les configurant directement dans le paramètre `create-environment` de l'appel `option-settings`.

Pour utiliser l'API ou l'interface de ligne de AWS commande (CLI) afin de créer un environnement prenant en charge l'amélioration de la santé, vous devez : SDKs
+ Créez un rôle de service et un profil d'instance avec les [autorisations](concepts-roles.md) appropriées.
+ Créez un nouvel environnement avec une nouvelle [version de plateforme](concepts.platforms.md)
+ Définissez les [options de configuration](command-options.md) du type de système d'état, du profil d'instance et du rôle de service.

Utilisez les options de configuration suivantes dans les espaces de noms `aws:elasticbeanstalk:healthreporting:system`, `aws:autoscaling:launchconfiguration` et `aws:elasticbeanstalk:environment` afin de configurer votre environnement pour les rapports améliorés sur l'état. 

## Options de configuration des rapports améliorés sur l'état
<a name="health-enhanced-api-options"></a>

**SystemType**

Espace de nom : `aws:elasticbeanstalk:healthreporting:system`

Pour activer les rapports améliorés sur l'état, définissez l'option sur **enhanced**.

**IamInstanceProfile**

Espace de nom : `aws:autoscaling:launchconfiguration`

Choisissez le nom d'un profil d'instance configuré pour être utilisé avec Elastic Beanstalk.

**ServiceRole**

Espace de nom : `aws:elasticbeanstalk:environment`

Choisissez le nom d'un rôle de service configuré pour être utilisé avec Elastic Beanstalk.

**ConfigDocument** (facultatif)

Espace de nom : `aws:elasticbeanstalk:healthreporting:system`

Document JSON qui définit les métriques d'instance et d'environnement sur lesquelles publier CloudWatch. Par exemple :

```
{
  "CloudWatchMetrics":
    {
    "Environment":
      {
      "{{ApplicationLatencyP99.9}}":60,
      "{{InstancesSevere}}":60
      }
    "Instance":
      {
      "{{ApplicationLatencyP85}}":60,
      "{{CPUUser}}": 60
      }
    }
  "Version":1
}
```

**Note**  
Les documents de configuration peuvent exiger une mise en forme spéciale, comme des guillemets d'échappement, en fonction de la façon dont vous les fournissez à Elastic Beanstalk. Pour obtenir des exemples, consultez [Fourniture des documents de configuration des métriques personnalisées](health-enhanced-cloudwatch.md#health-enhanced-cloudwatch-configdocument).