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.
# Rapports et surveillance de l'état de santé améliorés dans Elastic Beanstalk
Cette section explique les fonctionnalités de la fonctionnalité Elastic Beanstalk Enhanced Health.
Les rapports de santé améliorés sont une fonctionnalité que vous pouvez activer dans votre environnement AWS Elastic Beanstalk pour recueillir des informations supplémentaires sur les ressources de votre environnement. Elastic Beanstalk analyse les informations recueillies pour fournir un meilleur aperçu de l'état global de l'environnement et permettre l'identification des problèmes pouvant entraîner une indisponibilité de votre application.
En plus des modifications dans le mode de fonctionnement des couleurs d'état, l'état amélioré ajoute un descripteur *statut* qui fournit un indicateur de la gravité des problèmes observés lorsqu'un environnement est jaune ou rouge. Lorsque davantage d'informations sont disponibles sur l'état actuel, vous pouvez choisir le bouton **Causes** pour afficher des informations d'état détaillées sur la [page d'état](health-enhanced-console.md).
Pour fournir des informations détaillées sur l'état des instances Amazon EC2 s'exécutant dans votre environnement, Elastic Beanstalk inclut un [agent de vérification de l'état](#health-enhanced-agent) dans l'AMI (Amazon Machine Image) pour chaque version de plateforme qui prend en charge les rapports améliorés sur l'état. L'agent de vérification de l'état surveille les journaux de serveur web et les métriques système et les transmet au service Elastic Beanstalk. Elastic Beanstalk analyse ces métriques et ces données issues d'Elastic Load Balancing et d'Amazon EC2 Auto Scaling pour fournir un aperçu global de l'état d'un environnement.
Outre la collecte et la présentation des informations relatives aux ressources de votre environnement, Elastic Beanstalk surveille les ressources de votre environnement pour plusieurs conditions d'erreur et fournit des notifications pour vous aider à éviter les défaillances et à résoudre les problèmes de configuration. [Les facteurs susceptibles d'influer sur l'état de votre environnement](#health-enhanced-factors) incluent les résultats de chaque demande de votre application, les métriques du système d'exploitation de vos instances et l'état du déploiement le plus récent.
Vous pouvez afficher l'état de santé en temps réel en utilisant la page de [présentation de l'environnement](health-enhanced-console.md) de la console Elastic Beanstalk ou la commande [eb health](health-enhanced-ebcli.md) de l'[interface de ligne de commande Elastic Beanstalk](eb-cli3.md). Pour enregistrer et suivre l'état de santé de l'environnement et de l'instance au fil du temps, vous pouvez configurer votre environnement pour publier les informations recueillies par Elastic Beanstalk afin d'améliorer les rapports de santé sur Amazon sous forme de CloudWatch métriques personnalisées. CloudWatch les [frais](https://aws.amazon.com/cloudwatch/pricing/) relatifs aux mesures personnalisées s'appliquent à toutes les mesures autres que celles `EnvironmentHealth` qui sont gratuites.
**Remarques sur la plateforme Windows**
Lorsque vous activez les rapports améliorés sur l'état de santé pour un environnement Windows Server, ne modifiez pas la [configuration de la journalisation IIS](https://docs.microsoft.com/en-us/iis/manage/provisioning-and-managing-iis/configure-logging-in-iis). Pour que la surveillance améliorée de l'état de santé fonctionne correctement, la journalisation IIS doit être configurée avec le format **W3C** et les destinations d'événements de journal **ETW event only** ou **Both log file and ETW event**.
Par ailleurs, ne désactivez pas ou n'arrêtez pas le service Windows de l'[agent de vérification de l'état Elastic Beanstalk](#health-enhanced-agent) sur les instances de votre environnement. Pour collecter et signaler des informations d'état de santé améliorées sur une instance, ce service doit être activé et en cours d'exécution.
La première fois que vous créez un environnement, Elastic Beanstalk vous invite à créer les rôles requis et permet d'améliorer les rapports de santé par défaut. Poursuivez votre lecture pour en savoir plus sur le fonctionnement des rapports améliorés sur l'état, ou consultez [Activation des rapports améliorés sur l'état Elastic Beanstalk](health-enhanced-enable.md) pour commencer à utiliser immédiatement ces rapports.
**Topics**
+ [Agent de vérification de l'état Elastic Beanstalk](#health-enhanced-agent)
+ [Facteurs de détermination de l'intégrité de l'environnement et de l'instance](#health-enhanced-factors)
+ [Personnalisation d'une règle de vérification de l'état](#health-enhanced.rules)
+ [Rôles d'intégrité améliorée](#health-enhanced-roles)
+ [Autorisation de santé améliorée](#health-enhanced-authz)
+ [Événements d'intégrité améliorée](#health-enhanced-events)
+ [Comportement de la création de rapports d'intégrité améliorée au cours des mises à jour, des déploiements et de la mise à l'échelle](#health-enhanced-effects)
+ [Activation des rapports améliorés sur l'état Elastic Beanstalk](health-enhanced-enable.md)
+ [Surveillance améliorée de l'état avec la console de gestion de l'environnement](health-enhanced-console.md)
+ [Couleurs et états utilisés dans les rapports d'intégrité](health-enhanced-status.md)
+ [Métriques des instances](health-enhanced-metrics.md)
+ [Configuration de règles d'intégrité améliorée pour un environnement](health-enhanced-rules.md)
+ [Publication de métriques CloudWatch personnalisées Amazon pour un environnement](health-enhanced-cloudwatch.md)
+ [Utilisation des rapports améliorés sur l'état à l'aide de l'API Elastic Beanstalk](health-enhanced-api.md)
+ [Format de journal d'intégrité améliorée](health-enhanced-serverlogs.md)
+ [Notifications et dépannage](environments-health-enhanced-notifications.md)
+ [Analyse de l'environnement basée sur l'IA](health-ai-analysis.md)
## Agent de vérification de l'état Elastic Beanstalk
L'agent de vérification de l'état Elastic Beanstalk est un processus démon (ou un service, dans les environnements Windows) qui s'exécute sur chaque instance Amazon EC2 de votre environnement, en surveillant les métriques d'état au niveau de l'application et du système d'exploitation et en signalant les problèmes à Elastic Beanstalk. L'agent d'état est inclus dans toutes les versions de plateforme Linux à partir de la version 2.0 de chaque plateforme.
L'agent de santé fournit des statistiques similaires à celles [publiées CloudWatch](using-features.healthstatus.md#monitoring-basic-cloudwatch) par Amazon EC2 Auto Scaling et Elastic Load Balancing dans le cadre [des rapports de santé de base](using-features.healthstatus.md), notamment la charge du processeur, les codes HTTP et la latence. Toutefois, l'agent de vérification de l'état rapporte les métriques directement à Elastic Beanstalk, avec une granularité et une fréquence supérieures aux rapports de base sur l'état.
Pour l'intégrité de base, ces métriques sont publiées toutes les cinq minutes et peuvent être contrôlées avec des graphiques dans la console de gestion d'environnement. Avec les rapports améliorés sur l'état, l'agent de vérification de l'état Elastic Beanstalk rapporte des métriques à Elastic Beanstalk toutes les 10 secondes. Elastic Beanstalk utilise les métriques fournies par l'agent de vérification de l'état pour déterminer l'état de santé de chaque instance dans l'environnement et, combinées à d'autres [facteurs](#health-enhanced-factors), pour déterminer l'état global de l'environnement.
L'état général de l'environnement peut être consulté en temps réel sur la page de présentation de l'environnement de la console Elastic Beanstalk et est publié CloudWatch par Elastic Beanstalk toutes les 60 secondes. Vous pouvez consulter en temps réel les métriques détaillées indiquées par l'agent d'état en utilisant la commande [**eb health**](health-enhanced-ebcli.md) dans l'[interface de ligne de commande EB](eb-cli3.md).
Moyennant des frais supplémentaires, vous pouvez choisir de publier des métriques individuelles au niveau de l'instance et de l'environnement CloudWatch toutes les 60 secondes. Les métriques publiées sur CloudWatch peuvent ensuite être utilisées pour créer des [graphiques de surveillance](environment-health-console.md#environment-health-console-customize) dans la [console de gestion d'environnement](environments-console.md).
La création de rapports d'intégrité améliorée n'implique un coût que si vous choisissez de publier des métriques d'intégrité améliorée sur CloudWatch. Lorsque vous utilisez l'intégrité améliorée, vous obtenez encore les métriques d'intégrité de base publiées gratuitement, même si vous ne choisissez pas de publier des métriques d'intégrité améliorée.
Pour obtenir des détails sur les métriques rapportées par l'agent de vérification de l'état, veuillez consulter [Métriques des instances](health-enhanced-metrics.md). Pour plus de détails sur la publication de statistiques de santé améliorées sur CloudWatch, voir[Publication de métriques CloudWatch personnalisées Amazon pour un environnement](health-enhanced-cloudwatch.md).
## Facteurs de détermination de l'intégrité de l'environnement et de l'instance
Outre les vérifications système des rapports de base sur l'état, notamment les [Vérifications de l'état Elastic Load Balancing](using-features.healthstatus.md#using-features.healthstatus.understanding) et la [surveillance des ressources](using-features.healthstatus.md#monitoring-basic-additionalchecks), les rapports améliorés sur l'état Elastic Beanstalk collectent des données supplémentaires sur l'état des instances de votre environnement. Sont incluses les métriques du système d'exploitation, les journaux de serveur et l'état des opérations d'environnement en cours, telles que les déploiements et les mises à jour. Le service de rapports sur l'état Elastic Beanstalk associe des informations issues de toutes les sources disponibles et les analyse pour évaluer l'état global de l'environnement.
### Opérations et commandes
Lorsque vous effectuez une opération dans votre environnement, telle que le déploiement d'une nouvelle version d'une application, Elastic Beanstalk apporte plusieurs modifications qui affectent l'état de santé de l'environnement.
Par exemple, lorsque vous déployez une nouvelle version d'une application dans un environnement qui exécute plusieurs instances, des messages similaires au suivant s'affichent lorsque vous surveillez l'état de santé de l'environnement [avec l'interface de ligne de commande 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
```
Dans cet exemple, l'état général de l'environnement est `Ok` et la cause de cet état est que la *commande s'exécute sur 3 des 5 instances*. Trois des instances dans l'environnement ont le statut *Pending*, indiquant qu'une opération est en cours.
Lorsqu'une opération est terminée, Elastic Beanstalk rapporte des informations complémentaires sur l'opération. A titre d'exemple, Elastic Beanstalk affiche les informations suivantes sur une instance qui a déjà été mise à jour avec la nouvelle version de l'application :
```
i-f6a2d525 Ok Application deployment completed 23 seconds ago and took 26 seconds
```
Les informations sur l'intégrité de l'instance incluent également des détails sur le déploiement le plus récent sur chaque instance dans votre environnement. Chaque instance indique un état et un ID de déploiement. L'ID de déploiement est un nombre entier qui augmente d'un niveau chaque fois que vous déployez une nouvelle version de votre application ou que vous modifiez les paramètres des options de configuration des instances, telles que les variables d'environnement. Vous pouvez utiliser les informations de déploiement pour identifier les instances qui exécutent la mauvaise version de votre application après un échec de [déploiement propagé](using-features.rolling-version-deploy.md).
Dans la colonne de cause, Elastic Beanstalk inclut des messages d'information sur la réussite des opérations et d'autres états sains pour différentes vérifications de l'état. Ces messages ne sont toutefois pas conservés indéfiniment. Les causes des statuts d'environnement défectueux sont conservées jusqu'à ce que l'environnement renvoie un état sain.
### Expiration de commande
Elastic Beanstalk applique un délai d'expiration de commande à partir du moment où une opération commence à autoriser une instance à effectuer la transition vers un état sain. Cette expiration de la commande est définie dans la configuration de déploiement et de mise à jour de votre environnement (dans l'espace de noms [aws:elasticbeanstalk:command](command-options-general.md#command-options-general-elasticbeanstalkcommand)) et est paramétrée par défaut sur 10 minutes.
Les mises à jour propagées sont l'occasion pour Elastic Beanstalk d'appliquer un délai d'expiration distinct à chaque lot dans l'opération. Cette expiration est définie dans le cadre de la configuration des mises à jour propagées de l'environnement (dans l'espace de noms [aws:autoscaling:updatepolicy:rollingupdate](command-options-general.md#command-options-general-autoscalingupdatepolicyrollingupdate)). Si toutes les instances dans le lot sont saines dans le délai de mise à jour continue, l'opération se poursuit et passe au lot suivant. Dans le cas contraire, l'opération échoue.
**Note**
Si votre application ne réussit pas les vérifications de l'état avec le statut **OK**, mais qu'elle est stable à un autre niveau, vous pouvez définir l'option `HealthCheckSuccessThreshold` dans l'espace de noms [`aws:elasticbeanstalk:command namespace`](command-options-general.md#command-options-general-elasticbeanstalkcommand) afin de modifier le niveau auquel Elastic Beanstalk considère une instance comme étant saine.
Pour qu'un environnement de serveur web soit considéré comme sain, chaque instance dans l'environnement ou le lot chaque instance doit réussir 12 vérifications de l'état consécutives en deux minutes. Dans un environnement de travail, chaque instance doit réussir 18 vérifications de l'état. Avant l'expiration de la commande, Elastic Beanstalk n'abaisse pas l'état de santé d'un environnement lorsque les vérifications de l'état échouent. Si les instances de l'environnement deviennent saines avant l'expiration de la commande, l'opération réussit.
### Requêtes HTTP
Lorsqu'aucune opération n'est en cours sur un environnement, la source principale d'informations sur l'intégrité de l'instance et de l'environnement repose sur les journaux de serveur web pour chaque instance. Pour déterminer l'état d'une instance et l'état global de l'environnement, Elastic Beanstalk prend en compte le nombre de demandes, le résultat de chaque demande et la vitesse à laquelle chaque demande a été résolue.
Sur les plateformes Linux, Elastic Beanstalk lit et analyse les journaux des serveurs web pour obtenir des informations sur les demandes HTTP. Sur la plateforme Windows Server, Elastic Beanstalk reçoit [directement ces informations du serveur web IIS](health-enhanced-metrics-server-iis.md).
Votre environnement peut ne pas avoir de serveur web actif. Par exemple, la plateforme Docker multi-conteneurs n'inclut pas de serveur web. Les autres plateformes comprennent un serveur web, et votre application peut le désactiver. Dans ces cas-là, votre environnement exige une configuration supplémentaire pour fournir à l'[agent de vérification de l'état Elastic Beanstalk](#health-enhanced-agent) les journaux au format dont il a besoin pour transmettre les informations d'état au service Elastic Beanstalk. Consultez [Format de journal d'intégrité améliorée](health-enhanced-serverlogs.md) pour plus de détails.
### Métriques du système d'exploitation
Elastic Beanstalk surveille les métriques du système d'exploitation rapportées par l'agent de vérification de l'état pour identifier les instances qui sont constamment à court de ressources système.
Pour obtenir des détails sur les métriques rapportées par l'agent de vérification de l'état, veuillez consulter [Métriques des instances](health-enhanced-metrics.md).
## Personnalisation d'une règle de vérification de l'état
Le rapport sur l'intégrité améliorée d’Elastic Beanstalk s'appuie sur un ensemble de règles qui déterminent l'intégrité de votre environnement. Certaines de ces règles peuvent ne pas être adaptées à votre application. Un cas courant est une application qui renvoie de fréquence erreurs HTTP 4xx en raison de sa conception. Elastic Beanstalk utilise l'une de ses règles par défaut pour conclure que quelque chose ne fonctionne pas correctement, puis modifie l'état de santé de votre environnement de OK à Avertissement, Dégradé ou Grave, en fonction du taux d'erreur. Pour gérer ce cas correctement, Elastic Beanstalk vous permet de configurer cette règle et d'ignorer les erreurs HTTP 4xx de l'application. Pour plus d'informations, consultez [Configuration de règles d'intégrité améliorée pour un environnement](health-enhanced-rules.md).
## Rôles d'intégrité améliorée
Les rapports améliorés sur l'état exigent deux rôles : un rôle de service pour Elastic Beanstalk et un profil d'instance pour l'environnement. Le rôle de service permet à Elastic Beanstalk d'interagir AWS avec d'autres services en votre nom afin de recueillir des informations sur les ressources de votre environnement. Le profil d'instance permet aux instances de votre environnement d'écrire des journaux dans Amazon S3 et de communiquer des informations améliorées sur l'état au service Elastic Beanstalk.
Lorsque vous créez un environnement Elastic Beanstalk à l'aide de la console Elastic Beanstalk ou de l'interface de ligne de commande EB, Elastic Beanstalk crée un rôle de service par défaut et attache les stratégies gérées requises à un profil d'instance par défaut pour votre environnement.
Si vous utilisez l'API, un SDK ou le AWS CLI pour créer des environnements, vous devez créer ces rôles à l'avance et les spécifier lors de la création de l'environnement afin d'améliorer l'intégrité. Pour obtenir des instructions sur la création de rôles appropriés pour vos environnements, veuillez consulter [Rôles d'Elastic Beanstalk Service, profils d'instance et politiques utilisateur](concepts-roles.md).
Nous vous recommandons d'utiliser des *stratégies gérées* pour votre profil d'instance et votre rôle de service. Les politiques gérées sont des politiques Gestion des identités et des accès AWS (IAM) gérées par Elastic Beanstalk. L'utilisation de stratégies gérées garantit que votre environnement dispose de toutes les autorisations nécessaires pour fonctionner correctement.
Pour le profil d'instance, vous pouvez utiliser la stratégie `AWSElasticBeanstalkWebTier` ou `AWSElasticBeanstalkWorkerTier` gérée, pour un environnement de [niveau serveur web](concepts-webserver.md) ou de [niveau de travail](concepts-worker.md), respectivement. Pour de plus amples informations sur ces deux stratégies de profil d'instance gérées, veuillez consulter [Gestion des profils d'instance Elastic Beanstalk](iam-instanceprofile.md).
## Autorisation de santé améliorée
Les stratégies gérées du profil d'instance Elastic Beanstalk contiennent des autorisations pour l'action `elasticbeanstalk:PutInstanceStatistics`. Cette action ne fait pas partie de l'API Elastic Beanstalk. Elle fait partie d'une autre API que les instances d'environnement utilisent en interne pour communiquer des informations améliorées sur l'état au service Elastic Beanstalk. Vous n'appelez pas cette API directement.
Lorsque vous créez un environnement, l'autorisation de l'action `elasticbeanstalk:PutInstanceStatistics` est activée par défaut. Pour renforcer la sécurité de votre environnement et prévenir l'usurpation des données d'état de santé en votre nom, nous vous recommandons de garder l’autorisation de cette action activée. Si vous utilisez des stratégies gérées pour votre profil d'instance, cette fonction est disponible pour votre nouvel environnement sans aucune autre configuration. Si vous utilisez un *profil d'instance personnalisé* au lieu d'une *stratégie gérée*, votre environnement peut afficher un état de santé **Aucune donnée**. Cela se produit car les instances ne sont pas autorisées pour l'action qui communique des données d'intégrité améliorées au service.
Pour autoriser l'action, incluez l'instruction suivante dans votre profil d'instance.
```
{
"Sid": "ElasticBeanstalkHealthAccess",
"Action": [
"elasticbeanstalk:PutInstanceStatistics"
],
"Effect": "Allow",
"Resource": [
"arn:aws:elasticbeanstalk:*:*:application/*",
"arn:aws:elasticbeanstalk:*:*:environment/*"
]
}
```
Si vous ne souhaitez pas utiliser l'autorisation d'état de santé améliorée pour le moment, désactivez-la en définissant l'option `EnhancedHealthAuthEnabled` dans l'espace de noms [aws:elasticbeanstalk:healthreporting:system](command-options-general.md#command-options-general-elasticbeanstalkhealthreporting) sur `false`. Si cette option est désactivée, les autorisations décrites précédemment ne sont pas requises. Vous pouvez les supprimer du profil d'instance pour accorder un [accès sur la base du moindre privilège](security-best-practices.md#security-best-practices.preventive.least-priv) à vos applications et environnements.
**Note**
Auparavant, le paramètre par défaut pour `EnhancedHealthAuthEnabled` était `false`, ce entraînait la désactivation par défaut de l’autorisation de l’action `elasticbeanstalk:PutInstanceStatistics`. Pour activer cette action pour un environnement existant, définissez l'option `EnhancedHealthAuthEnabled` dans l'espace de noms [aws:elasticbeanstalk:healthreporting:system](command-options-general.md#command-options-general-elasticbeanstalkhealthreporting) sur `true`. Vous pouvez configurer cette option à l'aide d'un [paramètre d'option](ebextensions-optionsettings.md) dans un [fichier de configuration](ebextensions.md).
## Événements d'intégrité améliorée
Le système d'intégrité améliorée génère des événements lorsqu'un environnement effectue la transition entre différents états. L'exemple suivant illustre la sortie d'événements provenant d'un environnement effectuant une transition entre les états **Infos**, **OK** et **Grave**.
![\[Page de présentation de l'environnement Elastic Beanstalk de la console Elastic Beanstalk affichant des événements récents d'état amélioré\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-events.png)
Lors du passage à un état dégradé, l'événement de rapport amélioré sur l'état de santé inclut un message indiquant la cause de la transition.
Les changements de statut au niveau de l'instance ne conduisent pas tous Elastic Beanstalk à émettre un événement. Pour éviter les fausses alarmes, Elastic Beanstalk ne génère d'événement d'état que si un problème persiste dans plusieurs vérifications.
Des informations d'état au niveau de l'environnement en temps réel, y compris le statut, la couleur et la cause, sont disponibles sur la page de [présentation de l'environnement](environments-dashboard.md) de la console Elastic Beanstalk et de l'[interface de ligne de commande EB](eb-cli3.md). En associant l'interface de ligne de commande EB à votre environnement et en exécutant la commande [**eb health**](health-enhanced-ebcli.md), vous pouvez aussi afficher les statuts en temps réel de chacune des instances dans votre environnement.
## Comportement de la création de rapports d'intégrité améliorée au cours des mises à jour, des déploiements et de la mise à l'échelle
Activer la création de rapports d'intégrité améliorée peut affecter le comportement de votre environnement au cours des déploiements et des mises à jour de configuration. Elastic Beanstalk ne termine pas un lot de mises à jour tant que toutes les instances n'ont pas réussi les vérifications de l'état. Par ailleurs, étant donné que les rapports améliorés sur l'état de santé appliquent un standard supérieur et surveille plusieurs facteurs, les instances qui réussissent la [vérification de l'état ELB](using-features.healthstatus.md#using-features.healthstatus.understanding) des rapports basiques sur l'état de santé ne réussissent pas forcément dans les rapports améliorés sur l'état de santé. Consultez les rubriques sur [rolling configuration updates](using-features.rollingupdates.md) et [rolling deployments](using-features.rolling-version-deploy.md) pour plus d'informations sur la façon dont les vérifications de l'état affectent le processus de mise à jour.
Les rapports améliorés sur l'état peuvent également mettre en évidence la nécessité de définir une [URL de vérification de l'état](environments-cfg-clb.md#using-features.managing.elb.healthchecks) correcte pour Elastic Load Balancing. Lorsque votre environnement s'adapte pour répondre à la demande, de nouvelles instances commencent à accepter des demandes dès qu'elles réussissent suffisamment de vérifications de l'état ELB. Si aucune URL de vérification de l'état n'est configurée, le délai après qu'une nouvelle instance soit capable d'accepter une connexion TCP peut se réduire à seulement 20 secondes.
Si votre application n'a pas fini de démarrer au moment où l'équilibreur de charge la déclare suffisamment saine pour recevoir du trafic, vous verrez un flot de demandes ayant échoué, et votre environnement commencera à échouer à des vérifications de l'état. Une URL de vérification de l'état qui atteint un chemin servi par votre application peut éviter ce problème. Les vérifications de l'état ELB ne réussissent pas tant qu'une demande GET adressée à l'URL de vérification de l'état n'a pas renvoyé un code de statut 200.
# Activation des rapports améliorés sur l'état Elastic Beanstalk
Cette rubrique explique comment les rapports de santé améliorés sont activés. Il fournit des procédures vous permettant d'activer la fonctionnalité d'intégrité améliorée pour votre environnement à l'aide de la console Elastic Beanstalk, de l'EB CLI et d'une configuration .ebextensions.
Les nouveaux environnements créés avec les dernières [versions de la plateforme](concepts.platforms.md) incluent l'[agent AWS Elastic Beanstalk de santé](health-enhanced.md#health-enhanced-agent), qui permet d'améliorer les rapports de santé. Si vous créez votre environnement dans la console Elastic Beanstalk ou avec l'interface de ligne de commande EB, les rapports améliorés sur l'état sont activés par défaut. Vous pouvez également définir vos préférences relatives aux rapports améliorés sur l'état dans le code source de votre application, à l'aide des [fichiers de configuration](ebextensions.md).
Les rapports améliorés sur l'état nécessitent un [profil d'instance](concepts-roles-instance.md) et un [rôle de service](concepts-roles-service.md) incluant l'ensemble standard d'autorisations. Lorsque vous créez un environnement dans la console Elastic Beanstalk, Elastic Beanstalk crée automatiquement les rôles nécessaires. Pour obtenir des instructions sur la création de votre premier environnement, consultez [Découvrez comment démarrer avec Elastic Beanstalk](GettingStarted.md).
**Topics**
+ [Activation des rapports améliorés sur l'état à l'aide de la console Elastic Beanstalk](#health-enhanced-enable-console)
+ [Activation des rapports d'intégrité améliorée via l'interface de ligne de commande EB](#health-enhanced-enable-ebcli)
+ [Activation des rapports d'intégrité améliorées via un fichier de configuration](#health-enhanced-enable-config)
## Activation des rapports améliorés sur l'état à l'aide de la console Elastic Beanstalk
**Pour activer les rapports améliorés sur l'état dans un environnement en cours d'exécution à l'aide de la console Elastic Beanstalk**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Dans le panneau de navigation, choisissez **Configuration**.
1. Dans la catégorie de configuration **Monitoring (Surveillance)**, choisissez **Edit (Modifier)**.
1. Dans la section **Rapport sur l'état de santé**, choisissez **Amélioré** dans le champ **Présentation**.
**Note**
Les options relatives aux rapports améliorés sur l'état de santé ne s'affichent pas si vous utilisez une [plateforme ou une version non prise en charge](health-enhanced.md).
1. Pour enregistrer les modifications, cliquez sur **Appliquer** en bas de la page.
La console Elastic Beanstalk active par défaut les rapports améliorés sur l'état lorsque vous créez un environnement avec la version 2 (v2) de la plateforme. Vous pouvez désactiver les rapports améliorés sur l'état en modifiant l'option des rapports sur l'état lors de la création de l'environnement.
**Pour désactiver les rapports améliorés sur l'état lors de la création d'un environnement à l'aide de la console Elastic Beanstalk**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. [Créez une application](applications.md) ou sélectionnez une application existante.
1. [Créez un environnement](using-features.environments.md). Sur la page **Créer un nouvel environnement**, avant de choisir **Créer un environnement**, choisissez **Configurer plus d'options**.
1. Dans la catégorie de configuration **Monitoring (Surveillance)**, choisissez **Edit (Modifier)**.
1. Dans la section **Rapport sur l'état de santé**, choisissez **Basique** dans le champ **Présentation**.
1. Choisissez **Enregistrer**.
## Activation des rapports d'intégrité améliorée via l'interface de ligne de commande EB
Lorsque vous créez un environnement avec la commande **eb create**, l'interface de ligne de commande EB active les rapports améliorés sur l'état par défaut, et applique le rôle de service et le profil d'instance par défaut.
Vous pouvez spécifier un autre rôle de service par nom en utilisant l'option `--service-role`.
Si votre environnement est exécuté dans une version v2 de la plateforme avec des rapports basiques sur l'état de santé et que vous souhaitez passer aux rapports améliorés sur l'état de santé, procédez comme suit.
**Pour activer les rapports améliorés sur l'état dans un environnement en cours d'exécution via l'[interface de ligne de commande EB](eb-cli3.md)**
1. Utilisez la commande **eb config** pour ouvrir le fichier de configuration dans l'éditeur de texte par défaut.
```
~/project$ eb config
```
1. Recherchez l'espace de noms `aws:elasticbeanstalk:environment` dans la section des paramètres. Assurez-vous que la valeur de `ServiceRole` n'est pas nulle et qu'elle correspond au nom de votre [rôle de service](concepts-roles-service.md).
```
aws:elasticbeanstalk:environment:
EnvironmentType: LoadBalanced
ServiceRole: aws-elasticbeanstalk-service-role
```
1. Sous l'espace de noms `aws:elasticbeanstalk:healthreporting:system:`, remplacez la valeur `SystemType` par **enhanced**.
```
aws:elasticbeanstalk:healthreporting:system:
SystemType: enhanced
```
1. Enregistrez le fichier de configuration et fermez l'éditeur de texte.
1. L'interface de ligne de commande EB lance une mise à jour de l'environnement pour appliquer les modifications apportées à la configuration. Attendez la fin de l'opération ou appuyez sur **Ctrl\$1C** pour quitter l'interface en toute sécurité.
```
~/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.
```
## Activation des rapports d'intégrité améliorées via un fichier de configuration
Vous pouvez activer les rapports améliorés sur l'état en incluant un [fichier de configuration](ebextensions.md) dans votre bundle source. L'exemple suivant présente un fichier de configuration qui active les rapports améliorés sur l'état et affecte le rôle de service et le profil d'instance par défaut à l'environnement :
**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 vous avez créé votre propre rôle de service ou profil d'instance, remplacez le texte en surbrillance par les noms de ces rôles.
# Surveillance améliorée de l'état avec la console de gestion de l'environnement
Lorsque vous activez les rapports de santé améliorés dans AWS Elastic Beanstalk, vous pouvez surveiller l'état de l'environnement dans la [console de gestion de l'environnement](environments-console.md).
**Topics**
+ [Aperçu de l'environnement](#health-enhanced-console-overview)
+ [Page « Health (Santé) » de l'environnement](#health-enhanced-console-healthpage)
+ [Page « Monitoring (Surveillance) »](#health-enhanced-console-monitoringpage)
## Aperçu de l'environnement
La [présentation de l'environnement](environments-dashboard.md) affiche les [statuts d'état](health-enhanced-status.md) de l'environnement et répertorie les événements qui apportent des informations sur l'évolution récente des statuts d'état.
**Pour afficher la présentation de l'environnement**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
Pour plus d'informations sur l'état de santé de l'environnement actuel, ouvrez la page **Santé** en choisissant **Causes**. Sinon, dans le panneau de navigation, sélectionnez **Health (Santé)**.
## Page « Health (Santé) » de l'environnement
La page **Health** affiche l'état de santé, les métriques et les causes de l'environnement et de chaque EC2 instance Amazon de l'environnement.
**Note**
Elastic Beanstalk affiche la page **Health (État)** uniquement si vous avez [activé la surveillance améliorée de l'état](health-enhanced-enable.md) pour l'environnement.
L'image suivante montre la page **Health (Santé)** pour un environnement Linux.
![\[Page Health (Santé) de l'environnement pour un environnement Linux\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-instances.png)
L'image suivante montre la page **Health (Santé)** pour un environnement Windows. Notez que les métriques d'UC sont différentes de celles d'un environnement Linux.
![\[Page relative à l'état de l'environnement pour un environnement Windows.\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-instances-win.png)
En haut de la page, vous pouvez voir le nombre total d'instances d'environnement, ainsi que le nombre d'instances par état. Pour afficher uniquement les instances associées à un état particulier, choisissez **Filter By (Filtrer par)**, puis choisissez un [état](health-enhanced-status.md).
![\[Page d'intégrité de l'environnement affichant le filtre par menu pour choisir l'état d'une instance à afficher\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-instances-status.png)
Pour redémarrer ou suspendre une instance défectueuse, choisissez **Actions d'instance**, puis **Reboot (Redémarrer)** ou **Terminate (Résilier)**.
![\[Page relative à l'état de l'environnement affichant le menu des actions de l'instance permettant de redémarrer ou de mettre fin à des instances défectueuses.\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-instances-actions.png)
Elastic Beanstalk met à jour la page **Health (État)** toutes les 10 secondes. Il fournit des informations sur la santé de l'environnement et de l’instance.
Pour chaque EC2 instance Amazon de l'environnement, la page affiche l'ID et le [statut](health-enhanced-status.md) de l'instance, le temps écoulé depuis le lancement de l'instance, l'identifiant du dernier déploiement exécuté sur l'instance, les réponses et la latence des demandes traitées par l'instance, ainsi que les informations relatives à la charge et à l'utilisation du processeur. La ligne **Overall (Globale)** affiche des informations sur la réponse moyenne et la latence pour l'ensemble de l'environnement.
La page affiche de nombreux détails dans un très grand tableau. Pour masquer certaines colonnes, choisissez ![\[the cog icon.\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/cog.png) (**Preferences (Préférences)**). Sélectionnez ou effacez les noms de colonne, puis choisissez **Confirme (Confirmer)**.
![\[Sélection des colonnes à afficher sur la page d’état de santé de l'environnement\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-console-preferences.png)
Choisissez l’**Instance ID (ID d'instance)** de n'importe quelle instance pour afficher plus d'informations sur cette dernière, y compris sa zone de disponibilité et le type d'instance.
![\[Métriques de serveur sur la page de santé de l'environnement avec les informations d'instance\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-console-instance.png)
Choisissez l’**Deployment ID (ID de déploiement)** d'une instance pour afficher des informations sur le dernier [déploiement](using-features.deploy-existing-version.md) sur l'instance.
![\[Métriques de serveur sur la page de santé de l'environnement avec les informations de déploiement\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-console-deployment.png)
Les informations sur le déploiement incluent les éléments suivants :
+ **ID de déploiement** — Identifiant unique du [déploiement](using-features.deploy-existing-version.md). IDs Le déploiement commence à 1 et augmente d'une unité chaque fois que vous déployez une nouvelle version de l'application ou que vous modifiez les paramètres de configuration qui affectent le logiciel ou le système d'exploitation exécuté sur les instances de votre environnement.
+ **Version** — Libellé de version du code source de l'application utilisé dans le déploiement.
+ **Statut** — Statut du déploiement (`In Progress`, `Deployed` ou `Failed`).
+ **Durée écoulée** — Durée écoulée depuis le début du déploiement (pour les déploiements en cours) ou durée écoulée depuis la fin du déploiement (pour les déploiements terminés).
Si vous [activez l'intégration de X-Ray](environment-configuration-debugging.md) dans votre environnement et que vous instrumentez votre application avec le AWS X-Ray SDK, la page **Health** ajoute des liens vers la AWS X-Ray console dans la ligne de présentation.
![\[Métriques de demandes sur la page Health (Santé) de l'environnement\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-console-xray.png)
Choisissez un lien pour afficher les traces associées aux statistiques mises en évidence dans la AWS X-Ray console.
## Page « Monitoring (Surveillance) »
La page **de surveillance** affiche des statistiques récapitulatives et des graphiques pour les CloudWatch métriques Amazon personnalisées générées par le système de rapports de santé amélioré. Pour savoir comment ajouter des graphiques et des statistiques à cette page, veuillez consulter [Surveillance de l'état de l'environnement dans la console AWS de gestion](environment-health-console.md).
# Couleurs et états utilisés dans les rapports d'intégrité
Les rapports améliorés sur l'état de santé indiquent l'état de santé des instances et de l'environnement global à l'aide de quatre couleurs, comme dans les [rapports basiques sur l'état de santé](using-features.healthstatus.md). Les rapports améliorés sur l'état de santé incluent également sept statuts d'état de santé. Ce sont des termes descriptifs, composés d'un seul mot, qui vous permettent de mieux comprendre l'état de santé de votre environnement.
## État de l'instance et état de l'environnement
Chaque fois qu'Elastic Beanstalk vérifie l'état de votre environnement, les rapports améliorés sur l'état vérifient l'état de chaque instance de votre environnement, en analysant l'ensemble des [données](health-enhanced.md#health-enhanced-factors) disponibles. En cas d'échec de l'une des vérifications de niveau inférieur, Elastic Beanstalk rétrograde l'état de l'instance.
Elastic Beanstalk affiche les informations sur l'état pour l'environnement global (couleur, statut et cause) dans la [console de gestion de l'environnement](environments-console.md). Ces informations sont également disponibles dans l'interface de ligne de commande EB. Le statut d'état de santé et les messages d'explication sont mis à jour toutes les 10 secondes pour chaque instance, et sont disponibles via l'[interface de ligne de commande EB](eb-cli3.md) lorsque vous affichez le statut d'état de santé avec [**eb health**](health-enhanced-ebcli.md).
Elastic Beanstalk tire parti des changements d'état des instances pour évaluer l'état de l'environnement, mais ne change pas immédiatement l'état de santé de l'environnement. Lorsque la vérification de l'état d'une instance échoue au moins trois fois dans un laps de temps d'une minute, Elastic Beanstalk peut rétrograder l'état de l'environnement. En fonction du nombre d'instances de l'environnement et du problème identifié, une instance défaillante peut conduire Elastic Beanstalk à afficher un message d'information ou à changer l'état de santé de l'environnement en le faisant passer de vert (**OK**) à jaune (**Avertissement**) ou rouge (**Dégradé** ou **Grave**).
## OK (vert)
Ce statut s'affiche lorsque :
+ L'instance réussit les vérifications de l'état et l'agent d'état ne signale aucun problème.
+ La plupart des instances de l'environnement réussissent les vérifications de l'état et l'agent d'état ne signale aucun problème majeur.
+ L'instance réussit les vérifications de l'état et traite les demandes normalement.
*Exemple :* votre environnement a été déployé récemment et accepte les demandes normalement. 5 % de demandes renvoient des erreurs de la série 400. Le déploiement s'est terminé normalement sur chaque instance.
*Message (instance) :* Application deployment completed 23 seconds ago and took 26 seconds.
## Avertissement (jaune)
Ce statut s'affiche lorsque :
+ L'agent d'état signale un nombre modéré d'échecs de la demande ou d'autres problèmes pour une instance ou un environnement.
+ Une opération est en cours sur une instance et prend beaucoup de temps.
*Exemple :* une instance de l'environnement a le statut **Grave**.
*Message (environnement) :* Impaired services on 1 out of 5 instances.
## Dégradé (rouge)
Ce statut s'affiche lorsque l'agent d'état signale un nombre élevé d'échecs de la demande ou d'autres problèmes pour une instance ou un environnement.
*Exemple :* l'environnement est en cours de mise à l'échelle ascendante vers 5 instances.
*Message (environnement) :* 4 active instances is below Auto Scaling group minimum size 5.
## Grave (rouge)
Ce statut s'affiche lorsque l'agent d'état signale un nombre très élevé d'échecs de la demande ou d'autres problèmes pour une instance ou un environnement.
*Exemple :* Elastic Beanstalk ne parvient pas à contacter l'équilibreur de charge pour obtenir l'état de l'instance.
*Message (environnement) :* ELB health is failing or not available for all instances. None of the instances are sending data. Impossible d'assumer le rôle « arn:aws:iam : :123456789012:role/ ». aws-elasticbeanstalk-service-role Verify that the role exists and is configured correctly.
*Message (Instances) :* Instance ELB health has not been available for 37 minutes. Pas de données. Last seen 37 minutes ago.
## Info (vert)
Ce statut s'affiche lorsque :
+ Une opération est en cours sur une instance.
+ Une opération est en cours sur plusieurs instances d'un environnement.
*Exemple :* une nouvelle version d'application est en cours de déploiement dans les instances en cours d'exécution.
*Message (environnement) :* Command is executing on 3 out of 5 instances.
*Message (instance) :* Performing application deployment (running for 3 seconds).
## En attente (gris)
Ce statut s'affiche lorsqu'une opération est en cours sur une instance et que le [délai d'attente de la commande](health-enhanced.md#health-enhanced-factors-timeout) n'est pas dépassé.
*Exemple :* vous avez créé l'environnement récemment et des instances sont en cours d'amorçage.
*Message :* Performing initialization (running for 12 seconds).
## Inconnu (gris)
Ce statut s'affiche lorsqu'Elastic Beanstalk et l'agent de vérification de l'état signalent une quantité de données insuffisante sur une instance.
*Exemple :* aucune donnée n'est reçue.
## Suspendu (gris)
Ce statut s'affiche lorsqu'Elastic Beanstalk cesse de surveiller l'état de l'environnement. L'environnement peut ne pas fonctionner correctement. Certaines conditions d'état graves, si elles persistent, conduisent Elastic Beanstalk à faire passer l'environnement au statut **Suspendu**.
*Exemple :* Elastic Beanstalk ne parvient pas à accéder au [rôle de service](iam-servicerole.md) de l'environnement.
*Exemple :* le [groupe Auto Scaling](using-features.managing.as.md) créé par Elastic Beanstalk pour l'environnement a été supprimé.
*Message :* Environment health has transitioned from **OK** to **Severe**. Il n'y a aucune instance. La capacité souhaitée du groupe Auto Scaling est définie sur 1.
# Métriques des instances
Des métriques d'instance fournissent des informations sur l'intégrité d'instances dans votre environnement. L'[agent de vérification de l'état Elastic Beanstalk](health-enhanced.md#health-enhanced-agent) s'exécute sur chaque instance. Il rassemble et transmet à Elastic Beanstalk des métriques relatives aux instances. Elastic Beanstalk analyse ensuite ces métriques pour déterminer l'état des instances dans vos environnements.
L'agent de vérification de l'état Elastic Beanstalk sur instance recueille des métriques sur les instances à partir de serveurs web et du système d'exploitation. Pour obtenir des informations sur les serveurs web sur les plateformes Linux, Elastic Beanstalk lit et analyse les journaux des serveurs web. Sur la plateforme Windows Server, Elastic Beanstalk reçoit directement ces informations du serveur web IIS. Les serveurs web fournissent des informations sur les demandes HTTP entrantes : le nombre de requêtes qui sont entrées, combien ont généré des erreurs et le délai qui a été nécessaire à leur résolution. Le système d'exploitation fournit des informations d'instantané sur l'état des ressources des instances : la charge de l'UC et la distribution du temps consacré à chaque type de processus.
L'agent de vérification de l'état recueille des métriques de système d'exploitation et de serveur web et les transmet à Elastic Beanstalk toutes les 10 secondes. Elastic Beanstalk analyse les données et utilise les résultats pour mettre à jour l'état de santé de chaque instance et de l'environnement.
**Topics**
+ [Métriques de serveur web](#health-enhanced-metrics-server)
+ [Métriques du système d'exploitation](#health-enhanced-metrics-os)
+ [Capture des métriques du serveur web dans IIS sous Windows Server](health-enhanced-metrics-server-iis.md)
## Métriques de serveur web
Sur les plateformes Linux, l'agent de vérification de l'état Elastic Beanstalk lit les métriques de serveur web à partir des journaux générés par le conteneur web ou le serveur qui traite les demandes sur chaque instance de votre environnement. Les plateformes Elastic Beanstalk sont configurées pour générer deux journaux : un au format lisible par l'utilisateur et un au format lisible par la machine. L'agent de vérification de l'état transmet les journaux lisibles par la machine à Elastic Beanstalk toutes les 10 secondes.
Pour plus d'informations sur le format de journal utilisé par Elastic Beanstalk, consultez [Format de journal d'intégrité améliorée](health-enhanced-serverlogs.md).
Sur la plateforme Windows Server, Elastic Beanstalk ajoute un module au pipeline de demandes du serveur web IIS et capture les métriques relatives aux délais des demandes HTTP et aux codes de réponse. Le module envoie ces métriques à l'agent d'état de l'instance à l'aide d'un canal de communication inter-processus (IPC) hautes performances. Pour plus d’informations sur l’implémentation, consultez [Capture des métriques du serveur web dans IIS sous Windows Server](health-enhanced-metrics-server-iis.md).Métriques de serveur web signalées
`RequestCount`
Nombre de requêtes gérées par le serveur web par seconde au cours des 10 dernières secondes. Affiché comme un `r/sec` (demandes par seconde) moyen dans l'interface de ligne de commande EB et sur la [Page « Health (Santé) » de l'environnement](health-enhanced-console.md#health-enhanced-console-healthpage).
`Status2xx``Status3xx``Status4xx``Status5xx`
Nombre de requêtes ayant abouti sur chaque type de code de statut au cours des 10 dernières secondes. Par exemple, les demandes ayant abouti renvoient 200 OK, les redirections renvoient 301 et une erreur 404 est renvoyée si l'URL saisie ne correspond à aucune ressource de l'application.
L'interface de ligne de commande EB et la [Page « Health (Santé) » de l'environnement](health-enhanced-console.md#health-enhanced-console-healthpage) affichent ces métrique sous la forme d'un nombre brut de demandes pour les instances et sous la forme d'un pourcentage des demandes globales pour les environnements.
`p99.9``p99``p95``p90``p85``p75``p50``p10`
Moyenne de latence pour le pourcentage de requêtes *x* le plus lent au cours des 10 dernières secondes, où *x* est la différence entre le nombre et 100. Par exemple, `p99 1.403` indique que les demandes faisant partie des 1 % les plus lents au cours des 10 dernières secondes avaient une latence moyenne de 1 351 secondes.
## Métriques du système d'exploitation
L'agent de vérification de l'état Elastic Beanstalk rapporte les métriques de système d'exploitation suivantes. Elastic Beanstalk utilise ces métriques pour identifier les instances qui subissent une charge lourde constante. Les métriques diffèrent selon le système d'exploitation.Métriques de système d'exploitation signalées (Linux)
`Running`
Le temps qui s'est écoulé depuis le lancement de l'instance.
`Load 1``Load 5`
Charge moyenne au cours des dernières périodes de 1 minute et de 5 minutes. Affiché comme une valeur décimale indiquant le nombre moyen de processus qui s'exécutent pendant cette durée. Si le nombre affiché est supérieur au nombre de v CPUs (threads) disponibles, le reste correspond au nombre moyen de processus en attente.
Par exemple, si votre type d'instance comporte quatre V CPUs et que la charge est de 4,5, il y a eu en moyenne 0,5 processus en attente pendant cette période, soit l'équivalent d'un processus en attente 50 % du temps.
`User %``Nice %``System %``Idle %``I/O Wait %`
Pourcentage de temps que l'UC a consacré à chaque état au cours des 10 dernières secondes.Métriques de système d'exploitation signalées (Windows)
`Running`
Le temps qui s'est écoulé depuis le lancement de l'instance.
`% User Time``% Privileged Time``% Idle Time`
Pourcentage de temps que l'UC a consacré à chaque état au cours des 10 dernières secondes.
# Capture des métriques du serveur web dans IIS sous Windows Server
Sur la plateforme Windows Server, Elastic Beanstalk ajoute un module au pipeline de demandes du serveur web IIS et capture les métriques relatives aux délais des demandes HTTP et aux codes de réponse. Le module envoie ces métriques à l'agent d'état de l'instance à l'aide d'un canal de communication inter-processus (IPC) hautes performances. L'agent de vérification de l'état regroupe ces métriques, les combine avec celles du système d'exploitation et les envoie au service Elastic Beanstalk.
## Détails de l'implémentation
Pour capturer les métriques provenant d'IIS, Elastic Beanstalk implémente une interface [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) gérée et s'abonne aux événements [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) et [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). Cela permet au module de signaler la latence des requêtes HTTP et les codes de réponse pour toutes les requêtes web gérées par IIS. Pour ajouter le module au pipeline de demandes d'IIS, Elastic Beanstalk enregistre le module dans la section [https://docs.microsoft.com/en-us/iis/configuration/system.webserver/modules/](https://docs.microsoft.com/en-us/iis/configuration/system.webserver/modules/) du fichier de configuration IIS `%windir%\System32\inetsrv\config\applicationHost.config`.
Le module Elastic Beanstalk dans IIS envoie les métriques de demandes web capturées à l'agent de vérification de l'état sur instance, qui est un service Windows appelé `HealthD`. Pour envoyer ces données, le module utilise [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), qui fournit une liaison sécurisée et fiable, optimisée pour les communications machine.
# Configuration de règles d'intégrité améliorée pour un environnement
AWS Elastic Beanstalk les rapports de santé améliorés reposent sur un ensemble de règles visant à déterminer la santé de votre environnement. Certaines de ces règles peuvent ne pas être adaptées à votre application. Voici quelques exemples courants :
+ Vous utilisez des outils de test côté client. Dans ce cas, des erreurs fréquentes de client HTTP (4xx) sont attendues.
+ Vous utilisez [AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/) avec Application Load Balancer de votre environnement pour bloquer le trafic entrant indésirable. Dans ce cas, Application Load Balancer renvoie l'erreur HTTP 403 pour chaque message entrant rejeté.
Par défaut, Elastic Beanstalk inclut toutes les erreurs HTTP 4xx de l'application lors de la détermination de l'état de l'environnement. L'état de santé de votre environnement passe de **OK** à **Warning** (Avertissement), **Degraded** (Dégradé) ou **Severe** (Grave), en fonction du taux d'erreur. Pour gérer correctement les cas mentionnés dans les exemples précédents, Elastic Beanstalk vous permet de configurer certaines règles d'état améliorées. Vous pouvez choisir d'ignorer les erreurs HTTP 4xx de l'application sur les instances de l'environnement ou d'ignorer les erreurs HTTP 4xx renvoyées par l'équilibreur de charge de l'environnement. Cette rubrique décrit comment effectuer ces modifications de configuration.
**Note**
Actuellement, il s'agit de la seule personnalisation de règle d'intégrité améliorée disponible. Vous ne pouvez pas configurer l'intégrité améliorée pour ignorer d'autres erreurs HTTP en plus de 4xx.
## Configuration des règles d'état améliorées à l'aide de la console Elastic Beanstalk
Vous pouvez utiliser la console Elastic Beanstalk pour configurer les règles d'état améliorées dans votre environnement.
**Pour configurer la vérification des codes d'état HTTP 4xx à l'aide de la console Elastic Beanstalk**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Dans le panneau de navigation, choisissez **Configuration**.
1. Dans la catégorie de configuration **Monitoring (Surveillance)**, choisissez **Edit (Modifier)**.
1. Sous **Personnalisation de la règle de surveillance de l'intégrité**, activez ou désactivez les options **Ignorer** souhaitées.
![\[Section de personnalisation de la règle de surveillance de l'état sur la page de configuration de la surveillance de la console Elastic Beanstalk\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/enhanced-health-rule-customization.png)
1. Pour enregistrer les modifications, cliquez sur **Appliquer** en bas de la page.
## Configuration des règles d'intégrité améliorée à l'aide de l'interface de ligne de commande EB
Vous pouvez utiliser l'interface de ligne de commande EB pour configurer les règles d'état améliorées en enregistrant la configuration de votre environnement en local, en ajoutant une entrée qui configure les règles d'état améliorées, puis en chargeant la configuration dans Elastic Beanstalk. Vous pouvez appliquer la configuration enregistrée à un environnement pendant ou après la création.
**Pour configurer la vérification du code d'état HTTP 4xx à l'aide de l'interface de ligne de commande EB et des configurations enregistrées**
1. Initialisez votre dossier de projet avec [**eb init**](eb-cli3-configuration.md).
1. Créez un environnement en exécutant la commande **eb create**.
1. Enregistrez un modèle de configuration localement en exécutant la commande **eb config save**. L'exemple suivant utilise l'option `--cfg` pour spécifier le nom de la configuration.
```
$ eb config save --cfg 01-base-state
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml
```
1. Ouvrez le fichier de configuration enregistrée dans un éditeur de texte.
1. Sous `OptionSettings` > `aws:elasticbeanstalk:healthreporting:system:`, ajoutez une clé `ConfigDocument` pour lister chaque règle d'intégrité améliorée à configurer. Le `ConfigDocument` suivant désactive la vérification des codes d'état HTTP 4xx de l'application, tout en conservant la vérification du code HTTP 4xx de l'équilibreur de charge activé.
```
OptionSettings:
...
aws:elasticbeanstalk:healthreporting:system:
ConfigDocument:
Rules:
Environment:
Application:
ApplicationRequests4xx:
Enabled: false
ELB:
ELBRequests4xx:
Enabled: true
Version: 1
SystemType: enhanced
...
```
**Note**
Vous pouvez combiner `Rules` et `CloudWatchMetrics` dans le même paramètre d'option `ConfigDocument`. Le paramètre `CloudWatchMetrics` est décrit dans [Publication de métriques CloudWatch personnalisées Amazon pour un environnement](health-enhanced-cloudwatch.md).
Si vous avez précédemment activé `CloudWatchMetrics`, le fichier de configuration que vous récupérez à l'aide de la commande **eb config save** possède déjà une clé `ConfigDocument` avec une section `CloudWatchMetrics`. *Ne la supprimez pas* : ajoutez une section `Rules` dans la même valeur d'option `ConfigDocument`.
1. Enregistrez le fichier de configuration et fermez l'éditeur de texte. Dans cet exemple, le fichier de configuration mis à jour est enregistré avec un nom qui est différent (`02-cloudwatch-enabled.cfg.yml`) de celui du fichier de configuration téléchargé. Cela crée une configuration enregistrée distincte lorsque le fichier est téléchargé. Vous pouvez utiliser le même nom que le fichier téléchargé pour remplacer la configuration existante sans en créer une.
1. Utilisez la commande **eb config put** pour charger le fichier de configuration mis à jour dans Elastic Beanstalk.
```
$ eb config put 02-cloudwatch-enabled
```
Lorsque vous utilisez les commandes **eb config** `get` et `put` avec des configurations enregistrés, n'incluez pas l'extension de nom de fichier.
1. Appliquez la configuration enregistrée à votre environnement en cours d'exécution.
```
$ eb config --cfg 02-cloudwatch-enabled
```
L'option `--cfg` spécifie un fichier de configuration nommé qui est appliqué à l'environnement. Vous pouvez enregistrer le fichier de configuration en local ou dans Elastic Beanstalk. Si un fichier de configuration avec le nom spécifié existe dans les deux emplacements, l'interface de ligne de commande EB utilise le fichier local.
## Configuration des règles d'intégrité améliorée à l'aide d'un document de configuration
Le document de configuration pour les règles d'intégrité améliorée est un document JSON qui répertorie les règles à configurer.
L'exemple suivant montre un document de configuration qui désactive la vérification des codes d'état HTTP 4xx de l'application et active la vérification des codes d'état HTTP 4xx de l'équilibreur de charge.
```
{
"Rules": {
"Environment": {
"Application": {
"ApplicationRequests4xx": {
"Enabled": false
}
},
"ELB": {
"ELBRequests4xx": {
"Enabled": true
}
}
}
},
"Version": 1
}
```
Pour le AWS CLI, vous transmettez le document en tant que valeur de `Value` clé dans un argument de paramètres d'option, qui est lui-même un objet JSON. Dans ce cas, vous devez utiliser des guillemets d'échappement dans le document intégré. La commande suivante vérifie si les paramètres de configuration sont valides.
```
$ 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 }"
}
]'
```
Pour un fichier de configuration `.ebextensions` au format YAML, vous pouvez fournir le document JSON en l'état.
```
option_settings:
- namespace: aws:elasticbeanstalk:healthreporting:system
option_name: ConfigDocument
value: {
"Rules": {
"Environment": {
"Application": {
"ApplicationRequests4xx": {
"Enabled": false
}
},
"ELB": {
"ELBRequests4xx": {
"Enabled": true
}
}
}
},
"Version": 1
}
```
# Publication de métriques CloudWatch personnalisées Amazon pour un environnement
Vous pouvez publier les données recueillies par le biais de rapports de santé AWS Elastic Beanstalk améliorés sur Amazon CloudWatch sous forme de statistiques personnalisées. La publication de métriques vous CloudWatch permet de surveiller l'évolution des performances des applications au fil du temps et d'identifier les problèmes potentiels en suivant l'évolution de l'utilisation des ressources et de la latence des demandes en fonction de la charge.
En publiant des métriques sur CloudWatch, vous les rendez également disponibles pour une utilisation avec [des graphiques de surveillance et des](environment-health-console.md#environment-health-console-graphs) [alarmes](using-features.alarms.md). Une métrique gratuite est automatiquement activée lorsque vous utilisez des rapports de santé améliorés. *EnvironmentHealth* Mesures personnalisées autres que celles liées *EnvironmentHealth*aux [CloudWatch frais](https://aws.amazon.com/cloudwatch/pricing/) standard.
Pour publier des métriques CloudWatch personnalisées pour un environnement, vous devez d'abord activer les rapports de santé améliorés sur l'environnement. Pour obtenir des instructions, consultez [Activation des rapports améliorés sur l'état Elastic Beanstalk](health-enhanced-enable.md).
**Topics**
+ [Métriques de création de rapports d'intégrité améliorés](#health-enhanced-cloudwatch-metrics)
+ [Configuration des CloudWatch métriques à l'aide de la console Elastic Beanstalk](#health-enhanced-cloudwatch-console)
+ [Configuration de métriques CloudWatch personnalisées à l'aide de l'interface de ligne de commande EB](#health-enhanced-cloudwatch-ebcli)
+ [Fourniture des documents de configuration des métriques personnalisées](#health-enhanced-cloudwatch-configdocument)
## Métriques de création de rapports d'intégrité améliorés
Lorsque vous activez les rapports de santé améliorés dans votre environnement, le système de rapports de santé améliorés publie automatiquement une [métrique CloudWatch personnalisée](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/publishingMetrics.html), *EnvironmentHealth*. [Pour publier des métriques supplémentaires CloudWatch, configurez votre environnement avec ces métriques à l'aide de la [console [Elastic Beanstalk](#health-enhanced-cloudwatch-console),](#health-enhanced-cloudwatch-ebcli) de l'EB CLI ou de .ebextensions.](command-options.md)
Vous pouvez publier les indicateurs de santé améliorés suivants depuis votre environnement vers CloudWatch.Métriques disponibles (toutes les plateformes)
`EnvironmentHealth`
*Environnement uniquement. * Il s'agit de la seule CloudWatch métrique publiée par le système de rapports de santé améliorés, sauf si vous configurez des métriques supplémentaires. L'état de l'environnement est représentée par un des sept [statuts](health-enhanced-status.md). Dans la CloudWatch console, ces statuts correspondent aux valeurs suivantes :
+ 0 – OK
+ 1 – Info
+ 5 – Inconnu
+ 10 – Pas de données
+ 15 – Avertissement
+ 20 – Dégradé
+ 25 – Grave
`InstancesSevere``InstancesDegraded``InstancesWarning``InstancesInfo``InstancesOk``InstancesPending``InstancesUnknown``InstancesNoData`
*Environnement uniquement. * Ces métriques indiquent le nombre d'instances dans les environnement avec chaque état de santé. `InstancesNoData` indique le nombre d'instances pour lesquelles aucune donnée ne sera reçue.
`ApplicationRequestsTotal``ApplicationRequests5xx``ApplicationRequests4xx``ApplicationRequests3xx``ApplicationRequests2xx`
*Instance et environnement. * Indique le nombre total de requêtes terminées par l'instance ou l'environnement et le nombre de requêtes ayant abouti avec chaque catégorie de code d'état.
`ApplicationLatencyP10``ApplicationLatencyP50``ApplicationLatencyP75``ApplicationLatencyP85``ApplicationLatencyP90``ApplicationLatencyP95``ApplicationLatencyP99``ApplicationLatencyP99.9`
*Instance et environnement. * Indique la quantité moyenne de temps, en secondes, nécessaire pour terminer le pourcentage *x* le plus rapide de requêtes.
`InstanceHealth`
*Instance uniquement.* Indique l'état d'intégrité actuel de l'instance. L'état d'instance est représentée par un statut (sur sept [statuts](health-enhanced-status.md) au total). Dans la CloudWatch console, ces statuts correspondent aux valeurs suivantes :
+ 0 – OK
+ 1 – Info
+ 5 – Inconnu
+ 10 – Pas de données
+ 15 – Avertissement
+ 20 – Dégradé
+ 25 – GraveMétriques disponibles (Linux)
`CPUIrq``CPUIdle``CPUUser``CPUSystem``CPUSoftirq``CPUIowait``CPUNice`
*Instance uniquement.* Indique le pourcentage de temps que l'UC a passé dans chaque état au cours de la dernière minute.
`LoadAverage1min`
*Instance uniquement.* La charge d'UC moyenne de l'instance au cours de la dernière minute.
`RootFilesystemUtil`
*Instance uniquement.* Indique le pourcentage d'espace disque en cours d'utilisation.Métriques disponibles (Windows)
`CPUIdle``CPUUser``CPUPrivileged`
Instance uniquement. Indique le pourcentage de temps que l'UC a passé dans chaque état au cours de la dernière minute.
## Configuration des CloudWatch métriques à l'aide de la console Elastic Beanstalk
Vous pouvez utiliser la console Elastic Beanstalk pour configurer votre environnement afin de publier des CloudWatch indicateurs de santé améliorés et de les rendre disponibles pour une utilisation avec des graphiques de surveillance et des alarmes.
**Pour configurer CloudWatch des métriques personnalisées dans la console Elastic Beanstalk**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Dans le panneau de navigation, choisissez **Configuration**.
1. Dans la catégorie de configuration **Monitoring (Surveillance)**, choisissez **Edit (Modifier)**.
1. Sous **Rapport sur l'état de santé**, sélectionnez les métriques d'instance et d'environnement que vous voulez publier dans CloudWatch. Pour sélectionner plusieurs métriques, appuyez sur la touche **Ctrl** tout en choisissant.
1. Pour enregistrer les modifications, cliquez sur **Appliquer** en bas de la page.
L'activation des métriques CloudWatch personnalisées les ajoute à la liste des métriques disponibles sur la [page **Monitoring**](environment-health-console.md).
## Configuration de métriques CloudWatch personnalisées à l'aide de l'interface de ligne de commande EB
Vous pouvez utiliser l'interface de ligne de commande EB pour configurer des métriques personnalisées en enregistrant la configuration de votre environnement en local, en ajoutant une entrée qui définit les métriques à publier, puis en chargeant la configuration dans Elastic Beanstalk. Vous pouvez appliquer la configuration enregistrée à un environnement pendant ou après la création.
**Pour configurer des métriques CloudWatch personnalisées à l'aide de l'interface de ligne de commande EB et des configurations enregistrées**
1. Initialisez votre dossier de projet avec [**eb init**](eb-cli3-configuration.md).
1. Créez un environnement en exécutant la commande **eb create**.
1. Enregistrez un modèle de configuration localement en exécutant la commande **eb config save**. L'exemple suivant utilise l'option `--cfg` pour spécifier le nom de la configuration.
```
$ eb config save --cfg 01-base-state
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml
```
1. Ouvrez le fichier de configuration enregistrée dans un éditeur de texte.
1. Sous `OptionSettings` >`aws:elasticbeanstalk:healthreporting:system:`, ajoutez une `ConfigDocument` clé pour activer chacune des CloudWatch mesures souhaitées. Par exemple, le `ConfigDocument` suivant publie des métriques `ApplicationRequests5xx` et `ApplicationRequests4xx` au niveau de l'environnement et des métriques `ApplicationRequestsTotal` au niveau de l'instance.
```
OptionSettings:
...
aws:elasticbeanstalk:healthreporting:system:
ConfigDocument:
CloudWatchMetrics:
Environment:
ApplicationRequests5xx: 60
ApplicationRequests4xx: 60
Instance:
ApplicationRequestsTotal: 60
Version: 1
SystemType: enhanced
...
```
Dans l'exemple, 60 indique le nombre de secondes entre les mesures. C'est la seule valeur actuellement prise en charge.
**Note**
Vous pouvez combiner `CloudWatchMetrics` et `Rules` dans le même paramètre d'option `ConfigDocument`. Le paramètre `Rules` est décrit dans [Configuration de règles d'intégrité améliorée pour un environnement](health-enhanced-rules.md).
Si vous avez précédemment utilisé `Rules` pour configurer les règles d'intégrité améliorée, le fichier de configuration que vous récupérez à l'aide de la commande **eb config save** possède déjà une clé `ConfigDocument` avec une section `Rules`. *Ne la supprimez pas* : ajoutez une section `CloudWatchMetrics` dans la même valeur d'option `ConfigDocument`.
1. Enregistrez le fichier de configuration et fermez l'éditeur de texte. Dans cet exemple, le fichier de configuration mis à jour est enregistré avec un nom qui est différent (`02-cloudwatch-enabled.cfg.yml`) de celui du fichier de configuration téléchargé. Cela crée une configuration enregistrée distincte lorsque le fichier est téléchargé. Vous pouvez utiliser le même nom que le fichier téléchargé pour remplacer la configuration existante sans en créer une.
1. Utilisez la commande **eb config put** pour charger le fichier de configuration mis à jour dans Elastic Beanstalk.
```
$ eb config put 02-cloudwatch-enabled
```
Lorsque vous utilisez les commandes **eb config** `get` et `put` avec des configurations enregistrées, n'incluez pas l'extension de fichier.
1. Appliquez la configuration enregistrée à votre environnement en cours d'exécution.
```
$ eb config --cfg 02-cloudwatch-enabled
```
L'option `--cfg` spécifie un fichier de configuration nommé qui est appliqué à l'environnement. Vous pouvez enregistrer le fichier de configuration en local ou dans Elastic Beanstalk. Si un fichier de configuration avec le nom spécifié existe dans les deux emplacements, l'interface de ligne de commande EB utilise le fichier local.
## Fourniture des documents de configuration des métriques personnalisées
Le document de configuration (config) pour les métriques CloudWatch personnalisées Amazon est un document JSON qui répertorie les métriques à publier au niveau de l'environnement et de l'instance. L'exemple suivant illustre un document de configuration qui active toutes les métriques personnalisées disponibles.
```
{
"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
}
```
Pour le AWS CLI, vous transmettez le document en tant que valeur de `Value` clé dans un argument de paramètres d'option, qui est lui-même un objet JSON. Dans ce cas, vous devez utiliser des guillemets d'échappement dans le document intégré.
```
$ 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}"
}
]'
```
Pour un fichier de configuration `.ebextensions` au format YAML, vous pouvez fournir le document JSON en l'état.
```
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
}
```
# Utilisation des rapports améliorés sur l'état à l'aide de l'API Elastic Beanstalk
É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
**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).
# Format de journal d'intégrité améliorée
AWS Elastic Beanstalk les plateformes utilisent un format de journal de serveur Web personnalisé pour transmettre efficacement les informations relatives aux requêtes HTTP au système amélioré de rapports de santé. Le système analyse les journaux, identifie les problèmes et définit en conséquence l'état de santé de l'instance et de l'environnement. Si vous désactivez le proxy de serveur web dans votre environnement et que vous traitez les demandes directement depuis le conteneur web, vous pouvez toujours utiliser pleinement les rapports améliorés sur l'état en configurant votre serveur de sorte à générer des journaux à l'emplacement et au format utilisés par l'[agent de vérification de l'état Elastic Beanstalk](health-enhanced.md#health-enhanced-agent).
**Note**
Les informations de cette page concernent uniquement les plateformes Linux. Sur la plateforme Windows Server, Elastic Beanstalk reçoit les informations sur les demandes HTTP directement à partir du serveur web IIS. Pour en savoir plus, consultez [Capture des métriques du serveur web dans IIS sous Windows Server](health-enhanced-metrics-server-iis.md).
## Configuration de journal de serveur web
Les plateformes Elastic Beanstalk sont configurées de sorte à générer deux journaux contenant des informations sur les demandes HTTP. La première est au format détaillé et fournit des informations complètes sur la demande, y compris les informations de l'agent utilisateur du demandeur et un horodatage contrôlable de visu.
**/var/log/nginx/access.journal**
L'exemple suivant provient d'un proxy nginx exécuté dans un environnement de serveur web Ruby, mais le format est similaire pour 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"
```
Le deuxième journal est au format court. Il comporte des informations pertinentes uniquement pour la création de rapports d'intégrité améliorée. Ce journal est sorti vers un sous-dossier nommé `healthd` et tourne chaque heure. Les anciens journaux sont supprimés immédiatement après la rotation.
**/var/log/nginx/healthd/application.log.2015-07-23-00**
L'exemple suivant montre un journal au format lisible par la machine.
```
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
```
Le format des journaux d'intégrité améliorée inclut les informations suivantes :
+ Le moment de la demande, en heure Unix
+ Le chemin d'accès de la demande
+ Le code de statut HTTP pour le résultat
+ La durée des demandes
+ Le temps en amont
+ L'en-tête HTTP `X-Forwarded-For`
Pour les proxys nginx, les heures sont indiquées en secondes à virgule flottante, avec trois décimales. Pour Apache, les millisecondes entières sont utilisées.
**Note**
Si un avertissement similaire au suivant s'affiche dans un fichier journal, où `DATE-TIME` correspond à une date et une heure, et que vous utilisez un proxy personnalisé, comme dans un environnement Docker multi-conteneurs, vous devez utiliser un fichier .ebextension pour configurer votre environnement afin que `healthd` puisse lire vos fichiers journaux :
```
W, [DATE-TIME #1922] WARN -- : log file "/var/log/nginx/healthd/application.log.DATE-TIME" does not exist
```
Vous pouvez commencer par le fichier .ebextension dans l'[exemple Docker multi-conteneurs](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/docker-multicontainer-v2.zip).
**/etc/nginx/conf.d/webapp\$1healthd.conf**
L'exemple suivant montre la configuration de journal pour nginx avec le format de journal `healthd` mis en évidence.
```
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**
L'exemple suivant montre la configuration des journaux pour 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
```
## Génération de journaux pour la création de rapports d'intégrité améliorée
Pour fournir des journaux à l'agent d'intégrité, vous devez procéder comme suit :
+ Sortir des journaux dans le bon format, comme illustré dans la section précédente
+ Sortir des journaux dans `/var/log/nginx/healthd/`
+ Nommer des journaux à l'aide du format suivant : `application.log.$year-$month-$day-$hour`
+ Effectuer une rotation des journaux une fois par heure
+ Ne pas tronquer de journaux
# Notifications et dépannage
**Essayez Amazon Q Developer CLI pour un dépannage assisté par l'IA**
La CLI Amazon Q Developer peut vous aider à résoudre rapidement les problèmes d'environnement. La Q CLI fournit des solutions en vérifiant l'état de l'environnement, en examinant les événements, en analysant les journaux et en posant des questions de clarification. Pour plus d'informations et des instructions détaillées, consultez la section [Résolution des problèmes liés aux environnements Elastic Beanstalk avec Amazon](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/) Q Developer CLI dans les blogs. AWS
Cette page répertorie les messages relatifs aux problèmes courants ainsi que des liens vers des informations supplémentaires. Les messages apparaissent dans [Volet de présentation de l'environnement](environments-dashboard-envoverview.md) la console Elastic Beanstalk et sont [enregistrés](using-features.events.md) lors d'événements où des problèmes de santé persistent après plusieurs vérifications.
## Déploiements
Elastic Beanstalk surveille la cohérence de votre environnement à la suite de déploiements. En cas de défaillance d'un déploiement propagé, la version de votre application s'exécutant sur les instances de votre environnement peut varier. Cela peut se produire si un déploiement réussit sur un ou plusieurs lots mais échoue avant que tous les lots aient abouti.
*Une version d'application incorrecte a été détectée sur 2 instances sur 5. Version attendue « v1 » (déploiement 1).*
*Version d'application incorrecte sur les instances de l'environnement. Version attendue « v1 » (déploiement 1).*
La version d'application attendue ne s'exécute pas sur tout ou partie des instances dans un environnement.
*Version d'application « v2 » incorrecte (déploiement 2). Version attendue « v1 » (déploiement 1).*
L'application déployée sur une instance diffère de la version attendue. En cas de défaillance d'un déploiement, la version attendue revient à la version du dernier déploiement ayant abouti. Dans l'exemple ci-dessus, le premier déploiement (version « v1 ») a abouti, mais le deuxième déploiement (version « v2 ») a échoué. Toutes les instances exécutant « v2 » sont considérées comme défectueuses.
Pour résoudre ce problème, démarrez un autre déploiement. Vous pouvez [redéployer une version précédente](using-features.deploy-existing-version.md) dont vous savez qu'elle fonctionne, ou configurer votre environnement pour [ignorer les vérifications de l'état](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console) au cours du déploiement et redéployer la nouvelle version pour forcer le déploiement à aboutir.
Vous pouvez également identifier et résilier les instances qui exécutent la mauvaise version d'application. Elastic Beanstalk lance des instances avec la version appropriée pour remplacer toutes les instances que vous résiliez. Utilisez la [commande d'état de l'interface de ligne de commande EB](health-enhanced-ebcli.md) pour identifier les instances qui exécutent la mauvaise version d'application.
## Serveur d'application
*15 % des demandes signalent une erreur avec HTTP 4xx*
*20 % des demandes à ELB signalent une erreur avec HTTP 4xx.*
Un pourcentage élevé de demandes HTTP à une instance ou un environnement échouent avec des erreurs 4xx.
Un code de statut de série 400 indique que l'utilisateur a soumis une demande erronée, telle que la demande d'une page qui n'existe pas (404 : Fichier introuvable) ou à laquelle l'utilisateur n'a pas accès à (403 Interdit). Un petit nombre d'erreurs 404 n'est pas rare, mais un grand nombre pourrait signifier qu'il y a des liens internes ou externes vers des pages indisponibles. Ces problèmes peuvent être résolus en réparant des liens internes erronés et en ajoutant des redirections pour des liens externes erronés.
*5 % des demandes échouent avec HTTP 5xx*
*3 % des demandes à ELB échouent avec HTTP 5xx.*
Un pourcentage élevé de demandes HTTP à une instance ou un environnement échoue avec les codes de statut de série 500.
Un code de statut de série 500 indique que le serveur d'applications a rencontré une erreur interne. Ces problèmes indiquent qu'il y a une erreur dans le code de votre application et ils doivent être identifiés et corrigés rapidement.
*95 % de l'UC est en cours d'utilisation*
Sur une instance, l'agent d'état rapporte un pourcentage extrêmement élevé d'utilisation de l'UC et définit l'état de l'instance sur **Avertissement** ou **Dégradé**.
Mettez à l'échelle votre environnement pour réduire la charge des instances.
## Instance de travail
*20 messages en attente dans la file d'attente (il y a 25 secondes)*
Des demandes sont ajoutées à la file d'attente de votre environnement de travail plus vite qu'elles ne peuvent être traitées. Mettez à l'échelle votre environnement pour accroître la capacité.
*5 messages dans la file d'attente de lettres mortes (il y a 15 secondes)*
Des demandes de travail échouent régulièrement et sont ajoutées à la [Files d’attente de lettres mortes](using-features-managing-env-tiers.md#worker-deadletter). Vérifiez les demandes dans la file d'attente de lettres mortes pour voir pourquoi elles échouent.
## Autres ressources
*4 instances actives est inférieur à la taille minimale 5 du groupe Auto Scaling*
Le nombre d'instances s'exécutant dans votre environnement est inférieur au nombre minimal configuré pour le groupe Auto Scaling.
*Des notifications du groupe Auto Scaling (nom du groupe) ont été supprimées ou modifiées*
Les notifications configurées pour votre groupe Auto Scaling ont été modifiées en dehors d'Elastic Beanstalk.
# Analyse de l'environnement basée sur l'IA
AWS Elastic Beanstalk L'analyse basée sur l'IA identifie les causes profondes et recommande des solutions aux problèmes de santé liés à l'environnement. Lorsque votre environnement rencontre des problèmes, vous pouvez demander une analyse de l'IA à l'aide des opérations d'`RetrieveEnvironmentInfo`API `RequestEnvironmentInfo` et de type `analyze` info pour obtenir des informations générées par l'IA et des solutions recommandées.
**Note**
L'analyse par IA n'est disponible que sur les versions compatibles d'Amazon Linux 2 et de la AL2023 plateforme publiées le 16 février 2026 ou après cette date.
## Comment ça marche
Lorsque vous demandez une analyse basée sur l'IA, Elastic Beanstalk exécute un script sur une instance de votre environnement qui collecte les événements récents, l'état de santé de l'instance et les journaux (jusqu'[à](https://docs.aws.amazon.com/bedrock/latest/userguide/key-definitions.html) 170 000 jetons de données). Il envoie ensuite ces données à Amazon Bedrock dans votre compte et renvoie des informations et des recommandations sur les prochaines étapes.
## Conditions préalables
Avant d'utiliser l'analyse par IA, vérifiez que votre environnement répond aux exigences suivantes :
+ Environnement exécutant une [version de plate-forme prise en charge](#health-ai-analysis-supported-platforms)
+ [Profil d'instance](iam-instanceprofile.md) avec les autorisations requises (voir [Autorisations requises](#health-ai-analysis-permissions) ci-dessous)
+ **Détails des cas d'utilisation anthropiques** — L'analyse de l'IA utilise les modèles Anthropic Claude via Amazon Bedrock. Anthropic vous demande de soumettre un formulaire détaillé de cas d'utilisation unique avant de pouvoir invoquer ses modèles. Pour soumettre ce formulaire, sélectionnez n'importe quel modèle Anthropic dans le catalogue de modèles de la [console Amazon Bedrock](https://console.aws.amazon.com/bedrock/) ou appelez l'[https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html)API. Vous ne devez effectuer cette opération qu'une seule fois par AWS compte. Si vous soumettez le formulaire depuis le compte de gestion des AWS Organizations, il couvre automatiquement tous les comptes membres de l'organisation. Pour plus d'informations, consultez [Access Amazon Bedrock foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html).
+ **GovCloud régions** — Si vous utilisez des régions AWS GovCloud (États-Unis), vous devez autoriser l'accès au dernier modèle Anthropic Claude Sonnet and/or Opus dans Amazon Bedrock avant d'utiliser l'analyse par IA. Pour obtenir des instructions sur l'activation de l'accès aux modèles dans GovCloud les régions, consultez [Gérer l'accès aux modèles Amazon Bedrock Foundation](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-govcloud). Pour plus d'informations sur le dernier modèle Anthropic Claude Sonnet and/or Opus disponible, voir [Régions et modèles pris en charge pour les profils d'inférence](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html).
## Autorisations requises
Pour utiliser l'analyse par IA, le profil d'instance Amazon EC2 de votre environnement doit être autorisé à invoquer Amazon Bedrock. Ajoutez les autorisations suivantes à votre profil d'instance :
+ `bedrock:InvokeModel`
+ `bedrock:ListFoundationModels`
+ `elasticbeanstalk:DescribeEvents`
+ `elasticbeanstalk:DescribeEnvironmentHealth`
Pour plus d'informations sur la configuration des profils d'instance, consultez[Gestion des profils d'instance Elastic Beanstalk](iam-instanceprofile.md).
## Utilisation de l'analyse de l'IA dans la console
**À partir de l'aperçu de l'environnement**
Lorsque l'état de santé de votre environnement est **Avertissement**, **Dégradé ou Sévère**, **un** bouton d'**analyse de l'IA** apparaît dans la section de présentation de l'environnement. Cliquez sur ce bouton pour lancer une analyse IA de votre environnement.
**Depuis la page Logs**
Vous pouvez également accéder à l'analyse de l'IA depuis la page **Logs** du volet de navigation. Cliquez sur le bouton **Analyse de l'IA** pour demander une analyse basée sur l'IA de l'état actuel de votre environnement.
## Utilisation de l'analyse basée sur l'IA avec AWS CLI
Vous pouvez utiliser l'API Elastic Beanstalk via le pour demander et récupérer des analyses d'IA AWS CLI par programmation.
**Demander une analyse de l'IA**
Utilisez l'[https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html)opération avec le `InfoType` paramètre défini sur`analyze`.
**Example AWS CLI - Demander une analyse de l'IA**
```
aws elasticbeanstalk request-environment-info \
--environment-name my-env \
--info-type analyze \
--region us-east-1
```
**Récupérez une analyse d'IA**
Utilisez l'[https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html)opération avec le `InfoType` paramètre défini sur `analyze` pour récupérer les résultats de l'analyse.
**Example AWS CLI - Récupérez l'analyse de l'IA**
```
aws elasticbeanstalk retrieve-environment-info \
--environment-name my-env \
--info-type analyze \
--region us-east-1
```
La réponse inclut une analyse de l'état actuel de l'environnement générée par l'IA, ainsi que des solutions recommandées pour tout problème identifié.
## Utilisation de l'analyse de l'IA avec l'EB CLI
Si vous utilisez l'EB CLI, vous pouvez demander une analyse de l'IA avec l'option `--analyze` (`-ai`) de la **eb logs** commande. La commande demande l'analyse, attend qu'elle soit terminée et affiche les résultats.
**Example EB CLI - Demander une analyse de l'IA**
```
$ eb logs --analyze
```
L'`--analyze`option n'est pas compatible avec `--instance``--all`,`--zip`, ou`--log-group`. Pour la référence complète des commandes, voir[**eb logs**](eb3-logs.md).
**Note**
L'`--analyze`option nécessite la version 3.27 ou ultérieure de l'EB CLI.
## Considérations importantes
+ **Tarification** — L'analyse basée sur l'IA utilise Amazon Bedrock pour traiter les données de votre environnement, et la tarification standard d'Amazon Bedrock s'applique aux appels de modèles. Pour plus de détails sur la tarification, consultez [Tarification Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
+ **Configuration requise** : l'analyse de l'IA n'est disponible que sur Amazon Linux 2 et sur les versions AL2023 basées sur la plateforme publiées le 16 février 2026 ou après cette date. Pour utiliser cette fonctionnalité, mettez à jour votre environnement vers une version de plate-forme prise en charge. Pour de plus amples informations, veuillez consulter [Mise à jour de la version de la plateforme de votre environnement Elastic Beanstalk](using-features.platform.upgrade.md).
+ **Autorisations** — Avant d'utiliser l'analyse par IA, assurez-vous que votre profil d'instance dispose des autorisations Amazon Bedrock (`bedrock:InvokeModel`et`bedrock:ListFoundationModels`) et des autorisations Elastic `elasticbeanstalk:DescribeEvents` Beanstalk (et) requises. `elasticbeanstalk:DescribeEnvironmentHealth`
+ **Confidentialité des données** — L'analyse envoie les événements environnementaux et les journaux à Amazon Bedrock dans votre compte pour traitement. Pour plus d'informations sur la manière dont Amazon Bedrock gère vos données, consultez [Amazon Bedrock Security and](https://aws.amazon.com/bedrock/security-compliance/) Compliance.
+ **Quotas de service** — L'analyse par IA utilise un modèle Anthropic Claude dans Amazon Bedrock, qui a des quotas par défaut pour les demandes par minute et les jetons par minute. Si vous rencontrez des erreurs de régulation, vous pouvez demander une augmentation du quota. Pour plus d’informations, consultez [Demande d’augmentation de quota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).
## Versions de plateforme prises en charge
L'analyse par IA est prise en charge sur Amazon Linux 2 et AL2023 sur les versions basées sur la plateforme publiées le [16 février 2026](RELEASE_NOTES_URL) ou après cette date. Pour vérifier la version de votre plateforme, consultez les notes de mise à jour d'[Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/welcome.html).