Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah build yang gagal dengan AI - Pratinjau
**Fitur pratinjau**
Fitur ini dalam pratinjau dan dapat berubah.
Ketika build EC2 Image Builder gagal, akar penyebabnya bisa memakan waktu dan rumit untuk diidentifikasi. Fitur Troubleshoot di Image Builder, didukung oleh AWS DevOps Agen, mengotomatiskan proses ini dengan analisis. AI-powered Anda dapat dengan cepat mengidentifikasi penyebab kegagalan build yang kompleks atau mendeteksi pola di beberapa pipeline yang gagal.
Jika build gagal, Anda dapat menggunakan Troubleshoot untuk menganalisis log build, CloudWatch log Amazon, eksekusi langkah alur kerja, dan sumber daya terkait. AWS Anda menerima analisis akar penyebab dan langkah-langkah remediasi untuk menyelesaikan masalah.
Anda dapat memecahkan masalah satu build pipeline yang gagal atau menganalisis beberapa pipeline yang gagal untuk mengidentifikasi pola umum dan akar penyebab bersama.
**Topics**
+ [Prasyarat](#devops-agent-troubleshooting-prereqs)
+ [Mengatur pemecahan masalah](#devops-agent-troubleshooting-setup)
+ [Memecahkan masalah build yang gagal](#devops-agent-troubleshooting-single)
+ [Memecahkan masalah beberapa saluran pipa yang gagal](#devops-agent-troubleshooting-aggregate)
+ [Apa yang diselidiki oleh Troubleshoot](#devops-agent-troubleshooting-checks)
+ [Pertimbangan-pertimbangan](#devops-agent-troubleshooting-considerations)
## Prasyarat
Sebelum Anda menggunakan fitur Troubleshoot, pastikan bahwa pengguna IAM atau peran yang Anda gunakan memiliki izin berikut:
+ `aidevops:ListAgentSpaces`— Diperlukan untuk menemukan ruang agen yang tersedia.
+ `aidevops:CreateChat`— Diperlukan untuk memulai sesi pemecahan masalah.
+ `aidevops:SendChatMessage`— Diperlukan untuk mengirim pesan selama pemecahan masalah.
+ `aidevops:CreateAgentSpace`- Diperlukan hanya jika Anda ingin Image Builder membuat ruang agen untuk Anda. Anda dapat menghilangkan izin ini jika Anda membawa ruang agen Anda sendiri.
Untuk informasi selengkapnya tentang kebijakan IAM, lihat [Kebijakan dan izin di](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) IAM.
## Mengatur pemecahan masalah
Fitur Troubleshoot membutuhkan ruang agen AWS DevOps Agen. Anda dapat menggunakan ruang agen yang ada atau meminta Image Builder membuatnya untuk Anda:
+ **Bawa ruang agen Anda sendiri** - Jika Anda sudah memiliki ruang agen, Image Builder menggunakannya untuk pemecahan masalah.
+ **Minta Image Builder membuat satu** — Jika Anda tidak memiliki ruang agen, Image Builder membuat dan mengonfigurasinya saat memulai penyelidikan pertama. Opsi ini membutuhkan `aidevops:CreateAgentSpace` izin.
Untuk memulai pemecahan masalah, pilih ikon **Pemecahan Masalah** di header. Konsol Manajemen AWS
**catatan**
Untuk informasi selengkapnya tentang AWS DevOps Agen, lihat [Panduan Pengguna AWS DevOps Agen](https://docs.aws.amazon.com/devopsagent/latest/userguide/).
## Memecahkan masalah build yang gagal
Ketika pembuatan gambar gagal, Anda dapat memulai AI-powered penyelidikan dari beberapa titik masuk di Image Builder Konsol Manajemen AWS.
### Mulai investigasi pemecahan masalah
Gunakan salah satu metode berikut untuk memulai pemecahan masalah build yang gagal:
+ **Tabel saluran pipa** - Pilih ikon **Pemecahan Masalah** di samping status pipeline yang gagal dalam daftar saluran pipa **Gambar**.
+ **Tabel gambar keluaran** - Pilih ikon **Pemecahan Masalah** di samping build gambar yang gagal dalam daftar gambar keluaran.
+ **Laci pemecahan masalah** — Di Konsol Manajemen AWS header, pilih ikon **Pemecahan Masalah**, lalu pilih pipeline yang ingin Anda selidiki.
### Selama investigasi
Setelah Anda memulai pemecahan masalah, Troubleshoot menyelidiki kegagalan. Anda dapat melacak kemajuan waktu nyata di laci saat log dan sumber daya dianalisis. Investigasi biasanya selesai dalam beberapa menit. Anda dapat terus bekerja di Konsol Manajemen AWS area lain saat analisis berjalan. Ketika penyelidikan selesai, Anda menerima:
+ Analisis akar penyebab yang mengidentifikasi mengapa build gagal
+ Langkah-langkah remediasi untuk menyelesaikan masalah
+ Perintah atau perubahan konfigurasi untuk memperbaiki masalah
Setelah Anda meninjau hasilnya, Anda dapat memberikan umpan balik tentang kualitas respons. Untuk menjalankan kembali analisis terhadap build gagal yang sama, pilih **Troubleshoot** lagi.
## Memecahkan masalah beberapa saluran pipa yang gagal
Jika Anda memiliki beberapa saluran pipa yang gagal, Anda dapat menganalisisnya bersama-sama untuk mengidentifikasi pola umum dan akar penyebab bersama.
### Mulai investigasi agregat
Gunakan salah satu metode berikut untuk memecahkan masalah beberapa pipeline:
+ Dalam tabel **Image pipelines**, pilih beberapa pipeline gagal dan pilih **Troubleshoot** yang dipilih.
+ Buka laci pemecahan masalah dan pilih **Troubleshoot all untuk menganalisis semua pipeline** yang gagal.
### Hasil analisis agregat
Anda menerima analisis dikelompokkan yang diatur berdasarkan akar penyebab. Untuk setiap grup, Anda mendapatkan:
+ Deskripsi akar penyebab bersama
+ Saluran pipa dipengaruhi oleh akar penyebab itu
+ Langkah-langkah remediasi untuk kelompok
Setelah analisis agregat, Anda dapat memilih prompt penelusuran untuk menyelidiki pipeline tertentu secara lebih rinci.
## Apa yang diselidiki oleh Troubleshoot
Saat Anda memecahkan masalah build yang gagal, analisis mencakup area berikut:
+ **Buat log dan CloudWatch log Amazon** — Memeriksa kesalahan, kode keluar bukan nol, batas waktu, dan jejak tumpukan.
+ **Eksekusi langkah alur kerja** - Mengidentifikasi langkah yang gagal dan memeriksa detailnya.
+ **Jaringan dan izin - Meninjau izin** profil instans IAM, grup keamanan, perutean subnet, gateway NAT, gateway internet, dan titik akhir VPC.
+ **Komponen dan konfigurasi resep** — Memeriksa kesalahan skrip, dependensi yang hilang, URL rusak, dan validitas AMI dasar.
+ **Konektivitas jaringan** — Memeriksa AWS Systems Manager (Systems Manager) Keterjangkauan agen, resolusi DNS, dan konfigurasi proxy.
+ **Riwayat build** — Meninjau build terbaru untuk membedakan kegagalan persisten dari masalah intermiten.
## Pertimbangan-pertimbangan
Perhatikan hal berikut saat menggunakan fitur Troubleshoot:
+ Pemecahan masalah melakukan analisis hanya-baca. Sumber daya Anda tidak dimodifikasi.
+ Pemecahan masalah mencakup kegagalan build Image Builder dan infrastruktur terkait seperti IAM, VPC, dan Systems Manager Agent.
**catatan**
AI menghasilkan respons ini. Verifikasi analisis dan rekomendasi sebelum Anda memodifikasi sumber daya Anda.
Untuk informasi selengkapnya tentang pemecahan masalah build pipeline Image Builder, lihat. [Memecahkan masalah pembangunan pipa](troubleshooting.md#troubleshooting-pipelines)