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.
# Dépannage et diagnostic
**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 section fournit des conseils pour résoudre les problèmes courants susceptibles de survenir lors de la migration des applications IIS vers Elastic Beanstalk.
## Associer une EC2 paire de clés à votre environnement
Vous pouvez vous connecter en toute sécurité aux instances Amazon Elastic Compute Cloud (Amazon EC2) mises en service pour votre application Elastic Beanstalk à l'aide d'une paire de clés Amazon. EC2 Pour obtenir des instructions sur la création d'une paire de clés, consultez la section [Création d'une paire de clés à l'aide d'Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair) dans le *guide de EC2 l'utilisateur Amazon*.
La spécification d'un nom de clé **eb migrate** a pour effet d'associer votre environnement Elastic Beanstalk à la paire de clés. Pour des raisons de sécurité, cela n'ouvrira pas le port 3389 sur le groupe de sécurité de votre EC2 instance. Vous pouvez associer des groupes EC2 de sécurité supplémentaires autorisant le trafic du port 3389 à passer **eb config** après la migration initiale.
```
PS C:\migrations_workspace> eb migrate `
--keyname "my-keypair" `
--verbose
```
Lorsque vous créez une paire de clés, Amazon EC2 stocke une copie de votre clé publique. Si vous n'avez plus besoin de l'utiliser pour vous connecter à des instances d'environnement, vous pouvez le supprimer d'Amazon EC2. Pour plus de détails, consultez [Supprimer votre paire de clés](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair) dans le *guide de EC2 l'utilisateur Amazon*.
Pour plus d'informations sur la connexion aux EC2 instances Windows Amazon, consultez [Connexion à une instance Windows](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html).
## Accès aux journaux
L'EB CLI fournit une **eb logs** fonctionnalité que vous pouvez utiliser pour récupérer les journaux d'un environnement Elastic Beanstalk sans vous connecter à ses instances. EC2 Après l'exécution de**eb migrate**, vous pouvez lancer la **eb logs --zip** commande qui téléchargera et enregistrera les journaux dans le `.elasticbeanstalk\logs` répertoire.
Vous pouvez également consulter les journaux via la console AWS Elastic Beanstalk. Pour de plus amples informations, veuillez consulter [Affichage des journaux des instances Amazon EC2 dans votre environnement Elastic Beanstalk](using-features.logging.md).
## Accès aux artefacts côté client
La **eb migrate** commande stocke les journaux d'applications et d'erreurs générés par les répertoires d'artefacts des migrations **msdeploy** internes.
```
./migrations/
├── latest -> migration_20240308_123456/
└── migration_20240308_123456/
├── application.log
├── error.log
└── upload_target\
```
## Surveillance de la santé de l'environnement
Elastic Beanstalk vous aide à surveiller l'état de santé à l'aide des fonctionnalités améliorées de surveillance de l'état de santé. Il s'agit d'un système de surveillance automatique de l'état de santé qui suit en permanence l'état opérationnel des instances d'application, en tirant parti de mesures intégrées telles que l'utilisation du processeur, la latence, le nombre de demandes et les codes de réponse.
Le système de surveillance de l'état utilise une approche basée sur des agents pour collecter des données au niveau de l'instance et intègre la journalisation et les alertes en temps réel. Elastic Load Balancing (ELB) et Auto Scaling répondent de manière dynamique aux changements d'état de santé, garantissant ainsi une disponibilité et une tolérance aux pannes élevées. Les modes de surveillance avancés, notamment les rapports de santé améliorés, fournissent une visibilité précise du comportement des applications, permettant un dépannage proactif et des mécanismes de restauration automatique.
Exécutez la **eb health** commande EB CLI pour afficher l'état de santé de l'environnement. Les informations suivantes s’affichent :
+ État d'une instance
+ Métriques de réponse des applications
+ Utilisation des ressources du système
+ Événements de déploiement récents
## EC2 optimisation des performances
Par défaut, **eb migrate** sélectionne le type d'instance [c5.2xlarge](https://aws.amazon.com/ec2/instance-types/c5/) pour offrir une première expérience optimale avec Elastic Beanstalk. Vous pouvez modifier ce comportement avec l'**--instance-type**argument suivant :
```
PS C:\migrations_workspace> eb migrate `
--instance-type "t3.large"
```
Pour les environnements de production, tenez compte des facteurs suivants lors de la sélection d'un type d'instance :
+ Besoins en mémoire de vos applications
+ Exigences relatives au processeur pour le traitement des charges de travail
+ Besoins de performance du réseau
+ Objectifs d'optimisation des coûts
## Configuration du volume EBS
Par défaut, Elastic Beanstalk crée uniquement un volume root `C:\` block-device () pour votre environnement. Vous pouvez transmettre des volumes de snapshots Amazon Elastic Block Store supplémentaires avec l'**--ebs-snapshots**option suivante :
```
PS C:\migrations_workspace> eb migrate `
--ebs-snapshots "snap-123456789abc"
```
[Pour des exemples illustrant la manière dont vous pouvez configurer des mappages par blocs avec Elastic Beanstalk, consultez l'article de blog Customize Ephemeral et EBS volumes in Elastic Beanstalk Environments.](https://aws.amazon.com/blogs/devops/customize-ephemeral-and-ebs-volumes-in-elastic-beanstalk-environments/)
Pour les applications nécessitant beaucoup de stockage, envisagez les options suivantes :
+ Utilisation de volumes EBS pour les données persistantes
+ Implémentation d'Amazon S3 pour le contenu statique
+ Utilisation du serveur de fichiers Amazon FSx pour Windows pour les systèmes de fichiers partagés
## Problèmes courants et solutions correspondantes
**Événement :** *installation manquante de Web Deploy*
Si vous rencontrez des erreurs liées à l'impossibilité de trouver Web Deploy, installez Web Deploy 3.6 ou version ultérieure à partir du programme d'[installation de Microsoft Web Platform](https://www.iis.net/downloads/microsoft/web-deploy). L'exemple suivant affiche un message d'erreur possible.
```
Couldn't find msdeploy.exe. Follow instructions here: https://learn.microsoft.com/en-us/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy
```
**Événement :** *Problèmes d'autorisation lors de la migration*
Si vous rencontrez des erreurs liées aux autorisations, assurez-vous d'exécuter l'EB CLI avec des privilèges administratifs. L'exemple suivant affiche un message d'erreur possible.
```
[ERROR] Access to the path 'C:\inetpub\wwwroot\web.config' is denied.
```
**Événement :** *Problèmes d'identité du pool d'applications*
Si votre application ne démarre pas en raison de problèmes d'identité du pool d'applications, créez un script personnalisé pour configurer les identités du pool d'applications, comme indiqué dans[Paramètres personnalisés du pool d'applications](dotnet-migrating-applications-advanced-scenarios.md#dotnet-migrating-applications-advanced-scenarios-apppool).
**Evénement :** *erreurs de configuration du certificat SSL*
Si les liaisons HTTPS ne fonctionnent pas, assurez-vous d'avoir spécifié un ARN de certificat ACM valide à l'aide du paramètre **eb mibrate** option`--ssl-certificates`.
**Événement :** expiration du *délai de création de l'environnement*
Si le délai de création de l'environnement est expiré, vérifiez les CloudFormation événements dans la console AWS de gestion pour détecter les échecs de création de ressources spécifiques. Les causes courantes incluent les problèmes de configuration des VPC ou les limites de service.
## Obtention de support
Si vous rencontrez des problèmes que vous ne parvenez pas à résoudre, AWS Support collectez les informations suivantes avant de nous contacter :
+ ID d'environnement (`eb status`)
+ Journaux des applications (`eb logs --zip`)
+ Artefacts de migration depuis `.\migrations\latest\`
+ Configuration IIS source (sortie de`eb migrate explore --verbose`)
+ Messages d'erreur détaillés
Pour plus d'informations sur la résolution des problèmes liés à Elastic Beanstalk, consultez. [Résolution des problèmes liés à votre environnement Elastic Beanstalk](troubleshooting.md)