Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah dengan agen EC2 Launch v2
Bagian ini menunjukkan skenario pemecahan masalah umum untuk EC2 Launch v2, informasi tentang melihat log peristiwa Windows, dan keluaran log konsol dan pesan.
**Topics**
+ [Skenario umum](#ec2launchv2-troubleshooting-scenarios)
+ [Log peristiwa Windows](#ec2launchv2-windows-event-logs)
+ [EC2Luncurkan keluaran log konsol v2](#ec2launchv2-console-output)
## Skenario pemecahan masalah umum
Bagian ini menunjukkan skenario pemecahan masalah umum dan langkah-langkah penyelesaiannya.
**Topics**
+ [Layanan gagal menyetel wallpaper](#ec2launchv2-troubleshooting-wallpaper)
+ [Layanan gagal menjalankan data pengguna](#ec2launchv2-troubleshooting-user-data)
+ [Layanan menjalankan tugas hanya satu kali](#ec2launchv2-troubleshooting-task-once)
+ [Layanan gagal menjalankan tugas](#ec2launchv2-troubleshooting-task-failed)
+ [Layanan menjalankan data pengguna lebih dari satu kali](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Tugas terjadwal dari EC2 Launch v1 gagal dijalankan setelah migrasi ke EC2 Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [Layanan menginisialisasi volume EBS yang tidak kosong](#ec2launchv2-troubleshooting-ebs-initialize)
+ [Tugas `setWallpaper` tidak diaktifkan tetapi wallpaper diatur ulang saat reboot](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Layanan macet dalam status berjalan](#ec2launchv2-troubleshooting-service-stuck-running)
+ [Tidak valid `agent-config.yml` mencegah membuka kotak dialog pengaturan EC2 Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### Layanan gagal menyetel wallpaper
**Resolusi**
1. Periksa apakah `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` ada.
1. Periksa `%ProgramData%\Amazon\EC2Launch\log\agent.log` untuk melihat apakah ada kesalahan yang terjadi.
### Layanan gagal menjalankan data pengguna
**Penyebab potensial**: Layanan mungkin gagal sebelum menjalankan data pengguna.
**Resolusi**
1. Periksa `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Lihat jika `boot`, `network`, `preReady`, dan `postReadyLocalData` semuanya telah ditandai sebagai sukses.
1. Jika salah satu tahapan gagal, periksa `%ProgramData%\Amazon\EC2Launch\log\agent.log` jika ada kesalahan tertentu.
### Layanan menjalankan tugas hanya satu kali
**Resolusi**
1. Periksa frekuensi tugas.
1. Jika layanan sudah berjalan setelah Sysprep, dan frekuensi tugas diatur ke `once`, tugas tidak akan dijalankan lagi.
1. Atur frekuensi tugas ke `always` jika Anda ingin menjalankan tugas setiap kali EC2 Launch v2 berjalan.
### Layanan gagal menjalankan tugas
**Resolusi**
1. Periksa entri terbaru di `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Jika tidak ada kesalahan yang terjadi, coba jalankan layanan secara manual dari `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` untuk melihat apakah tugas berhasil.
### Layanan menjalankan data pengguna lebih dari satu kali
**Resolusi**
Data pengguna ditangani secara berbeda antara EC2 Launch v1 dan EC2 Launch v2. EC2Launch v1 menjalankan data pengguna sebagai tugas terjadwal pada instance saat `persist` disetel ke`true`. Jika `persist` diatur ke, `false`maka tugas tidak dijadwalkan bahkan saat keluar dengan reboot atau terganggu saat berjalan.
EC2Launch v2 menjalankan data pengguna sebagai tugas agen dan melacak status jalanannya. Jika masalah data pengguna me-restart komputer atau jika data pengguna terganggu saat berjalan, maka status berjalan-nya masih tetap ada sebagai `pending` dan data pengguna akan berjalan lagi pada boot instans berikutnya. Jika Anda ingin mencegah skrip data pengguna berjalan lebih dari sekali, buat skrip menjadi idempoten.
Contoh skrip idempotensi berikut mengatur nama komputer dan bergabung dengan domain.
```
$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
```
### Tugas terjadwal dari EC2 Launch v1 gagal dijalankan setelah migrasi ke EC2 Launch v2
**Resolusi**
Alat migrasi tidak mendeteksi tugas terjadwal yang ditautkan ke skrip EC2 Launch v1; oleh karena itu, alat ini tidak secara otomatis mengatur tugas-tugas tersebut di EC2 Launch v2. Untuk mengonfigurasi tugas-tugas ini, edit [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)file, atau gunakan [kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui). Misalnya, jika sebuah instance memiliki tugas terjadwal yang berjalan`InitializeDisks.ps1`, maka setelah Anda menjalankan alat migrasi, Anda harus menentukan volume yang ingin Anda inisialisasi di kotak dialog EC2 Launch v2 settings. Lihat Langkah 6 prosedur untuk [Ubah pengaturan menggunakan kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui).
### Layanan menginisialisasi volume EBS yang tidak kosong
**Resolusi**
Sebelum menginisialisasi volume, EC2 Launch v2 mencoba mendeteksi apakah itu kosong. Jika volume tidak kosong, maka ia melewatkan inisialisasi. Setiap volume yang terdeteksi sebagai tidak kosong tidak akan diinisialisasi. Volume dianggap kosong jika 4 KiB pertama dari volume adalah kosong, atau jika volume tidak memiliki [tata letak hard disk yang dapat dikenali Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Volume yang diinisialisasi dan diformat pada sistem Linux tidak memiliki tata letak hard disk yang dikenali Windows, misalnya MBR atau GPT. Oleh karena itu, volume tersebut akan dianggap sebagai volume kosong dan diinisialisasi. Jika Anda ingin menyimpan data ini, jangan mengandalkan deteksi drive kosong EC2 Luncurkan v2. Sebagai gantinya, tentukan volume yang ingin Anda inisialisasi di [kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui) (lihat langkah 6) atau di [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume).
### Tugas `setWallpaper` tidak diaktifkan tetapi wallpaper diatur ulang saat reboot
`setWallpaper`Tugas membuat file `setwallpaper.lnk` pintasan di folder startup setiap pengguna yang ada. File pintasan ini berjalan saat pengguna masuk untuk pertama kalinya setelah boot instans. File ini menyiapkan instans dengan wallpaper kustom yang menampilkan atribut instans. Menghapus `setWallpaper` tugas tidak menghapus file pintasan ini. Anda harus menghapus file ini secara manual atau menghapusnya menggunakan skrip.
Jalur pintasnya adalah:
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Resolusi**
Hapus file ini secara manual, atau hapus menggunakan skrip.
**Contoh PowerShell skrip untuk menghapus file pintasan**
```
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
}
}
}
```
### Layanan macet dalam status berjalan
**Deskripsi**
EC2Luncurkan v2 diblokir, dengan pesan log (`agent.log`) mirip dengan berikut ini:
```
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.
```
**Kemungkinan penyebab**
SAC diaktifkan dan menggunakan port serial. Untuk informasi selengkapnya, lihat [Gunakan SAC untuk memecahkan masalah instans Windows Anda](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Resolusi**
Coba langkah-langkah berikut untuk mengatasi masalah ini:
+ Nonaktifkan layanan yang menggunakan port serial.
+ Jika Anda ingin layanan terus menggunakan port serial, tulis skrip khusus untuk melakukan tugas agen peluncuran dan menginvokasinya sebagai tugas terjadwal.
### Tidak valid `agent-config.yml` mencegah membuka kotak dialog pengaturan EC2 Launch v2
**Deskripsi**
EC2Luncurkan pengaturan v2 mencoba mengurai `agent-config.yml` file sebelum membuka kotak dialog. Jika file konfigurasi YAMB tidak mengikuti skema yang didukung, kotak dialog akan menampilkan kesalahan berikut:
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Resolusi**
1. Verifikasi bahwa file konfigurasi mengikuti [skema yang didukung](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config).
1. Jika Anda ingin memulai dari awal, salin file konfigurasi default ke `agent-config.yml`. Anda dapat menggunakan [contoh `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) yang disediakan di bagian Konfigurasi Tugas.
1. Anda juga dapat memulai dari awal dengan menghapus `agent-config.yml`. EC2Luncurkan pengaturan v2 menghasilkan file konfigurasi kosong.
### `task:executeScript should be unique and only invoked once`
**Deskripsi**
Tugas tidak dapat diulang dalam tahap yang sama.
**Resolusi**
Beberapa tugas harus dimasukkan sebagai array, seperti [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) dan [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Untuk contoh cara menulis skrip sebagai array, lihat [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Log peristiwa Windows
EC2Launch v2 menerbitkan log peristiwa Windows untuk acara penting, seperti memulai layanan, Windows siap, dan keberhasilan dan kegagalan tugas. Pengidentifikasi peristiwa secara unik mengidentifikasi peristiwa tertentu. Setiap acara berisi informasi tahapan, tugas, dan level, serta deskripsi. Anda dapat mengatur pemicu untuk peristiwa tertentu menggunakan pengenal peristiwa.
Acara IDs memberikan informasi tentang suatu peristiwa dan secara unik mengidentifikasi beberapa peristiwa. Digit paling signifikan dari ID peristiwa menunjukkan tingkat keparahan suatu peristiwa.
| Peristiwa | Digit paling tidak signifikan |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Peristiwa terkait layanan yang dihasilkan ketika layanan dimulai atau berhenti termasuk satu digit pengenal peristiwa.
| Peristiwa | Pengenal digit tunggal |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
Pesan peristiwa untuk peristiwa `EC2LaunchService.exe` dimulai dengan `Service:`. Pesan peristiwa untuk peristiwa `EC2Launch.exe` tidak dimulai dengan `Service:`.
Acara empat digit IDs mencakup informasi tentang tahap, tugas, dan tingkat keparahan suatu peristiwa.
**Topics**
+ [Format ID Peristiwa](#ec2launchv2-windows-event-logs-format)
+ [Contoh ID Peristiwa](#ec2launchv2-windows-event-logs-id-examples)
+ [Skema log peristiwa Windows](#ec2launch-v2-windows-event-logs-schema)
### Format ID Peristiwa
Tabel berikut menunjukkan format pengenal peristiwa EC2 Launch v2.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| D | T | L |
Huruf dan angka dalam tabel mewakili tipe dan definisi peristiwa berikut.
| Tipe peristiwa | Definisi |
| --- | --- |
| S (Panggung) | 0 - Pesan tingkat layanan 1 - Boot 2 - Jaringan 3 - PreReady 5 - Windows sudah Siap 6 - PostReady 7 - Data Pengguna |
| T (Tugas) | Tugas yang diwakili oleh dua nilai yang sesuai berbeda untuk setiap tahap. Untuk melihat daftar lengkap peristiwa, lihat [Skema log Peristiwa Windows](#ec2launch-v2-windows-event-logs-schema). |
| L (Level peristiwa) | 0 - Sukses 1 - Informasi 2 - Peringatan 3 - Kesalahan |
### Contoh ID Peristiwa
Berikut ini adalah contoh peristiwa IDs.
+ `5000` - Windows siap digunakan
+ `3010`- Aktifkan tugas windows di PreReady panggung berhasil
+ `6013`- Mengatur tugas wallpaper di tahap Data PostReady Lokal mengalami kesalahan
### Skema log peristiwa Windows
| MessageId/ Id Acara | Pesan peristiwa |
| --- | --- |
| . . .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 |
## EC2Luncurkan keluaran log konsol v2
Bagian ini berisi contoh keluaran log konsol untuk EC2 Launch v2 dan mencantumkan semua pesan kesalahan log konsol EC2 Luncurkan v2 untuk membantu Anda memecahkan masalah. Untuk informasi selengkapnya tentang keluaran konsol instance dan cara mengaksesnya, lihat[Output konsol instans](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [EC2Luncurkan keluaran log konsol v2](#ec2launchv2-console-log-output)
+ [EC2Luncurkan pesan log konsol v2](#ec2launchv2-console-log-messages)
### EC2Luncurkan keluaran log konsol v2
Berikut ini adalah contoh keluaran log konsol untuk EC2 Launch v2. Beberapa nilai dalam contoh ini diganti dengan teks representatif yang dikelilingi oleh kurawal kurawal.
```
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", ...}
```
### EC2Luncurkan pesan log konsol v2
Berikut ini adalah daftar semua pesan log konsol EC2 Launch v2.
```
Error EC2Launch service is stopping. {error message}
```
Detail kesalahan layanan yang dihentikan:
+ `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}
```
Pesan berikut adalah blok informasi yang berisi detail 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}
```
Pesan telemetri EC2launch v2 menyertakan nilai properti telemetri peluncuran. Dimulai dengan versi 2.2.63, data telemetri agen EC2 diformat sebagai objek JSON.
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```