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. # Résoudre les problèmes liés à l'agent EC2 Launch v2 Cette section présente des scénarios de résolution des problèmes courants pour EC2 Launch v2, des informations sur l'affichage des journaux d'événements Windows, ainsi que les résultats et les messages des journaux de console. **Topics** + [Scénarios courants](#ec2launchv2-troubleshooting-scenarios) + [Journaux d’événements Windows](#ec2launchv2-windows-event-logs) + [EC2Sortie du journal de la console Launch v2](#ec2launchv2-console-output) ## Scénarios courants de résolution des problèmes Cette section présente les scénarios de dépannage courants et les étapes de résolution. **Topics** + [Le service ne parvient pas à définir le fond d’écran](#ec2launchv2-troubleshooting-wallpaper) + [Le service ne parvient pas à exécuter les données utilisateur](#ec2launchv2-troubleshooting-user-data) + [Le service exécute une tâche une seule fois](#ec2launchv2-troubleshooting-task-once) + [Le service ne parvient pas à exécuter une tâche](#ec2launchv2-troubleshooting-task-failed) + [Le service exécute les données utilisateur plus d’une fois](#ec2launchv2-troubleshooting-user-data-more-than-once) + [Les tâches planifiées de EC2 Launch v1 ne s'exécutent pas après la migration vers EC2 Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration) + [Le service initialise un volume EBS qui n’est pas vide](#ec2launchv2-troubleshooting-ebs-initialize) + [La tâche `setWallpaper` n’est pas activée, mais le fond d’écran se réinitialise au redémarrage](#ec2launchv2-troubleshooting-wallpaper-resets) + [Service bloqué en mode d’exécution](#ec2launchv2-troubleshooting-service-stuck-running) + [Non valide `agent-config.yml` empêche l'ouverture de la boîte de dialogue des paramètres de EC2 Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config) + [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript) ### Le service ne parvient pas à définir le fond d’écran **Résolution** 1. Vérifiez si `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` existe. 1. Vérifiez dans `%ProgramData%\Amazon\EC2Launch\log\agent.log` pour voir si des erreurs se sont produites. ### Le service ne parvient pas à exécuter les données utilisateur **Cause possible** : le service peut avoir échoué avant l’exécution des données utilisateur. **Résolution** 1. Vérifiez `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`. 1. Voyez si `boot`, `network`, `preReady` et `postReadyLocalData` ont tous été marqués comme une réussite. 1. Si l’une des étapes a échoué, vérifiez si `%ProgramData%\Amazon\EC2Launch\log\agent.log` contient des erreurs spécifiques. ### Le service exécute une tâche une seule fois **Résolution** 1. Vérifiez la fréquence de la tâche. 1. Si le service a déjà été exécuté après Sysprep et que la fréquence de la tâche est définie sur `once`, la tâche ne s’exécutera plus. 1. Définissez la fréquence de la tâche sur `always` si vous souhaitez qu'elle l'exécute à chaque exécution de EC2 Launch v2. ### Le service ne parvient pas à exécuter une tâche **Résolution** 1. Vérifiez les dernières entrées dans `%ProgramData%\Amazon\EC2Launch\log\agent.log`. 1. Si aucune erreur n’est survenue, essayez d’exécuter le service manuellement à partir de `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` pour voir si les tâches réussissent. ### Le service exécute les données utilisateur plus d’une fois **Résolution** Les données utilisateur sont traitées différemment entre EC2 Launch v1 et EC2 Launch v2. EC2Launch v1 exécute les données utilisateur sous forme de tâche planifiée sur l'instance lorsque `persist` ce paramètre est défini sur`true`. Si `persist` est défini sur `false`, la tâche n’est pas planifiée même lorsqu’elle se termine avec un redémarrage ou est interrompue pendant son exécution. EC2Launch v2 exécute les données utilisateur en tant que tâche d'agent et suit leur état d'exécution. Si les données utilisateur entraînent un redémarrage de l’ordinateur ou si leur exécution est interrompue, l’état d’exécution `pending` persiste et les données utilisateur seront réexécutées au démarrage suivant de l’instance. Si vous souhaitez empêcher le script de données utilisateur de s’exécuter plusieurs fois, rendez le script idempotent. L’exemple suivant de script idempotent définit le nom de l’ordinateur et joint un domaine. ``` $name = $env:computername if ($name -ne $desiredName) { Rename-Computer -NewName $desiredName } $domain = Get-ADDomain if ($domain -ne $desiredDomain) { Add-Computer -DomainName $desiredDomain } $telnet = Get-WindowsFeature -Name Telnet-Client if (-not $telnet.Installed) { Install-WindowsFeature -Name "Telnet-Client" } false ``` ### Les tâches planifiées de EC2 Launch v1 ne s'exécutent pas après la migration vers EC2 Launch v2 **Résolution** L'outil de migration ne détecte aucune tâche planifiée liée aux scripts EC2 Launch v1 ; par conséquent, il ne configure pas automatiquement ces tâches dans EC2 Launch v2. Pour configurer ces tâches, modifiez le [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)fichier ou utilisez la [boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui). Par exemple, si une tâche planifiée est exécutée sur une instance`InitializeDisks.ps1`, après avoir exécuté l'outil de migration, vous devez spécifier les volumes que vous souhaitez initialiser dans la boîte de dialogue des paramètres de EC2 Launch v2. Voir l’étape 6 de la procédure pour [Modifier les paramètres à l'aide de la boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui). ### Le service initialise un volume EBS qui n’est pas vide **Résolution** Avant d'initialiser un volume, EC2 Launch v2 tente de détecter s'il est vide. Si un volume n’est pas vide, il ignore l’initialisation. Les volumes détectés comme non vides ne sont pas initialisés. Un volume est considéré comme vide si les 4 premiers Ko d’un volume sont vides ou si un volume n’a pas de [disposition de lecteur reconnaissable par Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Un volume initialisé et formaté sur un système Linux n’a pas de disposition de lecteur reconnaissable par Windows, par exemple MBR ou GPT. Par conséquent, il sera considéré comme vide et initialisé. Si vous souhaitez conserver ces données, ne vous fiez pas à la détection de disque vide par EC2 Launch v2. Spécifiez plutôt les volumes que vous souhaitez initialiser dans la [boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui) (voir étape 6) ou dans le [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume). ### La tâche `setWallpaper` n’est pas activée, mais le fond d’écran se réinitialise au redémarrage La tâche `setWallpaper` crée le fichier de raccourci `setwallpaper.lnk` dans le dossier de démarrage de chaque utilisateur existant. Ce fichier de raccourci s’exécute lorsque l’utilisateur se connecte pour la première fois après le démarrage de l’instance. Il configure l’instance avec un fond d’écran personnalisé qui affiche les attributs de l’instance. La suppression de la tâche `setWallpaper` ne supprime pas ce fichier de raccourci. Vous devez supprimer manuellement ce fichier ou le supprimer à l’aide d’un script. Le chemin du raccourci est le suivant : `$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk` **Résolution** Supprimez manuellement ce fichier ou supprimez-le à l’aide d’un script. **Exemple de PowerShell script pour supprimer un fichier de raccourci** ``` foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName) { $startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup" if (Test-Path $startupPath) { $wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk" if (Test-Path $wallpaperSetupPath) { Remove-Item $wallpaperSetupPath -Force -Confirm:$false } } } ``` ### Service bloqué en mode d’exécution **Description** EC2Le lancement de la version 2 est bloqué, avec des messages de journal (`agent.log`) similaires aux suivants : ``` 2022-02-24 08:08:58 Info: ***************************************************************************************** 2022-02-24 08:08:58 Info: EC2Launch Service starting 2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch 2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out 2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port... 2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port. 2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port. 2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port. 2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port. ``` **Cause possible** SAC est activé et utilise le port série. Pour plus d’informations, consultez [Utilisation de SAC pour dépanner votre instance Windows](troubleshoot-using-serial-console.md#troubleshooting-sac). **Résolution** Essayez les étapes suivantes pour résoudre ce problème : + Désactivez le service qui utilise le port série. + Si vous voulez que le service continue à utiliser le port série, écrivez des scripts personnalisés pour exécuter les tâches de l’agent de lancement et invoquez-les en tant que tâches planifiées. ### Non valide `agent-config.yml` empêche l'ouverture de la boîte de dialogue des paramètres de EC2 Launch v2 **Description** EC2Les paramètres de Launch v2 tentent d'analyser le `agent-config.yml` fichier avant qu'il n'ouvre la boîte de dialogue. Si le fichier de configuration YAML ne suit pas le schéma pris en charge, la boîte de dialogue affiche l’erreur suivante : `Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.` **Résolution** 1. Vérifiez que le fichier de configuration est conforme au [schéma pris en charge](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config). 1. Si vous souhaitez commencer à zéro, copiez le fichier de configuration par défaut dans `agent-config.yml`. Vous pouvez utiliser l’[exemple `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) fourni dans la section Configuration des tâches. 1. Vous pouvez également recommencer en supprimant `agent-config.yml`. EC2Les paramètres de Launch v2 génèrent un fichier de configuration vide. ### `task:executeScript should be unique and only invoked once` **Description** Une tâche ne peut pas être répétée dans la même étape. **Résolution** Certaines tâches doivent être entrées sous forme de tableau, telles que [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) et [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Pour obtenir un exemple de la façon d’écrire le script en tant que tableau, consultez [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript). ## Journaux d’événements Windows EC2Launch v2 publie des journaux d'événements Windows pour les événements importants, tels que le démarrage du service, la disponibilité de Windows et la réussite ou l'échec des tâches. Les identificateurs d’événement identifient de manière unique un événement particulier. Chaque événement contient des informations sur l’étape, la tâche et le niveau, ainsi qu’une description. Vous pouvez définir des déclencheurs pour des événements spécifiques à l’aide de l’identificateur d’événement. Événement : IDs fournissez des informations sur un événement et identifiez certains événements de manière unique. Le chiffre le moins significatif d’un ID d’événement indique la gravité d’un événement. | Événement | Chiffre le moins significatif | | --- | --- | | Success | . . .0 | | Informational | . . .1 | | Warning | . . .2 | | Error | . . .3 | Les événements liés au service qui sont générés au démarrage ou à l’arrêt du service incluent un identifiant d’événement à un seul chiffre. | Événement | Identifiant à un chiffre | | --- | --- | | Success | 0 | | Informational | 1 | | Warning | 2 | | Error | 3 | Les messages d’événement pour les événements `EC2LaunchService.exe` commencent par `Service:`. Les messages d’événement pour les événements `EC2Launch.exe` ne commencent pas par `Service:`. Un événement à quatre chiffres IDs inclut des informations sur le stade, la tâche et la gravité d'un événement. **Topics** + [Format de l’ID d’événement](#ec2launchv2-windows-event-logs-format) + [Exemples d’ID d’événement](#ec2launchv2-windows-event-logs-id-examples) + [Schéma du journal des événements Windows](#ec2launch-v2-windows-event-logs-schema) ### Format de l’ID d’événement Le tableau suivant indique le format d'un identifiant d'événement EC2 Launch v2. | 3 | 2 1 | 0 | | --- | --- | --- | | S | T | L | Les lettres et les chiffres du tableau représentent le type d’événement et les définitions suivants. | Type d’événement | Définition | | --- | --- | | S (Stage) | 0 - Message de niveau de service 1 - Démarrer 2 - Réseau 3 - PreReady 5 - Windows est prêt 6 - PostReady 7 - Données utilisateur | | T (Tâche) | Les tâches représentées par les deux valeurs correspondantes sont différentes pour chaque étape. Pour afficher la liste complète des événements, consultez [Schéma du journal des événements Windows](#ec2launch-v2-windows-event-logs-schema). | | L (Niveau de l’événement) | 0 - Réussite 1 - Informationnel 2 - Avertissement 3 - Erreur | ### Exemples d’ID d’événement Voici un exemple d'événement IDs. + `5000` - Windows est prêt à l’emploi + `3010`- La tâche d'activation de Windows en cours d' PreReady étape a été réussie + `6013`- La tâche de définition du fond d'écran dans le stage PostReady Local Data a rencontré une erreur ### Schéma du journal des événements Windows | MessageId/Identifiant de l'événement | Message d’événement | | --- | --- | | . . .0 | Success | | . . .1 | Informational | | . . .2 | Warning | | . . .3 | Error | | x | EC2Launch service-level logs | | 0 | EC2Launch service exited successfully | | 1 | EC2Launch service informational logs | | 2 | EC2Launch service warning logs | | 3 | EC2Launch service error logs | | 10 | Replace state.json with previous-state.json | | 100 | Serial Port | | 200 | Sysprep | | 300 | PrimaryNic | | 400 | Metadata | | x000 | Stage (1 digit), Task (2 digits), Status (1 digit) | | 1000 | Boot | | 1010 | Boot - extend\$1root\$1partition | | 2000 | Network | | 2010 | Network - add\$1routes | | 3000 | PreReady | | 3010 | PreReady - activate\$1windows | | 3020 | PreReady - install\$1egpu\$1manager | | 3030 | PreReady - set\$1monitor\$1on | | 3040 | PreReady - set\$1hibernation | | 3050 | PreReady - set\$1admin\$1account | | 3060 | PreReady - set\$1dns\$1suffix | | 3070 | PreReady - set\$1wallpaper | | 3080 | PreReady - set\$1update\$1schedule | | 3090 | PreReady - output\$1log | | 3100 | PreReady - enable\$1open\$1ssh | | 5000 | Windows is Ready to use | | 6000 | PostReadyLocalData | | 7000 | PostReadyUserData | | 6010/7010 | PostReadyLocal/UserData - set\$1wallpaper | | 6020/7020 | PostReadyLocal/UserData - set\$1update\$1schedule | | 6030/7030 | PostReadyLocal/UserData - set\$1hostname | | 6040/7040 | PostReadyLocal/UserData - execute\$1program | | 6050/7050 | PostReadyLocal/UserData - execute\$1script | | 6060/7060 | PostReadyLocal/UserData - manage\$1package | | 6070/7070 | PostReadyLocal/UserData - initialize\$1volume | | 6080/7080 | PostReadyLocal/UserData - write\$1file | | 6090/7090 | PostReadyLocal/UserData - start\$1ssm | | 7100 | PostReadyUserData - enable\$1open\$1ssh | | 6110/7110 | PostReadyLocal/UserData - enable\$1jumbo\$1frames | ## EC2Sortie du journal de la console Launch v2 Cette section contient des exemples de sortie du journal de console pour EC2 Launch v2 et répertorie tous les messages d'erreur du journal de la console EC2 Launch v2 pour vous aider à résoudre les problèmes. Pour plus d'informations sur la sortie de la console de l'instance et sur la manière d'y accéder, consultez [Sortie de la console de l’instance](troubleshoot-unreachable-instance.md#instance-console-console-output). **Topics** + [EC2Sortie du journal de la console Launch v2](#ec2launchv2-console-log-output) + [EC2Messages du journal de la console Lancer la v2](#ec2launchv2-console-log-messages) ### EC2Sortie du journal de la console Launch v2 Voici un exemple de sortie du journal de console pour EC2 Launch v2. Dans cet exemple, certaines valeurs sont remplacées par du texte représentatif entouré d’accolades. ``` 2025/07/22 21:26:53Z: Windows sysprep configuration complete. 2025/07/22 21:26:53Z: Message: Waiting for access to metadata... 2025/07/22 21:26:53Z: Message: Meta-data is now available. 2025/07/22 21:26:53Z: AMI Origin Version: 2024.12.13 2025/07/22 21:26:53Z: AMI Origin Name: Windows_Server-2022-English-Full-Base 2025/07/22 21:26:53Z: OS: Microsoft Windows NT 10.0.20348 2025/07/22 21:26:53Z: OsVersion: 10.0 2025/07/22 21:26:53Z: OsProductName: Windows Server 2022 Datacenter 2025/07/22 21:26:53Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500 2025/07/22 21:26:53Z: OsCurrentBuild: 20348 2025/07/22 21:26:53Z: OsReleaseId: 2009 2025/07/22 21:26:53Z: Language: en-US 2025/07/22 21:26:53Z: TimeZone: UTC 2025/07/22 21:26:53Z: Offset: UTC +0000 2025/07/22 21:26:53Z: Launch: EC2 Launch v2.2.63 2025/07/22 21:26:53Z: AMI-ID: ami-1234567890abcdef1 2025/07/22 21:26:53Z: Instance-ID: i-1234567890abcdef0 2025/07/22 21:26:54Z: Instance Type: t3.xlarge 2025/07/22 21:26:54Z: Driver: AWS NVMe Driver v1.6.0.35 2025/07/22 21:26:54Z: SubComponent: 1.6.0.35; EnableSCSIPersistentReservations: 0 2025/07/22 21:26:54Z: Driver: AWS PV Driver Package v8.5.0 2025/07/22 21:26:55Z: Driver: Amazon Elastic Network Adapter v2.8.0.0 2025/07/22 21:26:55Z: HOSTNAME: EC2AMAZ-9FJG5CC 2025/07/22 21:26:55Z: RDPCERTIFICATE-SUBJECTNAME: {certificate subject name} 2025/07/22 21:26:55Z: RDPCERTIFICATE-THUMBPRINT: {thumbprint hash} 2025/07/22 21:26:56Z: SSM: Amazon SSM Agent v3.3.2746.0 2025/07/22 21:26:57Z: User data format: no_user_data 2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsTelemetryEnabled=true 2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64 2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true 2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentCommandErrorCode=1 2025/07/22 21:26:57Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0 2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentErrorLocation=execute_windows.go:410 2025/07/22 21:26:57Z: EC2LaunchTelemetry: IpConflictDetectionCode=0 2025/07/22 21:26:57Z: Message: Windows is Ready to use {"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...} {"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...} ``` ### EC2Messages du journal de la console Lancer la v2 Vous trouverez ci-dessous une liste de tous les messages du journal de la console EC2 Launch v2. ``` Error EC2Launch service is stopping. {error message} ``` Détails de l’erreur de service arrêté : + `Error setting up EC2Launch agent folders` + `See instance logs for detail` + `Error stopping service` + `Error initializing service` ``` Windows sysprep configuration complete ``` ``` Invalid administrator username: {invalid username} ``` ``` Invalid administrator password Username: {username} Password: {encrypted password} ``` Le message suivant est un bloc d’informations contenant les détails de l’AMI : ``` AMI Origin Version: {amiVersion} AMI Origin Name: {amiName} Microsoft Windows NT {currentVersion}.{currentBuildNumber} OsVersion: {currentVersion} OsProductName: {productName} OsBuildLabEx: {buildLabEx} OsCurrentBuild: {currentBuild} OsReleaseId: {releaseId} Language: {language} TimeZone: {timeZone} Offset: UTC {offset} Launch agent: EC2Launch {BuildVersion} AMI-ID: {amiId} Instance-ID: {instanceId} Instance Type: {instanceType} HOSTNAME: {computer name} RDPCERTIFICATE-SUBJECTNAME: {certificate subject name} RDPCERTIFICATE-THUMBPRINT: {thumbprint hash} SqlServerBilling: {sql billing} SqlServerInstall: {sql patch leve, edition type} Driver: AWS NVMe Driver {version} Driver: Inbox NVMe Driver {version} Driver: AWS PV Driver Package {version} SSM: Amazon SSM Agent {version} AWS VSS Version: {version} ``` ``` Windows sysprep configuration complete. Windows is being configured. 'SysprepState is {state}' Windows is still being configured. 'SysprepState is {state}' Windows is Ready to use Waiting for access to metadata... Meta-data is now available. Metadata is not available for this instance. Timed out waiting for access to metadata. User data format: {format} ``` Les messages de télémétrie EC2Launch v2 incluent les valeurs des propriétés de télémétrie de lancement. À partir de la version 2.2.63, les données de télémétrie de l’agent EC2 sont formatées sous forme d’objet JSON : ``` EC2LaunchTelemetry: {telemetry property} ``` ``` {"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... } ```