Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemecahan masalah Amazon ECS
Anda mungkin perlu memecahkan masalah dengan penyeimbang beban, tugas, layanan, atau instance kontainer Anda. Bab ini membantu Anda menemukan informasi diagnostik dari agen penampung Amazon ECS, daemon Docker pada instance container, dan log peristiwa layanan di konsol Amazon ECS.
Untuk informasi tentang tugas yang dihentikan, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Mengatasi kesalahan tugas yang dihentikan. | [Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md) |
| Lihat kesalahan tugas yang dihentikan. | [Mengatasi kesalahan tugas Amazon ECS yang dihentikan](resolve-stopped-errors.md) |
| Tinjau kode kesalahan tugas yang dihentikan. | [Amazon ECS menghentikan pesan kesalahan tugas](stopped-task-error-codes.md) |
| Tinjau kesalahan CannotPullContainer tugas. | [CannotPullContainer kesalahan tugas di Amazon ECS](task_cannot_pull_image.md) |
| Lihat permintaan peran IAM tugas. | [Melihat permintaan peran IAM untuk tugas Amazon ECS](task_iam_roles-logs.md) |
| Memecahkan masalah menggunakan acara tugas. | [Pengambilan acara Amazon ECS di konsol](task-lifecycle-events.md) |
Untuk informasi tentang kesalahan layanan, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Lihat pesan acara layanan. | [Melihat pesan acara layanan Amazon ECS](service-event-messages.md) |
| Tinjau pesan acara layanan. | [Pesan peristiwa layanan Amazon ECS](service-event-messages-list.md) |
| Tinjau masalah penyeimbang beban. | [Memecahkan masalah penyeimbang beban layanan di Amazon ECS](troubleshoot-service-load-balancers.md) |
| Tinjau masalah penskalaan otomatis layanan. | [Pemecahan masalah penskalaan otomatis layanan di Amazon ECS](troubleshoot-service-auto-scaling.md) |
Untuk informasi tentang kesalahan definisi tugas, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Mengatasi kesalahan memori definisi tugas. | [Memecahkan masalah kesalahan kesalahan CPU atau memori Amazon ECS definisi tugas yang tidak valid](task-cpu-memory-error.md) |
Untuk informasi tentang kesalahan agen Amazon ECS, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Lihat log agen kontainer Amazon ECS. | [Melihat log agen kontainer Amazon ECS](logs.md) |
| Pelajari cara mengumpulkan log Amazon ECS. | [Mengumpulkan log kontainer dengan kolektor log Amazon ECS](ecs-logs-collector.md) |
| Ambil detail diagnostik dengan agen Amazon ECS. | [Ambil detail diagnostik Amazon ECS dengan introspeksi agen](introspection-diag.md) |
Untuk informasi tentang kesalahan Docker, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Gunakan diagnostik Docker. | [Diagnostik Docker di Amazon ECS](docker-diags.md) |
| Aktifkan mode debug Docker. | [Mengkonfigurasi output verbose dari daemon Docker di Amazon ECS](docker-debug-mode.md) |
| Memecahkan masalah kesalahan API Docker 500. | [Memecahkan masalah Docker di Amazon `API error (500): devmapper` ECS](CannotCreateContainerError.md) |
Untuk informasi tentang kesalahan ECS Exec dan Amazon ECS Anywhere, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Memecahkan masalah ECS Exec. | [Memecahkan masalah Amazon ECS Exec](ecs-exec-troubleshooting.md) |
| Memecahkan masalah Amazon ECS Anywhere. | [Memecahkan masalah Amazon ECS Anywhere](ecs-anywhere-troubleshooting.md) |
Untuk informasi tentang masalah dengan melampirkan volume Amazon EBS ke tugas Amazon ECS, lihat berikut ini:
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Memecahkan masalah lampiran volume Amazon EBS ke tugas Amazon ECS. | [Memecahkan masalah lampiran volume Amazon EBS ke tugas Amazon ECS](troubleshoot-ebs-volumes.md) |
| Alasan status untuk lampiran volume Amazon EBS ke tugas Amazon ECS. | [Alasan status untuk lampiran volume Amazon EBS ke tugas Amazon ECS](troubleshoot-ebs-volumes-scenarios.md) |
Untuk informasi tentang masalah dengan menggunakan AWS Cloud Map ruang nama bersama dengan Amazon ECS Service Connect, lihat salah satu dari berikut ini:
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Memecahkan masalah Amazon ECS Service Connect dengan ruang nama bersama. AWS Cloud Map | [Memecahkan masalah Amazon ECS Service Connect dengan ruang nama bersama AWS Cloud Map](service-connect-shared-namespaces-troubleshooting.md) |
Untuk informasi tentang masalah pembatasan, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Pelajari tentang kuota pelambatan Fargate. | [AWS Fargate kuota pelambatan](throttling.md) |
| Pelajari praktik terbaik untuk pelambatan Amazon ECS. | [Menangani masalah pelambatan Amazon ECS](operating-at-scale-dealing-with-throttles.md) |
Untuk informasi tentang error API, lihat salah satu dari berikut ini.
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Mengatasi kesalahan API. | [Alasan kegagalan Amazon ECS API](api_failures_messages.md) |
Untuk informasi tentang pemecahan masalah yang didukung AI, lihat berikut ini:
| Tindakan | Pelajari selengkapnya |
| --- | --- |
| Memecahkan masalah dengan Pengembang Amazon Q di konsol. | [Pemecahan Masalah dengan Pengembang Amazon Q](troubleshooting-with-Q.md) |
| Memecahkan masalah dengan asisten AI menggunakan server Amazon ECS MCP. | [Server MCP Amazon ECS](ecs-mcp-introduction.md) |
# Mengatasi kesalahan tugas Amazon ECS yang dihentikan
Ketika tugas Anda gagal dimulai, Anda melihat pesan kesalahan di konsol dan di parameter `describe-tasks` output (`stoppedReason`dan`stopCode`).
Anda dapat melihat tugas yang dihentikan di konsol selama satu jam. Untuk melihat tugas yang dihentikan, Anda harus mengubah opsi filter. Untuk informasi selengkapnya, lihat [Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
Halaman-halaman berikut memberikan informasi tentang tugas yang dihentikan.
+ Pelajari tentang perubahan pada pesan galat tugas yang dihentikan.
[Amazon ECS menghentikan pembaruan pesan kesalahan tugas](stopped-tasks-error-messages-updates.md)
+ Lihat tugas yang dihentikan sehingga Anda bisa mendapatkan informasi tentang penyebabnya.
[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md)
+ Pelajari tentang pesan kesalahan tugas yang dihentikan dan kemungkinan alasan kesalahan tersebut.
[Amazon ECS menghentikan pesan kesalahan tugas](stopped-task-error-codes.md)
+ Pelajari cara memverifikasi konektivitas tugas yang dihentikan dan memperbaiki kesalahan.
[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md)
# Amazon ECS menghentikan pembaruan pesan kesalahan tugas
Mulai 14 Juni 2024 tim Amazon ECS mengubah pesan kesalahan tugas yang dihentikan seperti yang dijelaskan dalam tabel berikut. Tidak `stopCode` akan berubah. Jika aplikasi Anda bergantung pada string pesan kesalahan yang tepat, Anda harus memperbarui aplikasi Anda dengan string baru. Untuk bantuan dengan pertanyaan atau masalah, hubungi AWS Dukungan.
**catatan**
Kami menyarankan Anda untuk tidak mengandalkan pesan kesalahan untuk otomatisasi Anda, karena pesan kesalahan dapat berubah.
## CannotPullContainerError
| Pesan kesalahan lama | Pesan kesalahan baru |
| --- | --- |
| CannotPullContainerError: Respons kesalahan dari daemon: akses tarik ditolak untukrepository, repositori tidak ada atau mungkin memerlukan 'docker login': ditolak: Pengguna: roleARN | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/stopped-tasks-error-messages-updates.html) |
| CannotPullContainerError: Tanggapan kesalahan dari daemon: DapatkanimageURI: net/http: permintaan dibatalkan sambil menunggu koneksi | CannotPullContainerError: Tugas tidak dapat menarik gambar. Periksa konfigurasi jaringan Anda. Respons kesalahan dari daemon: Dapatkan: net/httpimage: permintaan dibatalkan sambil menunggu koneksi (Klien.Timeout terlampaui saat menunggu header) |
| CannotPullContainerError: ref pull telah dicoba ulang 5 kali: gagal menyalin:: gagal buka httpReadSeeker: gagal melakukan permintaan: Get: dial tcpregistry-uri: timeout i/o | CannotPullContainerError: Tugas tidak dapat menarik image-uri dari registriregistry-uri. Ada masalah koneksi antara tugas dan registri. Periksa konfigurasi jaringan tugas Anda.: gagal menyalin: httpReadSeeker: gagal buka: gagal melakukan permintaan: Getregistry-uri: dial tcp: timeout i/o |
## ResourceNotFoundException
| Pesan kesalahan lama | Pesan kesalahan baru |
| --- | --- |
| Mengambil data rahasia dari AWS Secrets Manager dalam region region: secret: sercretARN ResourceNotFoundException: Secrets Manager tidak dapat menemukan rahasia yang ditentukan. | ResourceNotFoundException: Tugas tidak dapat mengambil rahasia dengan ARN sercretARN 'dari. AWS Secrets Manager Periksa apakah rahasia ada di Wilayah yang ditentukan. ResourceNotFoundException: Mengambil data rahasia dari AWS Secrets Manager dalam wilayahregion: rahasia: sercretARN ResourceNotFoundException: Secrets Manager tidak dapat menemukan rahasia yang ditentukan. |
## ResourceInitializationError
| Pesan kesalahan lama | Pesan kesalahan baru |
| --- | --- |
| ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: pengambilan sumber daya eksekusi gagal: tidak dapat mengambil autentikasi registri ecr: panggilan layanan telah dicoba ulang 3 kali:: permintaan kirim gagal disebabkan oleh RequestError: Posting "https://api.ecr.us-east-1.amazonaws.com/”: dial tcp:: batas waktu. i/o Silakan periksa konfigurasi jaringan tugas Anda. | ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: Tugas tidak dapat menarik autentikasi registri dari Amazon ECR: Ada masalah koneksi antara tugas dan Amazon ECR. Periksa konfigurasi jaringan tugas Anda. RequestError: permintaan kirim gagal disebabkan oleh: Posting "https://api.ecr.us-east-1.amazonaws.com“: dial tcp:: batas waktu i/o |
| ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: pengambilan sumber daya eksekusi gagal: tidak dapat mengambil rahasia dari ssm: panggilan layanan telah dicoba ulang 5 kali:: konteks permintaan dibatalkan disebabkan oleh RequestCanceled: batas waktu konteks terlampaui | ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: tidak dapat mengambil rahasia dari ssm: Tugas tidak dapat menarik rahasia. AWS Systems Manager Ada masalah koneksi antara tugas dan AWS Systems Manager Parameter Store. Periksa konfigurasi jaringan tugas Anda. RequestCanceled: konteks permintaan dibatalkan disebabkan oleh: batas waktu konteks terlampaui |
| ResourceInitializationError: gagal mengunduh file env: perintah unduhan file: aliran kesalahan tidak kosong:: konteks permintaan dibatalkan disebabkan oleh RequestCanceled: batas waktu konteks terlampaui | ResourceInitializationError: gagal mengunduh file env: Tugas tidak dapat mengunduh file variabel lingkungan dari Amazon S3. Ada masalah koneksi antara tugas dan Amazon S3. Periksa konfigurasi jaringan tugas Anda. panggilan layanan telah dicoba ulang 5 kali:: konteks permintaan dibatalkan disebabkan oleh RequestCanceled: batas waktu konteks terlampaui |
| ResourceInitializationError: gagal memvalidasi argumen logger: :signal:killed | ResourceInitializationError: gagal memvalidasi argumen logger: Tugas tidak dapat menemukan grup CloudWatch log Amazon yang ditentukan dalam definisi tugas. Ada masalah koneksi antara tugas dan Amazon CloudWatch. Periksa konfigurasi jaringan Anda.: sinyal: mati |
| ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: perintah tarik gagal:: sinyal: terbunuh | ResourceInitializationError: tidak dapat menarik rahasia atau autentikasi registri: Periksa konfigurasi jaringan tugas Anda.: sinyal: mati |
# Melihat Amazon ECS menghentikan kesalahan tugas
Jika Anda kesulitan memulai tugas, tugas Anda mungkin berhenti karena kesalahan aplikasi atau konfigurasi. Contohnya, Anda menjalankan tugas dan tugas menampilkan status `PENDING` dan kemudian menghilang.
Jika tugas Anda dibuat oleh layanan Amazon ECS, tindakan yang dilakukan Amazon ECS untuk mempertahankan layanan dipublikasikan dalam acara layanan. Anda dapat melihat peristiwa di Konsol Manajemen AWS, AWS CLI AWS SDKs, Amazon ECS API, atau alat yang menggunakan SDKs dan API. Peristiwa ini termasuk Amazon ECS menghentikan dan menggantikan tugas karena kontainer dalam tugas telah berhenti berjalan, atau telah gagal terlalu banyak pemeriksaan kesehatan dari Elastic Load Balancing.
Jika tugas Anda berjalan pada instance container di Amazon EC2 atau komputer eksternal, Anda juga dapat melihat log runtime container dan Amazon ECS Agent. Log ini ada di host Amazon EC2 instans atau komputer eksternal. Untuk informasi selengkapnya, lihat [Melihat log agen kontainer Amazon ECS](logs.md).
## Prosedur
------
#### [ Console ]
**Konsol Manajemen AWS**
Langkah-langkah berikut dapat digunakan untuk memeriksa tugas yang dihentikan untuk kesalahan menggunakan konsol. Untuk melihat tugas yang dihentikan, Anda harus mengubah opsi filter.
Tugas yang dihentikan hanya muncul di konsol selama 1 jam.
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Pada halaman **Clusters**, pilih cluster.
1. Pada *name* halaman **Cluster:**, pilih tab **Tugas**.
1. Konfigurasikan filter untuk menampilkan tugas yang dihentikan. Untuk **Filter status yang diinginkan**, pilih **Berhenti**.
Opsi **Berhenti** menampilkan tugas yang dihentikan dan **Status apa pun yang diinginkan** menampilkan semua tugas Anda.
1. Pilih tugas yang dihentikan untuk diperiksa.
1. Di baris untuk tugas yang dihentikan, di kolom **Status Terakhir**, pilih **Berhenti**.
Jendela pop-up menampilkan alasan berhenti.
------
#### [ AWS CLI ]
1. Daftar tugas yang berhenti dalam sebuah klaster. Output berisi Amazon Resource Name (ARN) dari tugas, yang Anda butuhkan untuk menjelaskan tugas tersebut.
```
aws ecs list-tasks \
--cluster cluster_name \
--desired-status STOPPED \
--region region
```
1. Jelaskan tugas yang dihentikan untuk mengambil informasi. *Untuk informasi selengkapnya, lihat [mendeskripsikan tugas di Referensi](https://docs.aws.amazon.com/cli/latest/reference/ecs/describe-tasks.html). AWS Command Line Interface *
```
aws ecs describe-tasks \
--cluster cluster_name \
--tasks arn:aws:ecs:region:account_id:task/cluster_name/task_ID \
--region region
```
Gunakan parameter output berikut.
+ `stopCode`- Kode berhenti menunjukkan mengapa tugas dihentikan, misalnya ResourceInitializationError
+ `StoppedReason`- Alasan tugas berhenti.
+ `reason`(dalam `containers` struktur) - Alasannya memberikan rincian tambahan tentang wadah yang dihentikan.
------
## Langkah selanjutnya
Lihat tugas yang dihentikan sehingga Anda bisa mendapatkan informasi tentang penyebabnya. Untuk informasi selengkapnya, lihat [Amazon ECS menghentikan pesan kesalahan tugas](stopped-task-error-codes.md).
# Amazon ECS menghentikan pesan kesalahan tugas
Berikut ini adalah kemungkinan pesan kesalahan yang mungkin Anda terima ketika tugas Anda berhenti secara tak terduga.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
**Tip**
Anda dapat menggunakan asisten AI [Server MCP Amazon ECS](ecs-mcp-introduction.md) with untuk menganalisis kegagalan tugas dan log kontainer menggunakan bahasa alami.
Kode kesalahan tugas yang dihentikan memiliki kategori yang terkait dengannya, misalnya "ResourceInitializationError”. Untuk mendapatkan informasi lebih lanjut tentang setiap kategori, lihat berikut ini:
| Kategori | Pelajari selengkapnya |
| --- | --- |
| TaskFailedToStart | [Memecahkan masalah kesalahan Amazon ECS TaskFailedToStart](failed-to-start-error.md) |
| ResourceInitializationError | [Memecahkan masalah kesalahan Amazon ECS ResourceInitializationError](resource-initialization-error.md) |
| ResourceNotFoundException | [Memecahkan masalah kesalahan Amazon ECS ResourceNotFoundException](resource-not-found-error.md) |
| SpotInterruptionError | [Memecahkan masalah kesalahan Amazon ECS SpotInterruption](spot-interruption-errors.md) |
| InternalError | [Memecahkan masalah kesalahan Amazon ECS InternalError](internal-error.md) |
| OutOfMemoryError | [Memecahkan masalah kesalahan Amazon ECS OutOfMemoryError](out-of-memory.md) |
| ContainerRuntimeError | [Memecahkan masalah kesalahan Amazon ECS ContainerRuntimeError](container-runtime-error.md) |
| ContainerRuntimeTimeoutError | [Memecahkan masalah kesalahan Amazon ECS ContainerRuntimeTimeoutError](container-runtime-timeout-error.md) |
| CannotStartContainerError | [Memecahkan masalah kesalahan Amazon ECS CannotStartContainerError](cannot-start-container.md) |
| CannotStopContainerError | [Memecahkan masalah kesalahan Amazon ECS CannotStopContainerError](cannot-stop-container.md) |
| CannotInspectContainerError | [Memecahkan masalah kesalahan Amazon ECS CannotInspectContainerError](cannot-inspect-container.md) |
| CannotCreateVolumeError | [Memecahkan masalah kesalahan Amazon ECS CannotCreateVolumeError](cannot-create-volume.md) |
| CannotPullContainer | [CannotPullContainer kesalahan tugas di Amazon ECS](task_cannot_pull_image.md) |
# Memecahkan masalah kesalahan Amazon ECS TaskFailedToStart
Berikut ini adalah beberapa pesan `TaskFailedToStart` kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## Kesalahan EC2 yang tidak terduga saat mencoba Membuat Antarmuka Jaringan dengan penetapan IP publik diaktifkan di subnet '*subnet-id*
Ini terjadi ketika tugas Fargate yang menggunakan mode `awsvpc` jaringan dan berjalan di subnet dengan alamat IP publik, dan subnet tidak memiliki alamat IP yang cukup.
Jumlah alamat IP yang tersedia tersedia di halaman detail subnet di konsol Amazon EC2, atau dengan menggunakan. `[describe-subnets](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-subnets.html)` Untuk informasi selengkapnya, lihat [Melihat subnet Anda](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#view-subnet) di Panduan *Pengguna Amazon VPC*.
Untuk memperbaiki masalah ini, Anda dapat membuat subnet baru untuk menjalankan tugas Anda.
## InternalError: **
Kesalahan ini terjadi ketika lampiran ENI diminta. Amazon EC2 menangani penyediaan ENI secara asinkron. Proses penyediaan membutuhkan waktu. Amazon ECS memiliki batas waktu jika ada waktu tunggu yang lama atau kegagalan yang tidak dilaporkan. Ada kalanya ENI disediakan, tetapi laporan tersebut datang ke Amazon ECS setelah batas waktu kegagalan. Dalam kasus ini, Amazon ECS melihat kegagalan tugas yang dilaporkan dengan ENI yang sedang digunakan.
## Definisi tugas yang dipilih tidak kompatibel dengan strategi komputasi yang dipilih
Kesalahan ini terjadi ketika Anda memilih definisi tugas dengan tipe peluncuran yang tidak cocok dengan tipe kapasitas cluster. Anda harus memilih definisi tugas yang cocok dengan penyedia kapasitas yang ditetapkan ke klaster Anda.
## Tidak dapat melampirkan antarmuka jaringan ke indeks perangkat yang tidak digunakan
Kesalahan ini terjadi ketika Ketika menggunakan jenis `awsvpc` jaringan dan tidak ada cukup CPU/memory untuk tugas. Pertama, periksa CPU untuk instance. Untuk informasi selengkapnya, lihat [spesifikasi jenis instans Amazon EC2 di jenis instans](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-instance-type-specifications.html) *Amazon EC2*. Ambil nilai CPU untuk instance dan kalikan dengan jumlah ENIs untuk instance. Gunakan nilai itu e dalam definisi tugas.
## AGEN
Instans kontainer tempat Anda mencoba untuk meluncurkan tugas memiliki agen yang saat ini terputus. Untuk mencegah waktu tunggu diperpanjang untuk penempatan tugas, permintaan ditolak.
Untuk informasi tentang cara memecahkan masalah agen yang terputus, lihat [Bagaimana cara memecahkan masalah agen Amazon ECS yang terputus](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
# Memecahkan masalah kesalahan Amazon ECS ResourceInitializationError
Berikut ini adalah beberapa pesan `ResourceInitialization` kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
**Topics**
+ [Tugas tidak dapat menarik otentikasi registri dari Amazon ECR. Ada masalah koneksi antara tugas dan Amazon ECR. Periksa konfigurasi jaringan tugas Anda.](#unable-to-pull-secrets-ecr)
+ [Tugas tidak dapat mengunduh file variabel lingkungan dari Amazon S3. Ada masalah koneksi antara tugas dan Amazon S3. Periksa konfigurasi jaringan tugas Anda.](#failed-to-download-env-files)
+ [Tugas tidak dapat menarik rahasia dari AWS Systems Manager Parameter Store. Periksa koneksi jaringan Anda antara tugas dan AWS Systems Manager.](#unable-to-pull-secrets-sys-manager)
+ [Tugas tidak dapat menarik rahasia dari AWS Secrets Manager. Ada masalah koneksi antara tugas dan Secrets Manager. Periksa konfigurasi jaringan tugas Anda.](#unable-to-pull-secrets-asm-no-arn)
+ [Tugas tidak dapat menarik rahasia dari Secrets Manager. Tugas tidak dapat mengambil rahasia dengan ARN *secretARN* '' dari Secrets Manager. Periksa apakah rahasia ada di Wilayah yang ditentukan.](#unable-to-pull-secrets-asm)
+ [perintah tarik gagal: tidak dapat menarik rahasia atau autentikasi registri Periksa konfigurasi jaringan tugas Anda.](#pull-command-failed)
+ [Tugas tidak dapat menemukan grup CloudWatch log Amazon yang ditentukan dalam definisi tugas. Ada masalah koneksi antara tugas dan Amazon CloudWatch. Periksa konfigurasi jaringan Anda.](#failed-to-initialize-logging-network)
+ [gagal menginisialisasi driver logging](#failed-to-initialize-logging)
+ [gagal memanggil perintah EFS utils untuk menyiapkan volume EFS](#efs-utils-failed)
## Tugas tidak dapat menarik otentikasi registri dari Amazon ECR. Ada masalah koneksi antara tugas dan Amazon ECR. Periksa konfigurasi jaringan tugas Anda.
Kesalahan ini menunjukkan bahwa tugas tidak dapat terhubung ke Amazon ECR.
Periksa koneksi antara tugas dan Amazon ECR. Untuk informasi, lihat [Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat mengunduh file variabel lingkungan dari Amazon S3. Ada masalah koneksi antara tugas dan Amazon S3. Periksa konfigurasi jaringan tugas Anda.
Kesalahan ini terjadi ketika tugas Anda tidak dapat mengunduh file lingkungan Anda dari Amazon S3.
Periksa koneksi antara tugas dan titik akhir VPC Amazon S3. Untuk informasi, lihat [Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat menarik rahasia dari AWS Systems Manager Parameter Store. Periksa koneksi jaringan Anda antara tugas dan AWS Systems Manager.
Kesalahan ini terjadi ketika tugas Anda tidak dapat menarik gambar yang ditentukan dalam definisi tugas menggunakan kredensi di Systems Manager.
Periksa koneksi antara tugas dan titik akhir VPC Systems Manager. Untuk informasi, lihat [Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat menarik rahasia dari AWS Secrets Manager. Ada masalah koneksi antara tugas dan Secrets Manager. Periksa konfigurasi jaringan tugas Anda.
Kesalahan ini terjadi ketika tugas Anda tidak dapat menarik gambar yang ditentukan dalam definisi tugas menggunakan kredensil di Secrets Manager.
Kesalahan menunjukkan bahwa ada masalah konektivitas jaringan antara titik akhir VPC Systems Manager dan tugas.
Untuk informasi tentang cara memverifikasi konektivitas antara tugas dan titik akhir, lihat[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat menarik rahasia dari Secrets Manager. Tugas tidak dapat mengambil rahasia dengan ARN *secretARN* '' dari Secrets Manager. Periksa apakah rahasia ada di Wilayah yang ditentukan.
Kesalahan ini terjadi ketika tugas Anda tidak dapat menarik gambar yang ditentukan dalam definisi tugas menggunakan kredensil di Secrets Manager.
Masalah ini disebabkan oleh salah satu alasan berikut:
| Penyebab kesalahan.. | Lakukan ini... |
| --- | --- |
| Masalah konektivitas jaringan antara titik akhir VPC Secrets Manager dan tugas. Masalahnya adalah masalah jaringan ketika Anda melihat salah satu string berikut dalam pesan kesalahan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/resource-initialization-error.html) | Verifikasi konektivitas antara tugas dan titik akhir Secrets Manager. Untuk informasi selengkapnya, lihat [Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md). |
| Peran eksekusi tugas yang ditentukan dalam definisi tugas tidak memiliki izin untuk Secrets Manager. | Tambahkan izin yang diperlukan untuk Secrets Manager ke peran eksekusi tugas. Untuk informasi selengkapnya, lihat [Izin Secrets Manager atau Systems Manager](task_execution_IAM_role.md#task-execution-secrets). |
| Rahasia ARN tidak ada | Periksa apakah ARN ada di Secrets Manager. Untuk informasi tentang melihat gambar Anda, lihat [Menemukan rahasia di Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_search-secret.html) di Panduan Pengembang Secrets Manager. |
## perintah tarik gagal: tidak dapat menarik rahasia atau autentikasi registri Periksa konfigurasi jaringan tugas Anda.
Kesalahan ini terjadi ketika tugas Anda tidak dapat terhubung ke Amazon ECR, Systems Manager, atau Secrets Manager. Ini karena kesalahan konfigurasi di jaringan Anda.
Untuk memperbaiki masalah ini, verifikasi keterkaitan antara tugas dan Amazon ECR. Anda juga perlu memeriksa konektivitas antara tugas Anda dan layanan yang menyimpan rahasia Anda (Systems Manager, atau Secrets Manager). Untuk informasi selengkapnya, lihat [Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat menemukan grup CloudWatch log Amazon yang ditentukan dalam definisi tugas. Ada masalah koneksi antara tugas dan Amazon CloudWatch. Periksa konfigurasi jaringan Anda.
Kesalahan ini terjadi ketika tugas Anda gagal menemukan grup CloudWatch log yang Anda tentukan dalam definisi tugas.
Kesalahan menunjukkan bahwa ada masalah konektivitas jaringan antara titik akhir CloudWatch VPC dan tugas.
Untuk informasi tentang cara memverifikasi konektivitas antara tugas dan titik akhir, lihat[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## gagal menginisialisasi driver logging
Kesalahan ini terjadi ketika tugas Anda gagal menemukan grup CloudWatch log yang Anda tentukan dalam definisi tugas.
Kesalahan menunjukkan bahwa CloudWatch grup dalam definisi tugas tidak ada.
Gunakan langkah-langkah berikut untuk menemukan yang hilang CloudWatch.
1. Jalankan perintah berikut untuk mendapatkan informasi definisi tugas.
```
aws ecs describe-task-definition \
--task-definition task-def-name
```
Lihatlah output untuk setiap kontainer dan perhatikan `awslogs-group` nilainya.
```
"logConfiguration": {
"logDriver": "awslogs",
"options": {
"awslogs-group": "/ecs/example-group",
"awslogs-create-group": "true",
"awslogs-region": "us-east-1",
"awslogs-stream-prefix": "ecs"
},
```
1. Verifikasi bahwa grup tersebut tersedia CloudWatch untuk informasi selengkapnya, lihat [Bekerja dengan grup log dan aliran log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) di *Panduan Pengguna CloudWatch Log Amazon*.
Masalahnya adalah grup yang ditentukan dalam definisi tugas salah, atau grup log tidak ada.
1. Perbaiki masalah.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/resource-initialization-error.html)
## gagal memanggil perintah EFS utils untuk menyiapkan volume EFS
Masalah berikut mungkin mencegah Anda memasang volume Amazon EFS pada permintaan Anda:
+ Sistem file Amazon EFS tidak dikonfigurasi dengan benar.
+ Tugas tidak memiliki izin yang diperlukan.
+ Ada masalah yang terkait dengan konfigurasi jaringan dan VPC.
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat [Mengapa saya tidak dapat memasang volume Amazon EFS saya pada AWS Fargate tugas saya di](https://repost.aws/knowledge-center/fargate-unable-to-mount-efs) AWS re:post.
# Memecahkan masalah kesalahan Amazon ECS ResourceNotFoundException
Berikut ini adalah beberapa pesan ` ResourceNotFoundException` kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## Tugas tidak dapat mengambil rahasia dengan ARN *sercretARN* 'dari. AWS Secrets Manager Periksa apakah rahasia ada di Wilayah yang ditentukan.
Kesalahan ini terjadi ketika tugas tidak dapat mengambil rahasia dari Secrets Manager. Ini berarti bahwa rahasia yang ditentukan dalam definisi tugas (dan terkandung dalam pesan kesalahan) tidak ada di Secrets Manager.
Wilayah ada dalam pesan kesalahan.
Mengambil data rahasia dari AWS Secrets Manager dalam region*region*: secret: *sercretARN* ResourceNotFoundException: Secrets Manager tidak dapat menemukan rahasia yang ditentukan.
Untuk informasi tentang menemukan rahasia, lihat [Menemukan rahasia AWS Secrets Manager di](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_search-secret.html) *Panduan AWS Secrets Manager Pengguna*.
Gunakan tabel berikut untuk menentukan dan mengatasi kesalahan.
| Isu | Tindakan |
| --- | --- |
| Rahasianya ada di Wilayah yang berbeda dari definisi tugas. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/resource-not-found-error.html) |
| Definisi tugas memiliki ARN rahasia yang salah. Rahasia yang benar ada di Secrets Manager. | Perbarui definisi tugas dengan rahasia yang benar. Untuk informasi selengkapnya, lihat [Memperbarui definisi tugas Amazon ECS menggunakan konsol](update-task-definition-console-v2.md) atau [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html)di Referensi API Amazon Elastic Container Service. |
| Rahasianya sudah tidak ada lagi. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/resource-not-found-error.html) |
# Memecahkan masalah kesalahan Amazon ECS SpotInterruption
`SpotInterruption`Kesalahan memiliki alasan berbeda untuk Fargate dan. EC2s
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## Fargate
`SpotInterruption`Kesalahan terjadi ketika tidak ada kapasitas Fargate Spot atau ketika Fargate mengambil kembali kapasitas Spot.
Anda dapat menjalankan tugas di beberapa Availability Zone untuk memungkinkan kapasitas yang lebih besar.
## EC2
Kesalahan ini terjadi ketika tidak ada Instans Spot yang tersedia atau EC2 mengambil kembali kapasitas Instans Spot.
Anda dapat menjalankan instans di beberapa Availability Zone untuk memungkinkan kapasitas yang lebih besar.
# Memecahkan masalah kesalahan Amazon ECS InternalError
**Berlaku untuk**: Fargate
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
`InternalError`Kesalahan saat agen menemukan kesalahan internal yang tidak terduga dan tidak terkait runtime.
Kesalahan ini hanya terjadi jika menggunakan versi platform `1.4` atau yang lebih baru.
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat[Amazon ECS menghentikan pesan kesalahan tugas](stopped-task-error-codes.md).
# Memecahkan masalah kesalahan Amazon ECS OutOfMemoryError
Berikut ini adalah beberapa pesan OutOfMemoryError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## kontainer mati karena penggunaan memori
Kesalahan ini terjadi ketika wadah keluar karena proses dalam wadah menghabiskan lebih banyak memori daripada yang dialokasikan dalam definisi tugas, atau karena kendala host atau sistem operasi.
# Memecahkan masalah kesalahan Amazon ECS ContainerRuntimeError
Berikut ini adalah beberapa pesan ContainerRuntimeError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## ContainerRuntimeError
Kesalahan ini terjadi ketika agen menerima kesalahan tak terduga dari `containerd` untuk operasi khusus runtime. Kesalahan ini biasanya disebabkan oleh kegagalan internal pada agen atau `containerd` runtime.
Kesalahan ini hanya terjadi jika Anda menggunakan versi platform `1.4.0` atau yang lebih baru (Linux) `1.0.0` atau yang lebih baru (Windows).
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat [Mengapa tugas Amazon ECS saya Dihentikan](https://repost.aws/knowledge-center/ecs-task-stopped) di AWS re:Post.
# Memecahkan masalah kesalahan Amazon ECS ContainerRuntimeTimeoutError
Berikut ini adalah beberapa pesan ContainerRuntimeTimeoutError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## Tidak dapat beralih ke berjalan; habis waktu setelah menunggu 1m atau kesalahan batas waktu Docker
Kesalahan ini terjadi ketika sebuah kontainer tidak dapat melakukan transisi ke `RUNNING` atau kondisi `STOPPED` dalam periode timeout. Alasan dan nilai timeout yang disediakan dalam kesalahan pesan.
# Memecahkan masalah kesalahan Amazon ECS CannotStartContainerError
Berikut ini adalah beberapa pesan CannotStartContainerError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## gagal mendapatkan status kontainer: **
Kesalahan ini terjadi ketika kontainer tidak dapat dimulai.
Jika kontainer Anda mencoba untuk melebihi memori yang ditentukan di sini, kontainer akan dihentikan. Tingkatkan memori yang disajikan ke wadah. Ini adalah `memory` parameter dalam definisi tugas. Untuk informasi selengkapnya, lihat [Memori](task_definition_parameters.md#container_definition_memory).
# Memecahkan masalah kesalahan Amazon ECS CannotStopContainerError
Berikut ini adalah beberapa pesan CannotStopContainerError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## CannotStopContainerError
Kesalahan ini terjadi ketika wadah tidak dapat dihentikan.
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat [Mengapa tugas Amazon ECS saya Dihentikan](https://repost.aws/knowledge-center/ecs-task-stopped) di AWS re:Post.
# Memecahkan masalah kesalahan Amazon ECS CannotInspectContainerError
Berikut ini adalah beberapa pesan CannotInspectContainerError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## CannotInspectContainerError
Kesalahan ini terjadi ketika agen kontainer tidak dapat menjelaskan kontainer melalui waktu aktif kontainer.
Saat menggunakan versi platform `1.3` atau sebelumnya, agen Amazon ECS mengembalikan alasan dari Docker.
Saat menggunakan versi platform `1.4.0` atau yang lebih baru (Linux) `1.0.0` atau atau yang lebih baru (Windows), agen Fargate mengembalikan alasannya. `containerd`
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat [Mengapa tugas Amazon ECS saya Dihentikan](https://repost.aws/knowledge-center/ecs-task-stopped) di AWS re:Post.
# Memecahkan masalah kesalahan Amazon ECS CannotCreateVolumeError
Berikut ini adalah beberapa pesan CannotCreateVolumeError kesalahan dan tindakan yang dapat Anda ambil untuk memperbaiki kesalahan.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
## CannotCreateVolumeError
Kesalahan ini terjadi ketika agen tidak dapat membuat volume pemasangan yang ditentukan dalam ketentuan tugas.
Kesalahan ini hanya terjadi jika Anda menggunakan versi platform `1.4.0` atau yang lebih baru (Linux) `1.0.0` atau yang lebih baru (Windows).
Untuk informasi tentang cara men-debug dan memperbaiki masalah ini, lihat [Mengapa tugas Amazon ECS saya Dihentikan](https://repost.aws/knowledge-center/ecs-task-stopped) di AWS re:Post.
# CannotPullContainer kesalahan tugas di Amazon ECS
Kesalahan berikut menunjukkan bahwa tugas gagal dimulai karena Amazon ECS tidak dapat mengambil gambar kontainer yang ditentukan.
**catatan**
Versi platform 1.4 Fargate memotong pesan kesalahan yang panjang.
Untuk memeriksa tugas yang dihentikan untuk pesan kesalahan menggunakan Konsol Manajemen AWS, lihat[Melihat Amazon ECS menghentikan kesalahan tugas](stopped-task-errors.md).
**Tip**
Anda dapat menggunakan asisten AI [Server MCP Amazon ECS](ecs-mcp-introduction.md) with untuk menyelidiki kesalahan penarikan gambar menggunakan bahasa alami.
**Topics**
+ [Tugas tidak dapat menarik gambar. Periksa apakah peran memiliki izin untuk menarik gambar dari registri.](#pull-request-image-not-found)
+ [Tugas tidak dapat menarik '*image-name*' dari repositori Amazon ECR ''. *repository URI* Ada masalah koneksi antara tugas dan Amazon ECR. Periksa konfigurasi jaringan tugas Anda.](#pull-image-io-timeout)
+ [Tugas tidak dapat menarik gambar. Periksa konfigurasi jaringan Anda](#pull-request-image-not-found-network)
+ [CannotPullContainerError: tarik manifes gambar telah dicoba ulang 5 kali: gagal menyelesaikan ref](#pull-request-image-tag)
+ [Kesalahan API (500): Dapatkan https://111122223333.dkr.ecr.us-east-1.amazonaws.com/v2/: net/http: permintaan dibatalkan sambil menunggu koneksi](#request-canceled)
+ [Kesalahan API](#pull-request-api-error)
+ [tulis/var/lib/docker/tmp/*GetImageBlob111111111*: tidak ada ruang tersisa di perangkat](#pull-request-write-error)
+ [ERROR: toomanyrequests: Terlalu Banyak Permintaan atau Anda telah mencapai batas tingkat tarik Anda.](#container-pull-too-many-requests)
+ [Tanggapan kesalahan dari daemon: Dapatkan*url*: net/http: permintaan dibatalkan sambil menunggu koneksi](#container-pull-request-canceled-connection)
+ [ref pull telah dicoba ulang 1 kali: gagal menyalin:: gagal buka httpReaderSeeker: kode status tak terduga](#container-pull-failed-open)
+ [akses tarik ditolak](#container-pull-access-denied.title)
+ [perintah tarik gagal: panik: kesalahan runtime: alamat memori tidak valid atau dereferensi pointer nil](#container-pull-runtime-error.title)
+ [kesalahan menarik gambar conf/error menarik konfigurasi gambar](#container-pull-pulling-image.title)
+ [Konteks dibatalkan](#container-pull-context-canceled)
## Tugas tidak dapat menarik gambar. Periksa apakah peran memiliki izin untuk menarik gambar dari registri.
Kesalahan ini menunjukkan bahwa tugas tidak dapat menarik gambar yang ditentukan dalam definisi tugas karena masalah izin.
Untuk menyelesaikan masalah ini:
1. Periksa apakah gambar ada di*repository*. Untuk informasi tentang melihat gambar Anda, lihat [Melihat detail gambar di Amazon ECR di](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-info.html) *Panduan Pengguna Amazon Elastic Container Registry*.
1. Verifikasi bahwa *role-arn* memiliki izin yang benar untuk menarik gambar.
Untuk informasi tentang cara memperbarui peran, lihat [Memperbarui izin untuk peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html) di *Panduan AWS Identity and Access Management Penggunaan*.
Tugas menggunakan salah satu peran berikut:
+ Untuk tugas dengan Fargate, ini adalah peran eksekusi tugas. Untuk informasi tentang izin tambahan untuk Amazon ECR,. [Tugas Fargate menarik gambar Amazon ECR melalui izin titik akhir antarmuka](task_execution_IAM_role.md#task-execution-ecr-conditionkeys)
+ Untuk tugas dengan EC2, ini adalah peran instance container. Untuk informasi tentang izin tambahan untuk Amazon ECR,. [Izin Amazon ECR](instance_IAM_role.md#container-instance-role-ecr)
## Tugas tidak dapat menarik '*image-name*' dari repositori Amazon ECR ''. *repository URI* Ada masalah koneksi antara tugas dan Amazon ECR. Periksa konfigurasi jaringan tugas Anda.
Kesalahan ini menunjukkan bahwa tugas tidak dapat terhubung ke Amazon ECR. Periksa koneksi ke *repository URI* repositori.
Untuk informasi tentang cara memverifikasi dan menyelesaikan masalah, lihat[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Tugas tidak dapat menarik gambar. Periksa konfigurasi jaringan Anda
Kesalahan ini menunjukkan bahwa tugas tidak dapat terhubung ke Amazon ECR.
Untuk informasi tentang cara memverifikasi dan menyelesaikan masalah, lihat[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## CannotPullContainerError: tarik manifes gambar telah dicoba ulang 5 kali: gagal menyelesaikan ref
Kesalahan ini menunjukkan bahwa tugas tidak dapat menarik gambar.
Untuk mengatasi ini, Anda dapat:
+ Verifikasi bahwa gambar yang ditentukan dalam definisi tugas cocok dengan gambar di repositori.
+ Amazon ECS memaksa stabilitas versi gambar. Jika gambar asli tidak lagi tersedia, Anda mendapatkan kesalahan ini. Tag gambar adalah bagian dari menegakkan perilaku ini. Ubah gambar dalam definisi tugas dari menggunakan:latest sebagai tag ke versi tertentu. Untuk informasi selengkapnya, lihat [Penerjemahan image kontainer](deployment-type-ecs.md#deployment-container-image-stability).
Untuk informasi tentang cara memverifikasi dan menyelesaikan masalah, lihat[Memverifikasi Amazon ECS menghentikan konektivitas tugas](verify-connectivity.md).
## Kesalahan API (500): Dapatkan https://111122223333.dkr.ecr.us-east-1.amazonaws.com/v2/: net/http: permintaan dibatalkan sambil menunggu koneksi
Kesalahan ini menunjukkan bahwa koneksi habis waktu, karena rute ke internet tidak ada.
Untuk mengatasi masalah ini, Anda dapat:
+ Untuk tugas di subnet publik, tentukan **DIAKTIFKAN** untuk **Tetapkan secara otomatis IP publik** saat meluncurkan tugas. Untuk informasi selengkapnya, lihat [Menjalankan aplikasi sebagai tugas Amazon ECS](standalone-task-create.md).
+ Untuk tugas di subnet privat, tentukan **NONAKTIF** untuk **Tetapkan secara otomatis IP publik** saat meluncurkan tugas, dan mengonfigurasi gateway NAT di VPC Anda untuk merutekan permintaan menuju internet. Untuk informasi lebih lanjut, lihat [NAT Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) di *Panduan Pengguna Amazon VPC*.
## Kesalahan API
Kesalahan ini menunjukkan bahwa ada masalah koneksi dengan titik akhir Amazon ECR.
Untuk informasi tentang cara mengatasi masalah ini, [lihat Bagaimana cara mengatasi kesalahan Amazon ECR "CannotPullContainerError: Kesalahan API” di Amazon ECS di situs](https://aws.amazon.com/premiumsupport/knowledge-center/ecs-pull-container-api-error-ecr/) web. Dukungan
## tulis/var/lib/docker/tmp/*GetImageBlob111111111*: tidak ada ruang tersisa di perangkat
Kesalahan ini menunjukkan bahwa ruang disk tidak mencukupi.
Untuk mengatasi masalah ini, kosongkan ruang disk.
Jika Anda menggunakan AMI Amazon ECS yang dioptimalkan, Anda dapat menggunakan perintah berikut untuk mengambil 20 file terbesar di sistem file Anda:
```
du -Sh / | sort -rh | head -20
```
Contoh output:
```
5.7G /var/lib/docker/containers/50501b5f4cbf90b406e0ca60bf4e6d4ec8f773a6c1d2b451ed8e0195418ad0d2
1.2G /var/log/ecs
594M /var/lib/docker/devicemapper/mnt/c8e3010e36ce4c089bf286a623699f5233097ca126ebd5a700af023a5127633d/rootfs/data/logs
...
```
Dalam beberapa kasus, volume root mungkin diisi oleh wadah yang sedang berjalan. Jika kontainer menggunakan driver log `json-file` default tanpa batas `max-size`, terdapat kemungkinan bahwa berkas log bertanggung jawab pada sebagian besar ruang yang digunakan. Anda dapat menggunakan perintah `docker ps` untuk memverifikasi kontainer yang menggunakan ruang dengan pemetaan nama direktori dari output di atas untuk ID kontainer. Sebagai contoh:
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
50501b5f4cbf amazon/amazon-ecs-agent:latest "/agent" 4 days ago Up 4 days ecs-agent
```
Secara default, saat menggunakan driver log `json-file`, Docker menangkap output standar (dan kesalahan standar) dari semua kontainer Anda dan menulis output standar dan kesalahan dalam file menggunakan format JSON. Anda dapat mengatur `max-size` sebagai pilihan pengandar catatan, yang dapat mencegah berkas log mengambil terlalu banyak ruang. Untuk informasi selengkapnya, lihat [Driver logging file JSON](https://docs.docker.com/engine/logging/drivers/json-file/) di dokumentasi Docker.
Berikut ini adalah cuplikan ketentuan kontainer yang menunjukkan bagaimana menggunakan pilihan ini:
```
{
"log-driver": "json-file",
"log-opts": {
"max-size": "256m"
}
}
```
Alternatifnya, jika log kontainer Anda menghabiskan terlalu banyak ruang disk, adalah dengan menggunakan driver `awslogs` log. Driver `awslogs` log mengirimkan log ke CloudWatch, yang membebaskan ruang disk yang seharusnya digunakan untuk log kontainer Anda pada instance kontainer. Untuk informasi selengkapnya, lihat [Kirim log Amazon ECS ke CloudWatch](using_awslogs.md).
Anda mungkin perlu memperbarui ukuran disk yang dapat diakses Docker.
Untuk informasi selengkapnya, lihat [CannotPullContainerError: tidak ada ruang tersisa di perangkat](https://repost.aws/questions/QUx6Ix1R1SSNisYSs1Sw8EBA/cannotpullcontainererror-no-space-left-on-device).
## ERROR: toomanyrequests: Terlalu Banyak Permintaan atau Anda telah mencapai batas tingkat tarik Anda.
Kesalahan ini menunjukkan bahwa ada pembatasan laju Docker Hub.
Jika Anda menerima salah satu kesalahan berikut, kemungkinan Anda mencapai tingkat batasan Docker Hub:
Untuk informasi selengkapnya tentang tingkat batasan Docker Hub, lihat [Memahami pembatasan pada tingkat Docker Hub](https://www.docker.com/increase-rate-limits).
Jika Anda telah meningkatkan batas laju Docker Hub dan Anda perlu mengautentikasi tarikan Docker untuk instance container Anda, lihat Autentikasi [registri pribadi](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/private-auth-container-instances.html) untuk instance kontainer.
## Tanggapan kesalahan dari daemon: Dapatkan*url*: net/http: permintaan dibatalkan sambil menunggu koneksi
Kesalahan ini menunjukkan bahwa koneksi habis waktu, karena rute ke internet tidak ada.
Untuk mengatasi masalah ini, Anda dapat:
+ Untuk tugas di subnet publik, tentukan **DIAKTIFKAN** untuk **Tetapkan secara otomatis IP publik** saat meluncurkan tugas. Untuk informasi selengkapnya, lihat [Menjalankan aplikasi sebagai tugas Amazon ECS](standalone-task-create.md).
+ Untuk tugas di subnet privat, tentukan **NONAKTIF** untuk **Tetapkan secara otomatis IP publik** saat meluncurkan tugas, dan mengonfigurasi gateway NAT di VPC Anda untuk merutekan permintaan menuju internet. Untuk informasi lebih lanjut, lihat [NAT Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) di *Panduan Pengguna Amazon VPC*.
## ref pull telah dicoba ulang 1 kali: gagal menyalin:: gagal buka httpReaderSeeker: kode status tak terduga
Kesalahan ini menunjukkan bahwa ada kegagalan saat menyalin gambar.
Untuk mengatasi masalah ini, tinjau salah satu artikel berikut:
+ Untuk tugas Fargate, lihat [Bagaimana cara mengatasi kesalahan “cannotpullcontainererror” untuk tugas Amazon ECS saya](https://aws.amazon.com/premiumsupport/knowledge-center/ecs-fargate-pull-container-error/) di Fargate.
+ Untuk tugas lain, lihat [Bagaimana cara mengatasi kesalahan “cannotpullcontainererror” untuk](https://aws.amazon.com/premiumsupport/knowledge-center/ecs-pull-container-error/) tugas Amazon ECS saya.
## akses tarik ditolak
Kesalahan ini menunjukkan bahwa tidak ada akses ke gambar.
Untuk mengatasi masalah ini, Anda mungkin perlu mengautentikasi klien Docker Anda dengan Amazon ECR Untuk informasi selengkapnya, lihat [Autentikasi registri pribadi di Panduan Pengguna](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html) *Amazon* ECR.
## perintah tarik gagal: panik: kesalahan runtime: alamat memori tidak valid atau dereferensi pointer nil
Kesalahan ini menunjukkan bahwa tidak ada akses ke gambar karena alamat memori yang tidak valid atau dereferensi pointer nil.
Untuk menyelesaikan masalah ini:
+ Periksa apakah Anda memiliki aturan grup keamanan untuk mencapai Amazon S3.
+ Saat Anda menggunakan titik akhir gateway, Anda harus menambahkan rute di tabel rute untuk mengakses titik akhir.
## kesalahan menarik gambar conf/error menarik konfigurasi gambar
Kesalahan ini menunjukkan batas tarif telah tercapai atau ada kesalahan jaringan:
Untuk mengatasi masalah ini, [lihat Bagaimana cara mengatasi kesalahan "CannotPullContainerError" di Tugas Jenis Peluncuran Amazon ECS EC2 saya](https://repost.aws/knowledge-center/ecs-pull-container-error).
## Konteks dibatalkan
Kesalahan ini menunjukkan bahwa konteksnya dibatalkan.
Penyebab umum kesalahan ini adalah karena VPC yang digunakan tugas Anda tidak memiliki rute untuk menarik gambar penampung dari Amazon ECR.
# Memverifikasi Amazon ECS menghentikan konektivitas tugas
Ada kalanya tugas berhenti karena masalah konektivitas jaringan. Ini mungkin masalah intermiten, tetapi kemungkinan besar disebabkan karena tugas tidak dapat terhubung ke titik akhir.
## Menguji konektivitas tugas
Anda dapat menggunakan `AWSSupport-TroubleshootECSTaskFailedToStart` runbook untuk menguji konektivitas tugas. Saat Anda menggunakan runbook, Anda memerlukan informasi sumber daya berikut:
+ ID tugas
Gunakan ID tugas gagal terbaru.
+ Cluster tempat tugas itu berada
Untuk informasi tentang cara menggunakan runbook, lihat [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-aws-troubleshootecstaskfailedtostart.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-aws-troubleshootecstaskfailedtostart.html)di referensi *Runbook AWS Systems Manager otomatisasi*.
Runbook menganalisis tugas. Anda dapat melihat hasilnya di bagian **Output** untuk masalah berikut yang dapat mencegah tugas dimulai:
+ Konektivitas jaringan ke registri kontainer yang dikonfigurasi
+ Konektivitas titik akhir VPC
+ Konfigurasi aturan grup keamanan
## Memperbaiki masalah titik akhir VPC
Saat hasil `AWSSupport-TroubleshootECSTaskFailedToStart` runbook menunjukkan masalah titik akhir VPC, periksa konfigurasi berikut:
+ VPC tempat Anda membuat titik akhir dan titik akhir VPC harus menggunakan DNS Pribadi.
+ Pastikan Anda memiliki AWS PrivateLink titik akhir untuk layanan yang tugas tidak dapat terhubung ke dalam VPC yang sama dengan tugas. Untuk informasi lebih lanjut, lihat salah satu dari berikut ini:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/verify-connectivity.html)
+ Konfigurasikan aturan keluar untuk subnet tugas yang memungkinkan HTTPS pada port 443 DNS (TCP) lalu lintas. Untuk informasi selengkapnya, lihat [Mengonfigurasi aturan grup keamanan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/changing-security-group.html#add-remove-security-group-rules) di *Panduan Pengguna Amazon Elastic Compute Cloud*.
+ Jika Anda menggunakan server domain nama kustom, maka konfirmasikan pengaturan kueri DNS. Kueri harus memiliki akses keluar pada port 53, dan menggunakan protokol UDP dan TCP. Selain itu, ia harus memiliki akses HTTPS pada port 443. Untuk informasi selengkapnya, lihat [Aturan grup keamanan Coonfigure di Panduan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/changing-security-group.html#add-remove-security-group-rules) Pengguna *Amazon Elastic Compute Cloud*.
+ Jika subnet memiliki ACL jaringan, aturan ACL berikut diperlukan:
+ Aturan keluar yang memungkinkan lalu lintas yang memungkinkan lalu lintas di port 1024-65535.
+ Aturan masuk yang memungkinkan lalu lintas TCP pada port 443.
Untuk informasi tentang cara mengonfigurasi aturan, lihat [Mengontrol lalu lintas ke subnet menggunakan jaringan ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) di *Panduan Pengguna Amazon Virtual Private Cloud*.
## Memperbaiki masalah jaringan
Jika hasil `AWSSupport-TroubleshootECSTaskFailedToStart` runbook menunjukkan masalah jaringan, periksa konfigurasi berikut:
### Tugas yang menggunakan mode jaringan awsvpc di subnet publik
Lakukan konfigurasi berikut berdasarkan runbook:
+ Untuk tugas di subnet publik, tentukan **DIAKTIFKAN** untuk **Tetapkan secara otomatis IP publik** saat meluncurkan tugas. Untuk informasi selengkapnya, lihat [Menjalankan aplikasi sebagai tugas Amazon ECS](standalone-task-create.md).
+ Anda memerlukan gateway untuk menangani lalu lintas internet. Tabel rute untuk subnet tugas harus memiliki rute untuk lalu lintas ke gateway.
Untuk informasi selengkapnya, lihat [Menambahkan dan menghapus rute dari tabel rute](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithRouteTables.html#AddRemoveRoutes) di *Panduan Pengguna Amazon Virtual Private Cloud*.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/verify-connectivity.html)
+ Jika subnet tugas memiliki ACL jaringan, aturan ACL berikut diperlukan:
+ Aturan keluar yang memungkinkan lalu lintas di port 1024-65535.
+ Aturan masuk yang memungkinkan lalu lintas TCP pada port 443.
Untuk informasi tentang cara mengonfigurasi aturan, lihat [Mengontrol lalu lintas ke subnet menggunakan jaringan ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) di *Panduan Pengguna Amazon Virtual Private Cloud*.
### Tugas yang menggunakan mode jaringan awsvpc di subnet pribadi
Lakukan konfigurasi berikut berdasarkan runbook:
+ Pilih **DINONAKTIFKAN** untuk **Tetapkan IP publik secara otomatis** saat meluncurkan tugas.
+ Konfigurasikan gateway NAT di VPC Anda untuk merutekan permintaan ke internet. Untuk informasi selengkapnya, [lihat Gateway NAT di Panduan](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) Pengguna *Amazon Virtual Private Cloud*.
+ Tabel rute untuk subnet tugas harus memiliki rute untuk lalu lintas ke gateway NAT.
Untuk informasi selengkapnya, lihat [Menambahkan dan menghapus rute dari tabel rute](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithRouteTables.html#AddRemoveRoutes) di *Panduan Pengguna Amazon Virtual Private Cloud*.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/verify-connectivity.html)
+ Jika subnet tugas memiliki ACL jaringan, aturan ACL berikut diperlukan:
+ Aturan keluar yang memungkinkan lalu lintas di port 1024-65535.
+ Aturan masuk yang memungkinkan lalu lintas TCP pada port 443.
Untuk informasi tentang cara mengonfigurasi aturan, lihat [Mengontrol lalu lintas ke subnet menggunakan jaringan ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) di *Panduan Pengguna Amazon Virtual Private Cloud*.
### Tugas yang tidak menggunakan mode jaringan awsvpc di subnet publik
Lakukan konfigurasi berikut berdasarkan runbook:
+ Pilih **Aktifkan** untuk **Tetapkan IP Otomatis** di bawah Instans **Jaringan untuk Amazon EC2** saat Anda membuat klaster.
Opsi ini memberikan alamat IP publik ke antarmuka jaringan utama instance.
+ Anda memerlukan gateway untuk menangani lalu lintas internet. Tabel rute untuk subnet instance harus memiliki rute untuk lalu lintas ke gateway.
Untuk informasi selengkapnya, lihat [Menambahkan dan menghapus rute dari tabel rute](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithRouteTables.html#AddRemoveRoutes) di *Panduan Pengguna Amazon Virtual Private Cloud*.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/verify-connectivity.html)
+ Jika subnet instance memiliki ACL jaringan, aturan ACL berikut diperlukan:
+ Aturan keluar yang memungkinkan lalu lintas di port 1024-65535.
+ Aturan masuk yang memungkinkan lalu lintas TCP pada port 443.
Untuk informasi tentang cara mengonfigurasi aturan, lihat [Mengontrol lalu lintas ke subnet menggunakan jaringan ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) di *Panduan Pengguna Amazon Virtual Private Cloud*.
### Tugas yang tidak menggunakan mode jaringan awsvpc di subnet pribadi
Lakukan konfigurasi berikut berdasarkan runbook:
+ Pilih **Nonaktifkan** untuk **Tetapkan IP otomatis** di bawah Instans **Jaringan untuk Amazon EC2** saat Anda membuat klaster.
+ Konfigurasikan gateway NAT di VPC Anda untuk merutekan permintaan ke internet. Untuk informasi lebih lanjut, lihat [NAT Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) di *Panduan Pengguna Amazon VPC*.
+ Tabel rute untuk subnet instance harus memiliki rute untuk lalu lintas ke gateway NAT.
Untuk informasi selengkapnya, lihat [Menambahkan dan menghapus rute dari tabel rute](https://docs.aws.amazon.com/vpc/latest/userguide/WorkWithRouteTables.html#AddRemoveRoutes) di *Panduan Pengguna Amazon Virtual Private Cloud*.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/verify-connectivity.html)
+ Jika subnet tugas memiliki ACL jaringan, aturan ACL berikut diperlukan:
+ Aturan keluar yang memungkinkan lalu lintas di port 1024-65535.
+ Aturan masuk yang memungkinkan lalu lintas TCP pada port 443.
Untuk informasi tentang cara mengonfigurasi aturan, lihat [Mengontrol lalu lintas ke subnet menggunakan jaringan ACLs](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) di *Panduan Pengguna Amazon Virtual Private Cloud*.
# Melihat permintaan peran IAM untuk tugas Amazon ECS
Bila Anda menggunakan penyedia untuk kredensi tugas Anda dalam peran IAM, penyedia meminta disimpan dalam log audit. Log audit menerapkan pengaturan rotasi log yang sama sebagai log agen kontainer. variabel konfigurasi agen kontainer `ECS_LOG_ROLLOVER_TYPE`, `ECS_LOG_MAX_FILE_SIZE_MB`, dan `ECS_LOG_MAX_ROLL_COUNT` dapat diatur untuk mempengaruhi perilaku log audit. Untuk informasi selengkapnya, lihat [Parameter konfigurasi log agen kontainer Amazon ECS](ecs-agent-versions.md#agent-logs).
Untuk agen kontainer versi 1.36.0 dan yang lebih baru, log audit terletak di `/var/log/ecs/audit.log`. Ketika log diputar, stempel waktu dalam format `YYYY-MM-DD-HH` ditambahkan ke bagian akhir nama berkas log.
Untuk agen kontainer versi 1.35.0 dan sebelumnya, log audit terletak di `/var/log/ecs/audit.log.YYYY-MM-DD-HH`.
Berikut adalah format untuk entri log:
+ Stempel Waktu
+ Kode tanggapan HTTP
+ Alamat IP dan nomor port asal permintaan
+ URI relatif penyedia kredensial
+ Agen pengguna yang membuat permintaan
+ ARN tugas milik kontainer yang meminta
+ Nama dan nomor versi API `GetCredentials`
+ Nama cluster Amazon ECS tempat instance container terdaftar
+ ARN instans kontainer
Anda dapat menggunakan perintah berikut untuk melihat file log.
```
cat /var/log/ecs/audit.log.2016-07-13-16
```
Output:
```
2016-07-13T16:11:53Z 200 172.17.0.5:52444 "/v1/credentials" "python-requests/2.7.0 CPython/2.7.6 Linux/4.4.14-24.50.amzn1.x86_64" TASK_ARN GetCredentials 1 CLUSTER_NAME CONTAINER_INSTANCE_ARN
```
# Melihat pesan acara layanan Amazon ECS
Saat memecahkan masalah dengan layanan, tempat pertama yang harus Anda periksa untuk informasi diagnostik adalah log peristiwa layanan. Anda dapat melihat peristiwa layanan menggunakan `DescribeServices` API, file AWS CLI, atau dengan menggunakan Konsol Manajemen AWS.
Saat melihat pesan peristiwa layanan menggunakan Amazon ECS API, hanya peristiwa dari penjadwal layanan yang dikembalikan. Hal Ini termasuk penempatan tugas terbaru dan peristiwa kondisi instans. Namun, konsol Amazon ECS menampilkan peristiwa layanan dari sumber berikut.
+ Penempatan tugas dan peristiwa kondisi instans dari penjadwal layanan Amazon ECS. Peristiwa ini memiliki awalan **layanan *(service-name)***. Untuk memastikan bahwa tampilan acara ini bermanfaat, kami hanya menampilkan acara `100` terbaru. Pesan peristiwa duplikat dihilangkan sampai penyebabnya teratasi, atau enam jam berlalu. Jika penyebabnya tidak teratasi dalam waktu enam jam, Anda akan menerima pesan lain terkait peristiwa layanan untuk penyebab tersebut.
+ Peristiwa Auto Scaling layanan. Peristiwa ini memiliki awalan **Pesan** dan hanya terjadi ketika layanan dikonfigurasi dengan kebijakan penskalaan Application Auto Scaling.
**Tip**
Anda dapat menggunakan asisten AI [Server MCP Amazon ECS](ecs-mcp-introduction.md) with untuk menganalisis peristiwa layanan menggunakan bahasa alami.
Gunakan langkah-langkah berikut untuk melihat pesan peristiwa layanan Anda saat ini.
------
#### [ Console ]
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Pada halaman **Clusters**, pilih cluster.
1. Pilih layanan untuk diperiksa.
1. Pada tab **Acara**, lihat pesan.
------
#### [ AWS CLI ]
Gunakan perintah [jelaskan-layanan](https://docs.aws.amazon.com/cli/latest/reference/ecs/describe-services.html) untuk melihat pesan peristiwa layanan untuk layanan tertentu.
AWS CLI Contoh berikut menjelaskan *service-name* layanan di *default* cluster, yang akan memberikan pesan acara layanan terbaru.
```
aws ecs describe-services \
--cluster default \
--services service-name \
--region us-west-2
```
------
# Pesan peristiwa layanan Amazon ECS
Berikut ini adalah contoh pesan acara layanan yang mungkin Anda lihat di konsol Amazon ECS.
## service (*service-name*) telah mencapai kondisi mapan.
Penjadwal layanan mengirimkan acara `service (service-name) has reached a steady state.` layanan ketika layanan sehat dan pada jumlah tugas yang diinginkan, sehingga mencapai kondisi mapan.
Penjadwal layanan melaporkan status secara berkala, sehingga Anda mungkin menerima pesan ini beberapa kali.
## service (*service-name*) tidak dapat menempatkan tugas karena tidak ada instance kontainer yang memenuhi semua persyaratannya.
Penjadwal layanan mengirimkan pesan peristiwa ini ketika tidak dapat menemukan sumber daya yang tersedia untuk menambahkan tugas lain. Kemungkinan penyebab untuk ini adalah:
Gunakan penyedia kapasitas untuk menskalakan instans EC2 Anda secara otomatis. Untuk informasi selengkapnya, lihat [Penyedia kapasitas Amazon ECS untuk beban kerja EC2](asg-capacity-providers.md).
Jika Anda bermaksud menggunakan penyedia kapasitas, pastikan Anda melewati strategi penyedia kapasitas atau memiliki strategi penyedia kapasitas default yang terkait dengan klaster Anda dan tidak meneruskan jenis peluncuran dan strategi penyedia kapasitas sebagai masukan
Tidak ada instans kontainer yang ditemukan di klaster Anda
Jika tidak ada instance kontainer yang terdaftar di cluster tempat Anda mencoba menjalankan tugas, Anda menerima kesalahan ini. Anda harus menambahkan instans kontainer untuk klaster Anda. Untuk informasi selengkapnya, lihat [Meluncurkan instans penampung Amazon ECS Linux](launch_container_instance.md).
Port tidak cukup
Jika tugas Anda menggunakan pemetaan host port tetap (misalnya, tugas Anda menggunakan port 80 pada host untuk server web), Anda harus memiliki setidaknya satu instans kontainer per tugas, karena hanya satu kontainer yang dapat menggunakan port host tunggal pada satu waktu. Anda harus menambahkan instans kontainer ke klaster milik Anda atau mengurangi jumlah tugas yang diinginkan.
Terlalu banyak port yang terdaftar
Instance pencocokan kontainer terdekat untuk penempatan tugas tidak dapat melebihi batas port cadangan maksimum yang diizinkan sebesar 100 port host per instance kontainer. Menggunakan pemetaan port host dinamis dapat memperbaiki masalah.
Port sudah digunakan
Definisi tugas tugas ini menggunakan port yang sama dalam pemetaan portnya sebagai tugas yang sudah berjalan pada instance kontainer yang dipilih. Pesan acara layanan akan memiliki ID instance kontainer yang dipilih sebagai bagian dari pesan di bawah ini.
```
The closest matching container-instance is already using a port required by your task.
```
Memori tidak cukup
Jika ketentuan tugas Anda menentukan memori sejumlah 1000 MiB, dan masing-masing klaster Anda pada instans kontainer memiliki memori sejumlah 1024 MiB, Anda hanya dapat menjalankan satu salinan tugas ini per instans kontainer. Anda dapat bereksperimen dengan memori yang lebih sedikit pada ketentuan tugas Anda sehingga Anda bisa meluncurkan lebih dari satu tugas per instans kontainer, atau meluncurkan lebih banyak instans kontainer menuju klaster Anda.
Jika Anda mencoba memaksimalkan pemanfaatan sumber daya Anda dengan menyediakan memori sebanyak mungkin untuk jenis instans tertentu, lihat[Memesan memori instans wadah Amazon ECS Linux](memory-management.md).
CPU tidak cukup
Sebuah instans kontainer memiliki 1.024 unit CPU untuk setiap inti CPU. Jika ketentuan tugas Anda menentukan 1.000 unit CPU, dan setiap instans kontainer di klaster Anda memiliki 1.024 unit CPU, Anda hanya dapat menjalankan satu salinan tugas ini per instans kontainer. Anda dapat bereksperimen dengan unit CPU yang lebih sedikit dalam ketentuan tugas Anda sehingga Anda bisa meluncurkan lebih dari satu tugas per instans kontainer, atau meluncurkan lebih banyak instans kontainer menuju klaster Anda.
Poin lampiran ENI yang tersedia tidak cukup
Tugas yang menggunakan mode `awsvpc` jaringan masing-masing menerima elastic network interface (ENI) mereka sendiri, yang dilampirkan ke instance container yang menghostingnya. Instans Amazon EC2 memiliki batasan jumlah instans ENIs yang dapat dilampirkan padanya dan tidak ada instance kontainer di cluster yang memiliki kapasitas ENI yang tersedia.
Batas ENI untuk instans kontainer individu tergantung pada kondisi berikut:
+ Jika Anda **belum** menyertakan untuk Pengaturan akun `awsvpcTrunking`, batas ENI untuk setiap instans kontainer tergantung pada tipe instans. Untuk informasi selengkapnya, lihat [Alamat IP Per Antarmuka Jaringan Per Tipe Instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) dalam *Panduan Pengguna Amazon EC2*.
+ Jika Anda **telah** memilih untuk masuk ke setelan `awsvpcTrunking` akun tetapi Anda **belum** meluncurkan instance container baru menggunakan tipe instans yang didukung setelah memilih, batas ENI untuk setiap instance container masih pada nilai default. Untuk informasi selengkapnya, lihat [Alamat IP Per Antarmuka Jaringan Per Tipe Instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) dalam *Panduan Pengguna Amazon EC2*.
+ Jika Anda **telah** memilih untuk masuk ke setelan `awsvpcTrunking` akun dan Anda **telah** meluncurkan instance container baru menggunakan jenis instans yang didukung setelah memilih, tambahan ENIs akan tersedia. Untuk informasi selengkapnya, lihat [Instans yang didukung untuk peningkatan antarmuka jaringan kontainer Amazon ECS](eni-trunking-supported-instance-types.md).
Untuk informasi lebih lanjut tentang penyertaan pada pengaturan akun `awsvpcTrunking`, lihat [Meningkatkan antarmuka jaringan instans kontainer Amazon ECS Linux](container-instance-eni.md).
Anda dapat menambahkan instans kontainer untuk klaster Anda untuk menyediakan lebih banyak adapter jaringan yang tersedia.
Instans kontainer kehilangan atribut wajib
Beberapa parameter ketentuan tugas memerlukan versi API Docker jarak jauh tertentu untuk diinstal pada instans kontainer. Hal lainnya, seperti opsi pencatatan driver, mengharuskan instans kontainer untuk mendaftarkan pencatatan driver tersebut dengan variabel konfigurasi agen `ECS_AVAILABLE_LOGGING_DRIVERS`. Jika definisi tugas Anda berisi parameter yang memerlukan atribut instance kontainer tertentu, dan Anda tidak memiliki instance kontainer yang tersedia yang dapat memenuhi persyaratan ini, tugas tidak dapat ditempatkan.
Penyebab umum kesalahan ini adalah jika layanan Anda menggunakan tugas yang menggunakan mode `awsvpc` jaringan dan EC2. Cluster yang Anda tentukan tidak memiliki instance kontainer yang terdaftar di subnet yang sama yang ditentukan pada `awsvpcConfiguration` saat layanan dibuat.
Anda dapat menggunakan AWSSupport-TroubleshootECSContainerInstance runbook untuk memecahkan masalah. Runbook meninjau apakah data pengguna untuk instance berisi informasi klaster yang benar, apakah profil instance berisi izin yang diperlukan, dan masalah konfigurasi jaringan. Untuk informasi selengkapnya, lihat [AWSSupport-TroubleshootECSContainerInstance](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-aws-troubleshoot-ecs-container-instance.html)di *Panduan Pengguna referensi buku runbook AWS Systems Manager Otomasi*.
Untuk informasi lebih lanjut tentang atribut yang diperlukan untuk parameter ketentuan tugas tertentu dan variabel konfigurasi agen, lihat [Parameter definisi tugas Amazon ECS untuk Fargate](task_definition_parameters.md) dan [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).
## service (*service-name*) tidak dapat menempatkan tugas karena tidak ada instance kontainer yang memenuhi semua persyaratannya. Instance kontainer yang paling cocok tidak *container-instance-id* memiliki unit CPU yang tersedia.
Instance pencocokan kontainer terdekat untuk penempatan tugas tidak berisi unit CPU yang cukup untuk memenuhi persyaratan dalam definisi tugas. Tinjau persyaratan CPU di kedua parameter ukuran tugas dan ketentuan kontainer dari ketentuan tugas.
## service (*service-name*) tidak dapat menempatkan tugas karena tidak ada instance kontainer yang memenuhi semua persyaratannya. Instance kontainer yang paling cocok *container-instance-id* mengalami kesalahan “AGENT”.
Agen kontainer Amazon ECS pada instance kontainer pencocokan terdekat untuk penempatan tugas terputus. Jika Anda dapat terhubung ke instans kontainer dengan SSH, Anda dapat memeriksa pencatatan agen; untuk informasi lebih lanjut, lihat [Parameter konfigurasi log agen kontainer Amazon ECS](ecs-agent-versions.md#agent-logs). Anda juga harus memverifikasi bahwa agen sedang berjalan pada instans. Jika Anda menggunakan AMI Amazon ECS yang dioptimalkan, Anda dapat mencoba menghentikan dan memulai ulang agen dengan perintah berikut.
+ Untuk Amazon ECS yang dioptimalkan Amazon Linux 2 AMI dan Amazon ECS yang dioptimalkan Amazon Linux 2023 AMI
```
sudo systemctl restart ecs
```
+ Untuk Amazon ECS yang dioptimalkan Amazon Linux AMI
```
sudo stop ecs && sudo start ecs
```
## service (*service-name*) (task*task-id*) (instance*instance-id*) tidak sehat di (elb*elb-name*) karena (alasan Instance telah gagal setidaknya UnhealthyThreshold jumlah pemeriksaan kesehatan secara berurutan.)
Layanan ini terdaftar dengan penyeimbang beban dan pemeriksaan kondisi penyeimbang beban gagal. Pesan tersebut menyertakan ID tugas untuk membantu mengidentifikasi tugas spesifik mana yang gagal dalam pemeriksaan kesehatan. Untuk informasi selengkapnya, lihat [Memecahkan masalah penyeimbang beban layanan di Amazon ECS](troubleshoot-service-load-balancers.md).
## service (*service-name*) tidak dapat secara konsisten memulai tugas dengan sukses.
Layanan ini berisi tugas yang gagal untuk dimulai setelah upaya dilakukan secara berturut-turut. Pada titik ini, penjadwal layanan mulai meningkatkan tambahan waktu antara pengulangan. Anda harus memecahkan masalah mengapa tugas Anda gagal untuk diluncurkan. Untuk informasi selengkapnya, lihat [Logika throttle layanan Amazon ECS](service-throttle-logic.md).
Setelah layanan diperbarui, misalnya dengan ketentuan tugas yang diperbarui, penjadwal layanan melanjutkan perilakunya secara normal.
## operasi service (*service-name*) sedang dibatasi. Akan di coba lagi nanti.
Layanan ini tidak dapat meluncurkan lebih banyak tugas dikarenakan batas throttling API. Setelah penjadwal layanan dapat meluncurkan lebih banyak tugas, maka akan dilanjutkan.
Untuk meminta kenaikan tingkat batas kuota API, buka halaman [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/), masuk jika diperlukan, dan pilih **Buat kasus**. Pilih **Peningkatan kuota layanan**. Lengkapi dan kirimkan formulir ini.
## service (*service-name*) tidak dapat menghentikan atau memulai tugas selama penerapan karena konfigurasi penerapan layanan. Perbarui nilai minimumHealthyPercent atau MaximumPercent dan coba lagi.
Tugas pada layanan ini tidak dapat dihentikan atau dimulai saat layanan deployment dikarenakan konfigurasi pada deployment. Konfigurasi penyebaran terdiri dari `minimumHealthyPercent` dan `maximumPercent` nilai-nilai, yang didefinisikan ketika layanan dibuat. Nilai-nilai tersebut juga dapat diperbarui pada layanan yang ada.
`minimumHealthyPercent`Ini mewakili batas bawah pada jumlah tugas yang harus dijalankan untuk layanan selama penerapan atau ketika instance kontainer terkuras. Ini adalah persen dari jumlah tugas yang diinginkan untuk layanan ini. Nilai ini dibulatkan ke atas. Misalnya, jika persentase sehat minimum adalah `50` dan jumlah tugas yang diinginkan adalah empat, maka penjadwal dapat menghentikan dua tugas yang ada sebelum memulai dua tugas baru. Demikian juga, jika persentase minimum yang sehat adalah 75% dan jumlah tugas yang diinginkan adalah dua, maka penjadwal tidak dapat menghentikan tugas apa pun karena nilai yang dihasilkan juga dua.
`maximumPercent`Ini mewakili batas atas jumlah tugas yang harus dijalankan untuk layanan selama penerapan atau saat instance kontainer terkuras. Ini adalah persentase dari jumlah tugas yang diinginkan untuk suatu layanan. Nilai ini dibulatkan ke bawah. Misalnya, jika persentase maksimum adalah `200` dan jumlah tugas yang diinginkan adalah empat, maka penjadwal dapat memulai empat tugas baru sebelum menghentikan empat tugas yang ada. Demikian juga, jika persentase maksimum adalah `125` dan jumlah tugas yang diinginkan adalah tiga, maka penjadwal tidak dapat memulai tugas apa pun karena nilai yang dihasilkan juga tiga.
Saat pengaturan persentase minimum atau maksimum yang sehat, Anda harus memastikan bahwa penjadwal dapat menghentikan atau memulai setidaknya satu tugas saat deployment dipicu.
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Anda telah mencapai batas jumlah tugas yang dapat Anda jalankan secara bersamaan
Anda dapat meminta peningkatan kuota untuk sumber daya yang menyebabkan kesalahan. Untuk informasi selengkapnya, lihat [Kuota layanan Amazon ECS](service-quotas.md). Untuk meminta penambahan kuota, lihat [Meminta penambahan kuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) di *Panduan Pengguna Service Quotas*.
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Kesalahan internal.
Berikut ini adalah kemungkinan alasan untuk kesalahan ini:
Layanan tidak dapat memulai tugas karena subnet berada di Availability Zone yang tidak didukung.
Untuk informasi tentang Wilayah Fargate dan Zona Ketersediaan yang didukung, lihat. [Wilayah yang Didukung untuk Amazon ECS di Fargate AWS](AWS_Fargate-Regions.md)
Untuk informasi tentang cara melihat Zona Ketersediaan subnet, lihat [Melihat subnet Anda di Panduan](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#view-subnet) Pengguna Amazon *VPC*.
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Konfigurasi CPU yang diminta berada di atas batas Anda.
Anda dapat meminta peningkatan kuota untuk sumber daya yang menyebabkan kesalahan. Untuk informasi selengkapnya, lihat [Kuota layanan Amazon ECS](service-quotas.md). Untuk meminta penambahan kuota, lihat [Meminta penambahan kuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) di *Panduan Pengguna Service Quotas*.
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Konfigurasi MEMORY yang diminta berada di atas batas Anda.
Anda dapat meminta peningkatan kuota untuk sumber daya yang menyebabkan kesalahan. Untuk informasi selengkapnya, lihat [Kuota layanan Amazon ECS](service-quotas.md). Untuk meminta penambahan kuota, lihat [Meminta penambahan kuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) di *Panduan Pengguna Service Quotas*.
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Anda telah mencapai batas jumlah v yang dapat CPUs Anda jalankan secara bersamaan
AWS Fargate beralih dari kuota berbasis hitungan tugas ke kuota berbasis VCPU.
Anda dapat meminta kenaikan kuota untuk kuota berbasis VCPU Fargate. Untuk informasi selengkapnya, lihat [Kuota layanan Amazon ECS](service-quotas.md). *Untuk meminta peningkatan kuota Fargate, lihat [Meminta kenaikan kuota pada Panduan Pengguna Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).*
## service (*service-name*) tidak dapat mencapai kondisi tunak karena task set (*taskSet-ID*) tidak dapat diskalakan. Alasan: Jumlah tugas yang dilindungi lebih dari jumlah tugas yang diinginkan
Layanan ini memiliki tugas yang lebih terlindungi daripada yang diinginkanjumlah tugas. Anda dapat melakukan salah satu hal berikut:
+ Tunggu hingga perlindungan pada tugas saat ini kedaluwarsa, memungkinkan mereka untuk dihentikan.
+ Tentukan tugas mana yang dapat dihentikan dan gunakan `UpdateTaskProtection` API dengan `protectionEnabled` opsi yang disetel `false` ke unset protection untuk tugas-tugas ini.
+ Tingkatkan jumlah tugas yang diinginkan dari layanan menjadi lebih dari jumlah tugas yang dilindungi.
## service (*service-name*) tidak dapat mencapai kondisi mapan. Alasan: Tidak ada Instans Kontainer yang ditemukan di penyedia kapasitas Anda.
Penjadwal layanan mengirimkan pesan peristiwa ini ketika tidak dapat menemukan sumber daya yang tersedia untuk menambahkan tugas lain. Kemungkinan penyebab untuk ini adalah:
Tidak ada penyedia kapasitas yang terkait dengan cluster
Gunakan `describe-services` untuk memverifikasi bahwa Anda memiliki penyedia kapasitas yang terkait dengan klaster Anda dapat memperbarui strategi penyedia kapasitas untuk layanan tersebut.
Verifikasi bahwa ada kapasitas yang tersedia di penyedia kapasitas, Dalam kasus EC2, pastikan bahwa instance kontainer memenuhi persyaratan definisi tugas.
Tidak ada instans kontainer yang ditemukan di klaster Anda
Jika tidak ada instance kontainer yang terdaftar di cluster tempat Anda mencoba menjalankan tugas, Anda menerima kesalahan ini. Anda harus menambahkan instans kontainer untuk klaster Anda. Untuk informasi selengkapnya, lihat [Meluncurkan instans penampung Amazon ECS Linux](launch_container_instance.md).
Port tidak cukup
Jika tugas Anda menggunakan pemetaan port host tetap (misalnya, tugas Anda menggunakan port 80 pada host untuk server web), Anda harus memiliki setidaknya satu instance kontainer per tugas. Hanya satu kontainer yang dapat menggunakan port host tunggal pada satu waktu. Anda harus menambahkan instans kontainer ke klaster milik Anda atau mengurangi jumlah tugas yang diinginkan.
Terlalu banyak port yang terdaftar
Instance pencocokan kontainer terdekat untuk penempatan tugas tidak dapat melebihi batas port cadangan maksimum yang diizinkan sebesar 100 port host per instance kontainer. Menggunakan pemetaan port host dinamis dapat memperbaiki masalah.
Port sudah digunakan
Definisi tugas tugas ini menggunakan port yang sama dalam pemetaan portnya sebagai tugas yang sudah berjalan pada instance kontainer yang dipilih. Pesan acara layanan akan memiliki ID instance kontainer yang dipilih sebagai bagian dari pesan di bawah ini.
```
The closest matching container-instance is already using a port required by your task.
```
Memori tidak cukup
Jika ketentuan tugas Anda menentukan memori sejumlah 1000 MiB, dan masing-masing klaster Anda pada instans kontainer memiliki memori sejumlah 1024 MiB, Anda hanya dapat menjalankan satu salinan tugas ini per instans kontainer. Anda dapat bereksperimen dengan memori yang lebih sedikit pada ketentuan tugas Anda sehingga Anda bisa meluncurkan lebih dari satu tugas per instans kontainer, atau meluncurkan lebih banyak instans kontainer menuju klaster Anda.
Jika Anda mencoba untuk memaksimalkan pemanfaatan sumber daya Anda dengan menyediakan memori pada tugas sebanyak mungkin untuk tipe instans tertentu, lihat [Memesan memori instans wadah Amazon ECS Linux](memory-management.md).
Poin lampiran ENI yang tersedia tidak cukup
Tugas yang menggunakan mode `awsvpc` jaringan masing-masing menerima elastic network interface (ENI) mereka sendiri, yang dilampirkan ke instance container yang menghostingnya. Instans Amazon EC2 memiliki batasan jumlah instans ENIs yang dapat dilampirkan padanya, dan tidak ada instance kontainer di cluster yang memiliki kapasitas ENI yang tersedia.
Batas ENI untuk instans kontainer individu tergantung pada kondisi berikut:
+ Jika Anda **belum** menyertakan untuk Pengaturan akun `awsvpcTrunking`, batas ENI untuk setiap instans kontainer tergantung pada tipe instans. Untuk informasi selengkapnya, lihat [Alamat IP Per Antarmuka Jaringan Per Tipe Instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) dalam *Panduan Pengguna Amazon EC2*.
+ Jika Anda **telah** memilih untuk masuk ke setelan `awsvpcTrunking` akun tetapi Anda **belum** meluncurkan instance container baru menggunakan tipe instans yang didukung setelah memilih, batas ENI untuk setiap instance container masih pada nilai default. Untuk informasi selengkapnya, lihat [Alamat IP Per Antarmuka Jaringan Per Tipe Instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) dalam *Panduan Pengguna Amazon EC2*.
+ Jika Anda **telah** memilih untuk masuk ke setelan `awsvpcTrunking` akun dan Anda **telah** meluncurkan instance container baru menggunakan jenis instans yang didukung setelah memilih, tambahan ENIs akan tersedia. Untuk informasi selengkapnya, lihat [Instans yang didukung untuk peningkatan antarmuka jaringan kontainer Amazon ECS](eni-trunking-supported-instance-types.md).
Untuk informasi lebih lanjut tentang penyertaan pada pengaturan akun `awsvpcTrunking`, lihat [Meningkatkan antarmuka jaringan instans kontainer Amazon ECS Linux](container-instance-eni.md).
Anda dapat menambahkan instans kontainer untuk klaster Anda untuk menyediakan lebih banyak adapter jaringan yang tersedia.
Instans kontainer kehilangan atribut wajib
Beberapa parameter ketentuan tugas memerlukan versi API Docker jarak jauh tertentu untuk diinstal pada instans kontainer. Hal lainnya, seperti opsi pencatatan driver, mengharuskan instans kontainer untuk mendaftarkan pencatatan driver tersebut dengan variabel konfigurasi agen `ECS_AVAILABLE_LOGGING_DRIVERS`. Jika definisi tugas Anda berisi parameter yang memerlukan atribut instance kontainer tertentu, dan Anda tidak memiliki instance kontainer yang tersedia yang dapat memenuhi persyaratan ini, tugas tidak dapat ditempatkan.
Penyebab umum kesalahan ini adalah jika layanan Anda menggunakan tugas yang menggunakan mode `awsvpc` jaringan dan EC2 dan cluster yang Anda tentukan tidak memiliki instance penampung yang terdaftar di subnet yang sama yang ditentukan pada `awsvpcConfiguration` saat layanan dibuat.
Anda dapat menggunakan AWSSupport-TroubleshootECSContainerInstance runbook untuk memecahkan masalah. Runbook meninjau apakah data pengguna untuk instance berisi informasi klaster yang benar, apakah profil instance berisi izin yang diperlukan, dan masalah konfigurasi jaringan. Untuk informasi selengkapnya, lihat [AWSSupport-TroubleshootECSContainerInstance](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-aws-troubleshoot-ecs-container-instance.html)di *Panduan Pengguna referensi buku runbook AWS Systems Manager Otomasi*.
Untuk informasi lebih lanjut tentang atribut yang diperlukan untuk parameter ketentuan tugas tertentu dan variabel konfigurasi agen, lihat [Parameter definisi tugas Amazon ECS untuk Fargate](task_definition_parameters.md) dan [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).
## service (*service-name*) tidak dapat menempatkan tugas. Alasan: Kapasitas tidak tersedia saat ini. Silakan coba lagi nanti atau di zona ketersediaan yang berbeda.
Saat ini tidak ada kapasitas yang tersedia untuk menjalankan layanan Anda.
Anda dapat melakukan salah satu hal berikut:
+ Tunggu hingga kapasitas Fargate atau instans kontainer EC2 tersedia.
+ Luncurkan kembali layanan dan tentukan subnet tambahan.
## service (*service-name*) penerapan gagal: tugas gagal dimulai.
Tugas dalam layanan Anda gagal dimulai.
Untuk informasi tentang cara men-debug tugas yang dihentikan. lihat. [Amazon ECS menghentikan pesan kesalahan tugas](stopped-task-error-codes.md)
## service (*service-name*) Waktu habis menunggu Amazon ECS Agent dimulai. Silakan periksa log di/var/log/ecs/ecs-agent.log”.
Agen kontainer Amazon ECS pada instance kontainer pencocokan terdekat untuk penempatan tugas terputus. Jika Anda dapat terhubung ke instance kontainer dengan SSH, Anda dapat memeriksa log agen. Untuk informasi selengkapnya, lihat [Parameter konfigurasi log agen kontainer Amazon ECS](ecs-agent-versions.md#agent-logs). Anda juga harus memverifikasi bahwa agen sedang berjalan pada instans. Jika Anda menggunakan AMI Amazon ECS yang dioptimalkan, Anda dapat mencoba menghentikan dan memulai ulang agen dengan perintah berikut.
+ Untuk Amazon ECS yang dioptimalkan Amazon Linux 2 AMI
```
sudo systemctl restart ecs
```
+ Untuk Amazon ECS yang dioptimalkan Amazon Linux AMI
```
sudo stop ecs && sudo start ecs
```
## service (*service-name*) task set (*taskSet-ID*) (task*task-id*) tidak sehat di target-group (*targetGroup-ARN)*) karena. `TARGET GROUP IS NOT FOUND`
Tugas yang ditetapkan untuk layanan ini gagal dalam pemeriksaan kesehatan karena kelompok sasaran tidak ditemukan. Pesan tersebut menyertakan ID tugas untuk membantu mengidentifikasi tugas spesifik mana yang gagal dalam pemeriksaan kesehatan. Anda harus menghapus dan membuat ulang layanan. Jangan menghapus grup target Elastic Load Balancing kecuali layanan Amazon ECS yang sesuai telah dihapus.
## service (*service-name*) task set (*taskSet-ID*) (task*task-id*) tidak sehat di target-group (*targetGroup-ARN)*) karena. `TARGET IS NOT FOUND`
Tugas yang ditetapkan untuk layanan ini gagal dalam pemeriksaan kesehatan karena target tidak ditemukan. Pesan tersebut menyertakan ID tugas untuk membantu mengidentifikasi tugas spesifik mana yang gagal dalam pemeriksaan kesehatan.
## Kebijakan izin IAM telah salah dikonfigurasi atau diubah, dan ECS tidak dapat lagi mempertahankan layanan Anda
Layanan tidak dapat mempertahankan tugas karena kebijakan izin IAM yang salah dikonfigurasi atau diubah. Peran IAM yang terkait dengan layanan atau tugas ECS Anda mungkin kehilangan izin yang diperlukan.
Untuk mengatasi masalah ini, tambahkan izin yang diperlukan ke peran IAM. *Untuk informasi selengkapnya tentang mengelola kebijakan izin IAM, lihat [Menambahkan dan menghapus izin identitas IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) di Panduan Pengguna IAM.*
## Hubungan kepercayaan IAM telah salah konfigurasi atau diubah, dan ECS tidak dapat lagi mempertahankan layanan Anda
Layanan tidak dapat mempertahankan tugas karena hubungan kepercayaan IAM yang salah dikonfigurasi atau diubah. Peran IAM yang terkait dengan layanan atau tugas ECS Anda mungkin memiliki kebijakan kepercayaan yang salah.
Untuk mengatasi masalah ini, konfigurasikan kebijakan kepercayaan untuk peran yang digunakan dalam definisi tugas Anda. Untuk informasi selengkapnya tentang membuat kebijakan kepercayaan untuk peran kustom, lihat [Membuat peran untuk kasus penggunaan kustom](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) di *Panduan Pengguna IAM*.
## service (*service-name*) tidak dapat meluncurkan *number* tugas untuk penerapan*deployment-id*.
Penjadwal layanan mengirimkan pesan peristiwa ini ketika alur kerja penerapan berhasil memulai beberapa tugas tetapi gagal meluncurkan semua tugas yang diminta karena kesalahan kapasitas yang tidak mencukupi. Ini biasanya terjadi ketika Circuit Breaker diaktifkan dan memberikan visibilitas mengapa penerapan mungkin gagal atau mundur.
Pesan tersebut mencakup alasan kegagalan tertentu, seperti CPU yang tidak mencukupi, memori, atau kendala sumber daya lainnya. Ini membantu Anda memahami sumber daya apa yang perlu ditangani untuk menyelesaikan masalah penerapan.
Untuk informasi selengkapnya, lihat [service (*service-name*) tidak dapat menempatkan tugas karena tidak ada instance kontainer yang memenuhi semua persyaratannya.](#service-event-messages-1).
## service (*service-name*) tidak dapat menempatkan tugas di klaster Anda karena batas kapasitas penyediaan tugas telah terlampaui.
Penjadwal layanan mengirimkan pesan peristiwa ini ketika klaster Anda telah mencapai batas 500 tugas yang dapat berada dalam `PROVISIONING` status secara bersamaan. Ini adalah batas tingkat cluster, bukan masalah khusus layanan.
Ini biasanya terjadi ketika Anda memulai layanan dengan sejumlah besar tugas yang diinginkan dengan kapasitas pra-penyediaan terbatas, atau ketika beberapa layanan dimulai secara bersamaan menyebabkan churn tugas tinggi.
Untuk menyelesaikan masalah ini:
+ Tunggu tugas yang ada untuk menyelesaikan penyediaan dan pindah ke status. `RUNNING`
+ Pertimbangkan untuk menskalakan layanan Anda secara lebih bertahap untuk menghindari mencapai batas penyediaan.
+ Tinjau konfigurasi penyedia kapasitas klaster Anda untuk memastikan sumber daya yang memadai tersedia.
Untuk informasi selengkapnya tentang kuota layanan Amazon ECS, lihat [titik akhir dan kuota Amazon Elastic Container Service di Referensi](https://docs.aws.amazon.com/general/latest/gr/ecs-service.html) Umum *Amazon Web* Services.
# Layanan Amazon ECS pesan acara tidak sehat
Berikut ini adalah contoh layanan pesan acara yang tidak sehat.
## EC2: (layanan*service-name*) (tugas*task-id*) (instance*instance-id*) (port*port-number*) tidak sehat di (target-group*target-group-name*) karena (alasan) *failure-reason*
Pesan ini menunjukkan bahwa tugas yang berjalan pada instans EC2 gagal dalam pemeriksaan kesehatan. Untuk informasi selengkapnya, lihat berikut ini:
+ [Bagaimana cara mendapatkan tugas Amazon ECS saya yang menggunakan EC2 untuk lulus pemeriksaan kesehatan Application Load Balancer?](https://repost.aws/knowledge-center/troubleshoot-unhealthy-checks-ecs)
## EC2 dengan TaskSet: (service*service-name*, TaskSet*taskSet-id*) (task) (instance*task-id*) (port*instance-id*) tidak sehat di (target-group*port-number*) karena (alasan*target-group-name*) *failure-reason*
Pesan ini menunjukkan bahwa tugas dalam set tugas yang berjalan pada instans EC2 gagal dalam pemeriksaan kesehatan. Untuk informasi selengkapnya, lihat berikut ini:
+ [Bagaimana cara mendapatkan tugas Amazon ECS saya yang menggunakan EC2 untuk lulus pemeriksaan kesehatan Application Load Balancer?](https://repost.aws/knowledge-center/troubleshoot-unhealthy-checks-ecs)
## Fargate: (layanan*service-name*) (tugas*task-id*) (port*port-number*) tidak sehat di (kelompok target*target-group-name*) karena (alasan) *failure-reason*
Pesan ini menunjukkan bahwa tugas Fargate gagal dalam pemeriksaan kesehatan.
Untuk informasi selengkapnya tentang pemecahan masalah kegagalan pemeriksaan kesehatan di tugas Fargate, lihat [Bagaimana cara memecahkan masalah kegagalan pemeriksaan kesehatan untuk tugas Amazon](https://repost.aws/knowledge-center/ecs-fargate-health-check-failures) ECS di Fargate? .
## Fargate dengan TaskSet: (service*service-name*, TaskSet*taskSet-id*) (task) (port*task-id*) tidak sehat di (*target-group-name*target-group*port-number*) karena (alasan) *failure-reason*
Pesan ini menunjukkan bahwa tugas dalam set tugas yang berjalan di Fargate gagal dalam pemeriksaan kesehatan.
Untuk informasi selengkapnya tentang pemecahan masalah kegagalan pemeriksaan kesehatan di tugas Fargate, lihat [Bagaimana cara memecahkan masalah kegagalan pemeriksaan kesehatan untuk tugas Amazon](https://repost.aws/knowledge-center/ecs-fargate-health-check-failures) ECS di Fargate? .
# Pesan peristiwa layanan penyeimbangan ulang layanan Zona Ketersediaan Amazon ECS
Berikut ini adalah contoh pesan acara layanan yang mungkin Anda lihat.
## service (*service-name*) tidak AZ seimbang dengan *number-tasks* tugas di dalam*Availability Zone 1*, *number-tasks* di*Availability Zone 2*, dan *number-tasks* di*Availability Zone 3*. AZ Rebalancing sedang berlangsung.
Penjadwal layanan mengirimkan acara `service (service-name) is not AZ balanced` layanan ketika jumlah tugas tidak tersebar merata di seluruh Availability Zone. Tidak ada tindakan yang harus diambil. Ini adalah acara informasi.
## service (*service-name*) adalah AZ seimbang dengan *number-tasks* tugas-tugas dalam*Availability Zone 1*, *number-tasks* tugas di*Availability Zone 2*, dan *number-tasks* tugas di*Availability Zone 3*.
Penjadwal layanan mengirimkan peristiwa `service (service-name) is AZ balanced` layanan saat penyeimbangan kembali layanan Availability Zone selesai. Tidak ada tindakan yang harus diambil. Ini adalah acara informasi.
## *service-name*telah memulai *number-tasks* tugas *Availability Zone* ke AZ Rebalance:*task-ids*.
Penjadwal layanan mengirimkan *service-name* *task-set-name* /telah memulai *number* tugas dalam acara *Availability Zone* layanan ketika memulai tugas di Availability Zone karena penyeimbangan kembali layanan. Tidak ada tindakan yang harus diambil. Ini adalah acara informasi.
## *service-name*telah berhenti *number-tasks* menjalankan tugas *Availability Zone* karena penyeimbangan kembali AZ:. *task-id*
Penjadwal layanan mengirimkan *service-name* *task-set-name* /telah menghentikan *number* tugas dalam acara *Availability Zone* layanan ketika menghentikan tugas di Availability Zone karena penyeimbangan kembali layanan. Tidak ada tindakan yang harus diambil. Ini adalah acara informasi.
## service (*service-name*) tidak dapat menempatkan tugas *Availability Zone* karena tidak ada instance kontainer yang memenuhi semua persyaratannya.
Penjadwal layanan mengirimkan tidak dapat menempatkan tugas dalam acara *Availability Zone* layanan karena tidak ada instance kontainer yang memenuhi semua persyaratannya. *service-name* Untuk mengatasi masalah ini, luncurkan instance di Availability Zone.
## service (*service-name*) tidak dapat menempatkan tugas di*Availability Zone*.
Penjadwal layanan mengirimkan *service-name* tidak dapat menempatkan tugas dalam acara *Availability Zone* layanan ketika Anda menggunakan Fargate dan tidak ada kapasitas yang tersedia.
Anda dapat menambahkan subnet tambahan di Availability Zone dalam pesan kesalahan, atau kontak Dukungan untuk mendapatkan kapasitas tambahan.
## service (*service-name*) tidak dapat melakukan AZ Rebalance karena *task-set-name* tidak dapat menskalakan karena*reason*.
Penjadwal layanan mengirimkan tidak dapat melakukan AZ Rebalance karena *task-set-name* tidak dapat menskalakan karena peristiwa *reason* layanan saat Anda menggunakan perlindungan skala tugas. *service-name*
Anda dapat melakukan salah satu hal berikut:
+ Tunggu hingga perlindungan pada tugas saat ini kedaluwarsa, memungkinkan mereka untuk dihentikan.
+ Tentukan tugas mana yang dapat dihentikan dan gunakan `UpdateTaskProtection` API dengan `protectionEnabled` opsi yang disetel `false` ke unset protection untuk tugas-tugas ini.
+ Tingkatkan jumlah tugas yang diinginkan dari layanan menjadi lebih dari jumlah tugas yang dilindungi.
## service (*service-name*) menghentikan AZ Rebalancing.
Penjadwal layanan mengirimkan peristiwa layanan Rebalancing AZ yang *service-name* dihentikan saat operasi penyeimbangan ulang Availability Zone berhenti. Ini adalah acara informasi. Amazon ECS mengirimkan acara tambahan yang memberikan informasi lebih lanjut.
# Memecahkan masalah penyeimbang beban layanan di Amazon ECS
Layanan Amazon ECS dapat mendaftarkan tugas dengan penyeimbang beban Elastic Load Balancing. Kesalahan konfigurasi terhadap penyeimbang beban adalah penyebab umum kenapa tugas berhenti. Jika tugas Anda yang berhenti dimulai oleh layanan yang menggunakan penyeimbang beban, pertimbangkan kemungkinan penyebab berikut ini.
**Peran terkait layanan Amazon ECS tidak ada**
Peran terkait layanan Amazon ECS memungkinkan layanan Amazon ECS mendaftarkan instans kontainer dengan penyeimbang beban Elastic Load Balancing. Peran yang terkait dengan layanan harus dibuat di akun Anda. Untuk informasi selengkapnya, lihat [Menggunakan peran terkait layanan untuk Amazon ECS](using-service-linked-roles.md).
**Grup keamanan contoh kontainer**
Jika kontainer Anda dipetakan kepada port 80 di instans kontainer Anda, grup keamanan instans kontainer harus mengizinkan lalu lintas masuk pada port 80 untuk pemeriksaan kondisi penyeimbang beban agar dapat melalui port tersebut.
**Penyeimbang beban Elastic Load Balancing tidak dikonfigurasi untuk semua Availability Zone**
Penyeimbang beban Anda harus dikonfigurasikan untuk dapat menggunakan semua Availability Zone pada sebuah Wilayah, atau setidaknya semua Availability Zone tempat instans kontainer berada. Jika layanan menggunakan penyeimbang beban dan memulai tugas pada instance container yang berada di Availability Zone yang tidak dikonfigurasi untuk digunakan oleh penyeimbang beban, tugas tersebut tidak akan pernah lolos pemeriksaan kesehatan. Hal ini mengakibatkan tugas terbunuh.
**Pemeriksaan kesehatan penyeimbang beban Elastic Load Balancing salah konfigurasi**
Parameter pemeriksaan kondisi penyeimbang beban dapat terlalu ketat atau mengarah pada sumber daya yang sudah tidak ada. Jika instance kontainer ditentukan tidak sehat, itu dihapus dari penyeimbang beban. Pastikan untuk memverifikasi bahwa parameter berikut ini dikonfigurasi dengan benar untuk layanan penyeimbang beban Anda.
Port Ping
Parameter nilai **Port Ping** untuk pemeriksaan kondisi penyeimbang beban adalah port pada instans kontainer bahwa pemeriksaan pada penyeimbang beban bertujuan menentukan apakah itu dalam kondisi yang optimal. Jika port ini salah dikonfigurasikan, maka penyeimbang beban memilik kemungkinan untuk mencabut kembali register instans kontainer Anda dari itu sendiri. Port ini perlu dikonfigurasikan untuk dapat menggunakan nilai `hostPort` untuk kontainer dalam definisi layanan tugas yang Anda gunakan dengan pemeriksaan kondisi.
Jalur Ping
Ini adalah bagian dari pemeriksaan kesehatan penyeimbang beban. Ini adalah titik akhir pada aplikasi Anda yang dapat memulai kembali kode status yang berhasil (misalnya, 200) ketika aplikasi sehat. Nilai ini sering diatur ke `index.html`, tetapi jika layanan Anda tidak menanggapi permintaan tersebut, maka pemeriksaan kondisi gagal. Jika kontainer Anda tidak memiliki sebuah file `index.html`, Anda dapat mengaturnya menuju `/` untuk menargetkan dasar URL untuk instans kontainer.
Waktu Respons Habis
Ini adalah jumlah waktu yang kontainer Anda harus dapat kembalikan sebuah respons terhadap ping pemeriksaan kondisi. Jika nilai ini lebih rendah dari jumlah waktu yang diperlukan untuk respon, pemeriksaan kondisi gagal.
Interval Pemeriksaan Kondisi
Ini adalah jumlah waktu antara ping pemeriksaan kondisi. Semakin pendek interval pemeriksaan kondisi Anda, semakin cepat instans kontainer Anda dapat mencapai **Ambang Tidak Baik**.
Batas Kondisi Tidak Baik
Ini merupakan jumlah berapa kali pemeriksaan kondisi Anda bisa gagal sebelum instans kontainer Anda dianggap tidak optimal. Jika Anda memiliki ambang batas 2 yang tidak sehat, dan interval pemeriksaan kesehatan 30 detik, maka tugas Anda memiliki 60 detik untuk menanggapi ping pemeriksaan kesehatan sebelum dianggap tidak sehat. Anda dapat menaikkan ambang batas yang tidak optimal atau interval pemeriksaan kondisi untuk memberikan tugas Anda lebih banyak waktu untuk merespons.
**Tidak dapat memperbarui layanan *servicename*****: Nama wadah penyeimbang beban atau port diubah dalam definisi tugas**
Jika layanan Anda menggunakan penyeimbang beban, Anda dapat menggunakan AWS CLI atau SDK untuk memodifikasi konfigurasi penyeimbang beban. Untuk informasi tentang cara mengubah konfigurasi, lihat [UpdateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html)di *Referensi API Amazon Elastic Container Service*. Jika Anda memperbarui definisi tugas untuk layanan, nama kontainer dan port kontainer yang ditentukan dalam konfigurasi penyeimbang beban harus tetap dalam definisi tugas.
**Anda telah mencapai batas jumlah tugas yang dapat Anda jalankan secara bersamaan.**
Untuk akun baru, kuota Anda mungkin lebih rendah dari kuota layanan. Kuota layanan untuk akun Anda dapat dilihat di konsol Service Quotas. Untuk meminta penambahan kuota, lihat [Meminta penambahan kuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) di *Panduan Pengguna Service Quotas*.
# Pemecahan masalah penskalaan otomatis layanan di Amazon ECS
Application Auto Scaling mematikan proses scale-in saat penerapan Amazon ECS sedang berlangsung, dan proses tersebut dilanjutkan setelah penerapan selesai. Namun, proses penskalaan keluar terus terjadi, kecuali ditangguhkan, selama deployment. Untuk informasi lebih lanjut, lihat [Menangguhkan dan melanjutkan penskalaan untuk Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-suspend-resume-scaling.html).
# Pengambilan acara Amazon ECS di konsol
Konsol Amazon ECS menyediakan fungsionalitas pengambilan peristiwa yang menyimpan peristiwa yang dihasilkan Amazon ECS, seperti tindakan layanan dan perubahan status tugas, ke Amazon CloudWatch Logs. EventBridge Fitur ini mencakup antarmuka kueri dengan kemampuan penyaringan untuk pemantauan dan pemecahan masalah.
Peristiwa memberikan informasi mendetail tentang cara deployment layanan, layanan, tugas, dan instans Anda beroperasi. Anda dapat menggunakan informasi ini untuk memecahkan masalah kegagalan deployment tugas atau layanan.
Saat Anda mengaktifkan pengambilan acara, Anda memiliki akses ke semua peristiwa yang dihasilkan Amazon ECS untuk periode retensi pilihan Anda, melampaui batasan asli dari 100 peristiwa terakhir yang tidak difilter atau tugas yang dihentikan hanya terlihat selama 1 jam.
## Cara kerjanya
Pengambilan peristiwa digunakan EventBridge untuk menyimpan peristiwa dalam grup CloudWatch log Amazon Logs yang telah ditentukan sebelumnya. Konsol Amazon ECS menyediakan kueri bawaan dan opsi pemfilteran, dan menghubungkan peristiwa untuk menyediakan siklus hidup tugas dalam format yang intuitif.
Anda dapat mengueri dan mengambil jenis peristiwa berikut:
+ **Peristiwa tindakan layanan** – Membantu mengidentifikasi masalah penyediaan atau alokasi sumber daya
+ **Peristiwa siklus hidup tugas** – Membantu mengidentifikasi alasan tugas atau kontainer gagal diluncurkan atau berhenti berjalan
Konsol Amazon ECS memungkinkan Anda mengatur pengambilan peristiwa dalam satu klik dan menyediakan kueri dan pemfilteran yang umum digunakan tanpa mengharuskan Anda mempelajari bahasa kueri atau menavigasi di antara beberapa konsol.
## Tipe peristiwa
Pengambilan peristiwa menyimpan semua peristiwa yang dihasilkan Amazon ECS dalam kategori berikut:
Peristiwa perubahan status tugas
Kontainer berhenti dan peristiwa penghentian lainnya, yang dapat Anda gunakan untuk pemecahan masalah atau untuk memantau jadwal siklus hidup tugas.
Tindakan layanan
Peristiwa seperti mencapai kondisi stabil, kegagalan penempatan tugas, atau kendala sumber daya.
Perubahan status deployment layanan
Peristiwa seperti penerapan yang sedang berlangsung, selesai, atau gagal, dipicu oleh pemutus sirkuit dan pengaturan rollback, untuk memantau status penyebaran layanan.
Perubahan status instans kontainer
Untuk beban kerja di Instans Terkelola EC2 dan Amazon ECS, peristiwa menampilkan status tersambung dan terputus.
## Konfigurasi grup log
Saat Anda mengaktifkan pengambilan acara, Amazon ECS secara otomatis membuat sumber daya berikut:
+ Grup CloudWatch log Amazon Logs bernama `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ EventBridge Aturan yang menyerap semua peristiwa dari `aws.ecs` sumber dan meneruskannya ke grup log
Anda dapat menentukan periode retensi untuk grup log dari 1 hari hingga 10 tahun. Periode retensi default adalah 7 hari.
## Pertimbangan-pertimbangan
Pertimbangkan hal berikut saat menggunakan event capture:
+ Pengambilan acara menyimpan semua acara untuk kesederhanaan. Anda tidak dapat mengonfigurasi aturan di konsol Amazon ECS untuk menangkap hanya peristiwa tertentu.
+ Konsol Amazon ECS menyediakan kriteria kueri yang telah ditentukan sebelumnya. Untuk kueri lanjutan, gunakan Amazon CloudWatch Logs Logs Insights untuk menanyakan grup log secara langsung.
+ Fungsionalitas ekor langsung tidak tersedia di konsol Amazon ECS. Gunakan Amazon CloudWatch Logs secara langsung untuk live tail.
+ Saat Anda menonaktifkan pengambilan acara, EventBridge aturan akan dihapus.
+ Pengambilan peristiwa menimbulkan biaya tambahan untuk konsumsi EventBridge data, penyimpanan CloudWatch Amazon Log, dan eksekusi kueri.
Untuk informasi tentang EventBridge harga, lihat [EventBridge harga](https://aws.amazon.com/eventbridge/pricing/).
Untuk informasi tentang CloudWatch harga, lihat [CloudWatch harga](https://aws.amazon.com/cloudwatch/pricing/).
## Pemecahan masalah berbasis peristiwa
Gunakan peristiwa yang dihasilkan Amazon ECS untuk menjawab pertanyaan pemecahan masalah umum.
### Analisis kegagalan tugas
Anda dapat meninjau peristiwa perubahan status `STOPPED` tugas, kode berhenti, dan kode keluar kontainer untuk menentukan mengapa tugas gagal diluncurkan atau gagal saat berjalan.
Anda dapat meninjau peristiwa tindakan layanan untuk kegagalan penempatan dan informasi kendala sumber daya untuk menentukan mengapa tugas gagal ditempatkan karena kendala sumber daya
### Skenario kegagalan tugas umum
Kegagalan tugas abnormal yang paling umum terkait dengan masalah berikut:
+ Kegagalan penyebaran layanan CI/CD
+ Kegagalan penskalaan otomatis
+ Kegagalan penyeimbangan kembali tugas
+ Pintu keluar kontainer yang tidak normal, seperti kesalahan out-of-memory (OOM)
Kegagalan tugas yang tidak normal menghasilkan peristiwa perubahan status `STOPPED` tugas dengan kode `EssentialContainerExited` atau `TaskFailedToStart` berhenti. Anda dapat memfilter berdasarkan kode berhenti ini untuk memeriksa eksekusi kontainer dan menghentikan perilaku.
# Aktifkan pengambilan acara untuk kluster Amazon ECS yang ada
Anda dapat mengaktifkan pengambilan peristiwa pada klaster Amazon ECS yang ada untuk menyimpan peristiwa yang dihasilkan Amazon ECS di Log Amazon CloudWatch . EventBridge Fitur ini membantu Anda memantau dan memecahkan masalah kegagalan tugas, penerapan layanan, dan aktivitas klaster lainnya.
Setelah Anda mengaktifkan penangkapan peristiwa, Amazon ECS membuat sumber daya berikut:
+ Grup CloudWatch log Amazon Logs bernama `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ EventBridge Aturan yang menangkap semua peristiwa dari sumbernya `aws.ecs`
Tab **History** ditampilkan dalam tampilan cluster, memungkinkan Anda untuk menanyakan peristiwa siklus hidup tugas dan tindakan layanan. Pengambilan peristiwa segera dimulai dan menyimpan semua peristiwa yang dihasilkan Amazon ECS sesuai dengan periode retensi yang Anda tentukan.
## Prasyarat
+ Cluster Amazon ECS yang ada
+ Izin IAM yang sesuai untuk mengubah setelan klaster dan membuat sumber daya Amazon Logs CloudWatch
## Aktifkan pengambilan acara menggunakan konsol
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Pilih cluster tempat Anda ingin mengaktifkan pengambilan acara.
Halaman detail cluster ditampilkan.
1. Pilih **Konfigurasi**.
1. Di bagian **acara ECS**, pilih **Aktifkan pengambilan acara**.
Kotak dialog **Aktifkan penangkapan acara** ditampilkan.
1. Untuk **peristiwa Kedaluwarsa**, pilih periode penyimpanan untuk grup CloudWatch log Amazon Logs. Default-nya adalah 7 hari.
1. Pilih **Nyalakan**.
# Melihat layanan Amazon ECS dan peristiwa perubahan status tugas
Konsol Amazon ECS menyediakan fungsionalitas pengambilan peristiwa yang menyimpan peristiwa yang dihasilkan Amazon ECS, seperti tindakan layanan dan perubahan status tugas, ke Amazon CloudWatch Logs. EventBridge Fitur ini mencakup antarmuka kueri dengan kemampuan penyaringan untuk meningkatkan pemantauan dan pemecahan masalah.
Peristiwa memberikan informasi mendetail tentang cara deployment layanan, layanan, tugas, dan instans Anda beroperasi. Anda dapat menggunakan informasi ini untuk memecahkan masalah kegagalan deployment tugas atau layanan.
Anda dapat menggunakan salah satu kriteria berikut untuk memfilter acara:
+ ID Deployment (Ini hanya tersedia di halaman detail layanan)
+ Waktu mulai
+ Waktu akhir
+ Nama layanan (hanya berlaku pada halaman detail cluster, pada halaman detail layanan, ini akan menjadi default untuk layanan saat ini)
+ ID tugas
+ Tugas Status terakhir
+ Keluarga definisi tugas
+ Revisi definisi tugas
## Melihat acara di tingkat cluster
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Pilih **Klaster**.
Halaman daftar cluster ditampilkan.
1. Pilih cluster.
Halaman detail cluster ditampilkan.
1. Di bawah **Sejarah**, tentukan peristiwa yang akan dilihat.
1. Untuk melihat peristiwa tindakan layanan, pilih **Acara tindakan layanan**.
1. Untuk melihat peristiwa perubahan status tugas, pilih **Peristiwa perubahan status tugas**.
1. (Opsional) Dalam **kriteria Kueri**, masukkan filter untuk acara yang ingin Anda lihat.
1. Pilih **Run query** (Jalankan kueri).
Acara ditampilkan dalam daftar.
1. Untuk melihat detail lengkap acara, pilih acara.
## Melihat di tingkat layanan
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Pada halaman **Clusters**, pilih cluster.
1. Pada halaman detail cluster, di bagian **Layanan**, pilih layanan.
Halaman detail layanan ditampilkan.
1. Di bawah **Sejarah**, tentukan peristiwa yang akan dilihat.
1. Untuk melihat peristiwa tindakan layanan, pilih **Acara tindakan layanan**.
1. Untuk melihat peristiwa perubahan status tugas, pilih **Peristiwa perubahan status tugas**.
1. (Opsional) Dalam **kriteria Kueri**, masukkan filter untuk acara yang ingin Anda lihat.
1. Pilih **Run query** (Jalankan kueri).
Acara ditampilkan dalam daftar.
1. Untuk melihat detail lengkap acara, pilih acara.
# Memecahkan masalah kesalahan kesalahan CPU atau memori Amazon ECS definisi tugas yang tidak valid
Saat mendaftarkan definisi tugas menggunakan Amazon ECS API atau AWS CLI, jika Anda menentukan `memory` nilai `cpu` atau tidak valid, kesalahan berikut akan ditampilkan.
```
An error occurred (ClientException) when calling the RegisterTaskDefinition operation: Invalid 'cpu' setting for task.
```
**catatan**
Saat menggunakan Terraform, kesalahan berikut mungkin dikembalikan.
```
Error: ClientException: No Fargate configuration exists for given values.
```
Untuk mengatasi masalah ini, Anda harus menentukan nilai yang didukung untuk tugas CPU serta memori dalam ketentuan tugas Anda. `cpu`Nilai dapat dinyatakan dalam unit CPU atau v CPUs dalam definisi tugas. Ini dikonversi ke bilangan bulat yang menunjukkan unit CPU ketika definisi tugas terdaftar. `memory`Nilai dapat dinyatakan dalam MiB atau GB dalam definisi tugas. Ini dikonversi ke bilangan bulat yang menunjukkan MiB ketika definisi tugas terdaftar.
Untuk definisi tugas yang menentukan `FARGATE` `requiresCompatibilities` parameter (bahkan jika juga `EC2` ditentukan), Anda harus menggunakan salah satu nilai dalam tabel berikut. Nilai-nilai ini menentukan rentang nilai yang didukung untuk CPU dan parameter memori.
Untuk tugas yang dihosting di Fargate, tabel berikut menunjukkan kombinasi CPU dan memori yang valid. Nilai memori dalam file JSON ditentukan dalam MiB. Anda dapat mengonversi nilai GB ke MiB dengan mengalikan nilainya dengan 1024. Misalnya 1 GB = 1024 MiB.
| Nilai CPU | Nilai memori | Sistem operasi yang didukung untuk AWS Fargate |
| --- | --- | --- |
| 256 (.25 vCPU) | 512 MiB, 1 GB, 2 GB | Linux |
| 512 (.5 vCPU) | 1 GB, 2 GB, 3 GB, 4 GB | Linux |
| 1024 (1 vCPU) | 2 GB, 3 GB, 4 GB, 5 GB, 6 GB, 7 GB, 8 GB | Linux, Windows |
| 2048 (2 vCPU) | Antara 4 GB dan 16 GB dalam peningkatan 1 GB | Linux, Windows |
| 4096 (4 vCPU) | Antara 8 GB dan 30 GB dalam peningkatan 1 GB | Linux, Windows |
| 8192 (8 vCPU) Opsi ini membutuhkan platform Linux `1.4.0` atau yang lebih baru. | Antara 16 GB dan 60 GB dalam peningkatan 4 GB | Linux |
| 16384 (16vCPU) Opsi ini membutuhkan platform Linux `1.4.0` atau yang lebih baru. | Antara 32 GB dan 120 GB dalam peningkatan 8 GB | Linux |
Untuk tugas yang dihosting di Amazon EC2, nilai CPU tugas yang didukung adalah antara 0,25 v CPUs dan 192 v. CPUs
Mekanisme kontrol CPU berbeda antara EC2 dan Fargate:
+ Untuk tugas yang dihosting di Amazon EC2: Amazon ECS menggunakan periode CPU dan kuota CPU untuk mengontrol batas keras CPU ukuran tugas. Saat Anda menentukan vCPU dalam definisi tugas, Amazon ECS menerjemahkan nilai ke periode CPU dan setelan kuota CPU yang berlaku untuk. `cgroup`
+ Untuk tugas yang dihosting di Fargate: Amazon ECS menggunakan pembagian CPU untuk mengontrol alokasi CPU. Kuota CPU dan nilai periode tidak digunakan untuk membatasi CPU dalam tugas Fargate.
Untuk tugas Amazon EC2, kuota CPU mengontrol jumlah waktu CPU yang diberikan kepada a `cgroup` selama periode CPU tertentu. Kedua pengaturan dinyatakan dalam mikrodetik. Ketika kuota CPU sama dengan periode CPU berarti `cgroup` dapat mengeksekusi hingga 100% pada satu vCPU (atau fraksi lain yang totalnya 100% untuk beberapa v). CPUs Kuota CPU memiliki maksimum 1000000us dan periode CPU minimal 1ms. Anda dapat menggunakan nilai-nilai ini untuk menetapkan batas jumlah CPU Anda. Ketika Anda mengubah periode CPU tanpa mengubah kuota CPU, Anda memiliki batas efektif yang berbeda dari yang telah Anda tentukan dalam definisi tugas Anda.
Periode 100ms memungkinkan v CPUs mulai dari 0,125 hingga 10.
**catatan**
Tingkat tugas CPU dan memori parameter diabaikan untuk Windows kontainer.
# Melihat log agen kontainer Amazon ECS
Amazon ECS menyimpan log di `/var/log/ecs` folder instans penampung Anda. Ada log yang tersedia dari agen kontainer Amazon ECS dan dari `ecs-init` layanan yang mengontrol status agen (start/stop) pada instance container. Anda dapat melihat berkas log ini dengan menghubungkan ke instans kontainer menggunakan SSH.
**catatan**
Jika Anda tidak yakin cara mengumpulkan semua log pada instans kontainer Anda, Anda dapat menggunakan kolektor log Amazon ECS. Untuk informasi selengkapnya, lihat [Mengumpulkan log kontainer dengan kolektor log Amazon ECS](ecs-logs-collector.md).
## Sistem operasi Linux
Proses `ecs-init` menyimpan log di `/var/log/ecs/ecs-init.log`.
`ecs-init.log`File tersebut berisi informasi tentang manajemen siklus hidup agen kontainer, konfigurasi, dan bootstrap.
Anda dapat menggunakan perintah berikut untuk melihat file log.
```
cat /var/log/ecs/ecs-init.log
```
Output:
```
2018-02-16T18:13:54Z [INFO] pre-start
2018-02-16T18:13:56Z [INFO] start
2018-02-16T18:13:56Z [INFO] No existing agent container to remove.
2018-02-16T18:13:56Z [INFO] Starting Amazon Elastic Container Service Agent
```
## Sistem operasi Windows
Anda dapat menggunakan kolektor log Amazon ECS untuk Windows. Untuk informasi selengkapnya, lihat [Amazon ECS Logs Collector Untuk Windows](https://github.com/awslabs/aws-ecs-logs-collector-for-windows?tab=readme-ov-file#aws-ecs-logs-collector-for-windows) di Github.
1. Terhubung ke instans Anda.
1. Buka PowerShell dan kemudian jalankan perintah berikut dengan hak administratif. Perintah mengunduh skrip dan mengumpulkan log.
```
Invoke-WebRequest -OutFile ecs-logs-collector.ps1 https://raw.githubusercontent.com/awslabs/aws-ecs-logs-collector-for-windows/master/ecs-logs-collector.ps1
.\ecs-logs-collector.ps1
```
Anda dapat mengaktifkan logging debug untuk agen Amazon ECS dan daemon Docker. Opsi ini memungkinkan skrip untuk mengumpulkan log sebelum mengaktifkan mode debug. Skrip memulai ulang daemon Docker dan agen Amazon ECS, dan kemudian menghentikan semua kontainer yang berjalan pada instance. Sebelum menjalankan perintah berikut, tiriskan instance kontainer dan pindahkan tugas penting apa pun ke instance kontainer lainnya.
Jalankan perintah berikut untuk mengaktifkan logging.
```
.\ecs-logs-collector.ps1 -RunMode debug
```
# Mengumpulkan log kontainer dengan kolektor log Amazon ECS
**catatan**
Anda tidak dapat menggunakan kolektor log Amazon ECS di Instans Terkelola Amazon ECS.
Jika Anda tidak yakin cara mengumpulkan semua log yang berbeda pada instans kontainer Anda, Anda dapat menggunakan kolektor log Amazon ECS. Ini tersedia GitHub untuk [Linux](https://github.com/awslabs/ecs-logs-collector) dan [Windows](https://github.com/awslabs/aws-ecs-logs-collector-for-windows). Skrip mengumpulkan log sistem operasi umum serta log agen kontainer Docker dan Amazon ECS, yang dapat membantu untuk memecahkan masalah kasus. AWS Dukungan Kemudian informasi yang dikumpulkan dikompres dan diarsipkan ke dalam satu file yang dapat dengan mudah dibagikan untuk tujuan diagnostik. Ini juga mendukung mengaktifkan mode debug untuk daemon Docker dan agen kontainer Amazon ECS pada varian Amazon Linux, seperti AMI Amazon ECS yang dioptimalkan.
**catatan**
Di Amazon Linux Amazon ECS AMIs versi yang dioptimalkan 20250909 dan yang lebih baru, kolektor log Amazon ECS sudah diinstal sebelumnya `/opt/amazon/ecs/ecs-logs-collector.sh` dan siap digunakan tanpa mengunduh. GitHub Untuk informasi selengkapnya, lihat [ECS Logs Collector di dokumentasi](https://github.com/aws/amazon-ecs-ami?tab=readme-ov-file#ecs-logs-collector) AMI yang dioptimalkan oleh ECS.
Saat ini, kolektor log Amazon ECS mendukung sistem operasi berikut:
+ Amazon Linux
+ Linux Red Hat Enterprise
+ Ubuntu
+ Windows Server
**Untuk menjalankan kolektor log Amazon ECS untuk Linux (AMI yang dioptimalkan ECS)**
1. Hubungkan menuju instans kontainer Anda.
1. Jalankan penulisan untuk mengumpulkan catatan dan membuat arsip.
**catatan**
Untuk mengaktifkan mode debug untuk daemon Docker dan agen penampung Amazon ECS, tambahkan `--mode=enable-debug` opsi ke perintah berikut. Ini mungkin memulai ulang daemon Docker, yang membunuh semua kontainer yang berjalan pada instance. Pertimbangkan pengurasan pada instans kontainer dan pemindahan tugas-tugas penting untuk instans kontainer lainnya sebelum mengaktifkan mode debug. Untuk informasi selengkapnya, lihat [Menguras instans kontainer Amazon ECS](container-instance-draining.md).
```
[ec2-user ~]$ sudo /opt/amazon/ecs/ecs-logs-collector.sh
```
Setelah Anda menjalankan penulisannya, Anda dapat memeriksa catatan yang dikumpulkan di folder `collect` yang dibuat oleh penulisan. `collect.tgz`File ini adalah arsip terkompresi dari semua log, yang dapat Anda bagikan AWS Dukungan untuk bantuan diagnostik.
**Untuk mengunduh dan menjalankan kolektor log Amazon ECS untuk Linux**
1. Hubungkan menuju instans kontainer Anda.
1. Unduh skrip kolektor log Amazon ECS.
```
curl -O https://raw.githubusercontent.com/awslabs/ecs-logs-collector/master/ecs-logs-collector.sh
```
1. Jalankan penulisan untuk mengumpulkan catatan dan membuat arsip.
```
$ sudo bash ./ecs-logs-collector.sh
```
**Untuk mengunduh dan menjalankan kolektor log Amazon ECS untuk Windows**
1. Hubungkan menuju instans kontainer Anda. Untuk informasi selengkapnya, lihat [Connect ke instans Windows menggunakan RDP](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html) di Panduan Pengguna *Amazon EC2*.
1. Unduh skrip kolektor log Amazon ECS menggunakan PowerShell.
```
Invoke-WebRequest -OutFile ecs-logs-collector.ps1 https://raw.githubusercontent.com/awslabs/aws-ecs-logs-collector-for-windows/master/ecs-logs-collector.ps1
```
1. Jalankan penulisan untuk mengumpulkan catatan dan membuat arsip.
**catatan**
Untuk mengaktifkan mode debug untuk daemon Docker dan agen penampung Amazon ECS, tambahkan `-RunMode debug` opsi ke perintah berikut. Ini akan memulai kembali daemon Docker, yang menghancurkan semua kontainer yang berjalan pada instans. Pertimbangkan pengurasan instans kontainer dan pemindahan tugas-tugas penting untuk instans kontainer lainnya sebelum mengaktifkan mode debug. Untuk informasi selengkapnya, lihat [Menguras instans kontainer Amazon ECS](container-instance-draining.md).
```
.\ecs-logs-collector.ps1
```
Setelah Anda menjalankan penulisannya, Anda dapat memeriksa catatan yang dikumpulkan di folder `collect` yang dibuat oleh penulisan. `collect.tgz`File ini adalah arsip terkompresi dari semua log, yang dapat Anda bagikan dengan AWS Support for diagnostic help.
# Ambil detail diagnostik Amazon ECS dengan introspeksi agen
API introspeksi agen Amazon ECS memberikan informasi tentang keadaan keseluruhan agen Amazon ECS dan instans kontainer.
Anda dapat menggunakan API introspeksi agen untuk mendapatkan ID Docker untuk wadah dalam tugas Anda. Anda dapat menggunakan API introspeksi agen dengan menghubungkan ke instans kontainer menggunakan SSH.
**penting**
Instance container Anda harus memiliki peran IAM yang memungkinkan akses ke Amazon ECS untuk mencapai API introspeksi. Untuk informasi selengkapnya, lihat [Peran IAM instans kontainer Amazon ECS](instance_IAM_role.md).
Contoh berikut menunjukkan dua tugas, satu yang sedang berjalan dan satu yang dihentikan.
**catatan**
Perintah berikut disalurkan melalui **python -mjson.tool** untuk keterbacaan yang lebih besar.
```
curl http://localhost:51678/v1/tasks | python -mjson.tool
```
Output:
```
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1095 100 1095 0 0 117k 0 --:--:-- --:--:-- --:--:-- 133k
{
"Tasks": [
{
"Arn": "arn:aws:ecs:us-west-2:aws_account_id:task/090eff9b-1ce3-4db6-848a-a8d14064fd24",
"Containers": [
{
"DockerId": "189a8ff4b5f04affe40e5160a5ffadca395136eb5faf4950c57963c06f82c76d",
"DockerName": "ecs-console-sample-app-static-6-simple-app-86caf9bcabe3e9c61600",
"Name": "simple-app"
},
{
"DockerId": "f7f1f8a7a245c5da83aa92729bd28c6bcb004d1f6a35409e4207e1d34030e966",
"DockerName": "ecs-console-sample-app-static-6-busybox-ce83ce978a87a890ab01",
"Name": "busybox"
}
],
"Family": "console-sample-app-static",
"KnownStatus": "STOPPED",
"Version": "6"
},
{
"Arn": "arn:aws:ecs:us-west-2:aws_account_id:task/1810e302-eaea-4da9-a638-097bea534740",
"Containers": [
{
"DockerId": "dc7240fe892ab233dbbcee5044d95e1456c120dba9a6b56ec513da45c38e3aeb",
"DockerName": "ecs-console-sample-app-static-6-simple-app-f0e5859699a7aecfb101",
"Name": "simple-app"
},
{
"DockerId": "096d685fb85a1ff3e021c8254672ab8497e3c13986b9cf005cbae9460b7b901e",
"DockerName": "ecs-console-sample-app-static-6-busybox-92e4b8d0ecd0cce69a01",
"Name": "busybox"
}
],
"DesiredStatus": "RUNNING",
"Family": "console-sample-app-static",
"KnownStatus": "RUNNING",
"Version": "6"
}
]
}
```
Pada contoh sebelumnya, tugas yang dihentikan (*090eff9b-1ce3-4db6-848a-a8d14064fd24*) memiliki dua kontainer. Anda dapat menggunakan **docker inspect *container-ID*** untuk melihat informasi detail pada setiap kontainer. Untuk informasi selengkapnya, lihat [Introspeksi wadah Amazon ECS](ecs-agent-introspection.md).
# Diagnostik Docker di Amazon ECS
Docker menyediakan beberapa alat diagnostik yang membantu Anda memecahkan masalah dengan kontainer dan tugas Anda. Untuk informasi selengkapnya tentang semua utilitas baris perintah Docker yang tersedia, lihat [referensi CLI Docker](https://docs.docker.com/reference/cli/docker/) dalam dokumentasi Docker. Anda dapat mengakses utilitas baris perintah Docker dengan menghubungkan ke instans kontainer menggunakan SSH.
Kode keluar yang Docker kontainer laporkan juga dapat memberikan beberapa informasi diagnostik (misalnya, kode keluar 137 berarti bahwa kontainer menerima sinyal `SIGKILL`). Untuk informasi selengkapnya, lihat [Status Keluar](https://docs.docker.com/reference/cli/docker/container/run/#exit-status) dalam dokumentasi Docker.
## Daftar kontainer Docker di Amazon ECS
Anda dapat menggunakan perintah **docker ps** pada instans kontainer Anda untuk membuat daftar pada kontainer yang berjalan. Dalam contoh berikut, hanya agen penampung Amazon ECS yang berjalan. Untuk informasi selengkapnya, lihat [docker ps](https://docs.docker.com/reference/cli/docker/#ps) di dokumentasi Docker.
```
docker ps
```
Output:
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
cee0d6986de0 amazon/amazon-ecs-agent:latest "/agent" 22 hours ago Up 22 hours 127.0.0.1:51678->51678/tcp ecs-agent
```
Anda dapat menggunakan perintah **docker ps -a** untuk melihat semua kontainer (bahkan berhenti atau menghancurkan kontainer). Hal ini sangat membantu untuk membuat daftar kontainer yang tiba-tiba berhenti. Pada contoh berikut, kontainer `f7f1f8a7a245` keluar 9 detik yang lalu, sehingga tidak muncul dalam output **docker ps** tanpa bendera `-a`.
```
docker ps -a
```
Output:
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
db4d48e411b1 amazon/ecs-emptyvolume-base:autogenerated "not-applicable" 19 seconds ago ecs-console-sample-app-static-6-internalecs-emptyvolume-source-c09288a6b0cba8a53700
f7f1f8a7a245 busybox:buildroot-2014.02 "\"sh -c '/bin/sh -c 22 hours ago Exited (137) 9 seconds ago ecs-console-sample-app-static-6-busybox-ce83ce978a87a890ab01
189a8ff4b5f0 httpd:2 "httpd-foreground" 22 hours ago Exited (137) 40 seconds ago ecs-console-sample-app-static-6-simple-app-86caf9bcabe3e9c61600
0c7dca9321e3 amazon/ecs-emptyvolume-base:autogenerated "not-applicable" 22 hours ago ecs-console-sample-app-static-6-internalecs-emptyvolume-source-90fefaa68498a8a80700
cee0d6986de0 amazon/amazon-ecs-agent:latest "/agent" 22 hours ago Up 22 hours 127.0.0.1:51678->51678/tcp ecs-agent
```
## Lihat Log Docker di Amazon ECS
Anda dapat melihat `STDOUT` dan mengalirkan `STDERR` untuk kontainer dengan perintah **docker logs**. Dalam contoh ini, log ditampilkan untuk *dc7240fe892a* wadah dan disalurkan melalui **head** perintah untuk singkatnya. Untuk informasi selengkapnya, kunjungi [log docker](https://docs.docker.com/reference/cli/docker/#logs) dalam dokumentasi Docker.
**catatan**
Catatan Docker hanya tersedia pada instans kontainer jika Anda menggunakan log driver `json` default. Jika Anda telah mengonfigurasi tugas Anda untuk menggunakan driver `awslogs` log, maka log kontainer Anda tersedia di CloudWatch Log. Untuk informasi selengkapnya, lihat [Kirim log Amazon ECS ke CloudWatch](using_awslogs.md).
```
docker logs dc7240fe892a | head
```
Output:
```
AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.17.0.11. Set the 'ServerName' directive globally to suppress this message
AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.17.0.11. Set the 'ServerName' directive globally to suppress this message
[Thu Apr 23 19:48:36.956682 2015] [mpm_event:notice] [pid 1:tid 140327115417472] AH00489: Apache/2.4.12 (Unix) configured -- resuming normal operations
[Thu Apr 23 19:48:36.956827 2015] [core:notice] [pid 1:tid 140327115417472] AH00094: Command line: 'httpd -D FOREGROUND'
10.0.1.86 - - [23/Apr/2015:19:48:59 +0000] "GET / HTTP/1.1" 200 348
10.0.0.154 - - [23/Apr/2015:19:48:59 +0000] "GET / HTTP/1.1" 200 348
10.0.1.86 - - [23/Apr/2015:19:49:28 +0000] "GET / HTTP/1.1" 200 348
10.0.0.154 - - [23/Apr/2015:19:49:29 +0000] "GET / HTTP/1.1" 200 348
10.0.1.86 - - [23/Apr/2015:19:49:50 +0000] "-" 408 -
10.0.0.154 - - [23/Apr/2015:19:49:50 +0000] "-" 408 -
10.0.1.86 - - [23/Apr/2015:19:49:58 +0000] "GET / HTTP/1.1" 200 348
10.0.0.154 - - [23/Apr/2015:19:49:59 +0000] "GET / HTTP/1.1" 200 348
10.0.1.86 - - [23/Apr/2015:19:50:28 +0000] "GET / HTTP/1.1" 200 348
10.0.0.154 - - [23/Apr/2015:19:50:29 +0000] "GET / HTTP/1.1" 200 348
time="2015-04-23T20:11:20Z" level="fatal" msg="write /dev/stdout: broken pipe"
```
## Periksa Kontainer Docker di Amazon ECS
Jika Anda memiliki ID Docker dari sebuah kontainer, Anda dapat memeriksanya dengan perintah **docker inspect**. Memeriksa kontainer memberikan pandangan paling detail tentang lingkungan tempat kontainer telah diluncurkan. Untuk informasi selengkapnya, lihat [pemeriksaan docker](https://docs.docker.com/reference/cli/docker/#inspect) dalam dokumentasi Docker.
```
docker inspect dc7240fe892a
```
Output:
```
[{
"AppArmorProfile": "",
"Args": [],
"Config": {
"AttachStderr": false,
"AttachStdin": false,
"AttachStdout": false,
"Cmd": [
"httpd-foreground"
],
"CpuShares": 10,
"Cpuset": "",
"Domainname": "",
"Entrypoint": null,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/apache2/bin",
"HTTPD_PREFIX=/usr/local/apache2",
"HTTPD_VERSION=2.4.12",
"HTTPD_BZ2_URL=https://www.apache.org/dist/httpd/httpd-2.4.12.tar.bz2"
],
"ExposedPorts": {
"80/tcp": {}
},
"Hostname": "dc7240fe892a",
...
```
# Mengkonfigurasi output verbose dari daemon Docker di Amazon ECS
Jika Anda mengalami masalah dengan wadah atau gambar Docker, Anda dapat mengaktifkan mode debug pada daemon Docker Anda. Menggunakan debugging memberikan lebih banyak output verbose dari daemon, Anda dapat menggunakan ini untuk mengambil pesan kesalahan yang dikirim dari pendaftar kontainer, seperti Amazon ECR.
**penting**
Prosedur ini ditulis untuk Amazon ECS yang dioptimalkan Amazon Linux AMI. Untuk sistem operasi lain, lihat [Aktifkan debugging](https://docs.docker.com/engine/admin/#enable-debugging) dan [Kontrol dan konfigurasikan Docker dengan systemd]() dokumentasi Docker.
**Untuk menggunakan mode debug daemon Docker di Amazon ECS Amazon Linux AMI yang dioptimalkan Amazon**
1. Hubungkan menuju instans kontainer Anda.
1. Buka file pilihan Docker dengan editor teks, seperti **vi**. Untuk Amazon ECS yang dioptimalkan Amazon Linux AMI, file opsi Docker ada di. `/etc/sysconfig/docker`
1. Cari pernyataan opsi Docker dan menambahkan pilihan `-D` untuk string, di dalam tanda kutip.
**catatan**
Jika pernyataan pilihan Docker dimulai dengan `#`, hapus karakter tersebut untuk menghapus pernyataan dan aktifkan pilihan.
Untuk Amazon ECS yang dioptimalkan Amazon Linux AMI, pernyataan opsi Docker disebut. `OPTIONS` Contoh:
```
# Additional startup options for the Docker daemon, for example:
# OPTIONS="--ip-forward=true --iptables=true"
# By default we limit the number of open files per container
OPTIONS="-D --default-ulimit nofile=1024:4096"
```
1. Simpan file, dan tutup editor teks Anda.
1. Mulai ulang daemon Docker.
```
sudo service docker restart
```
Outputnya adalah sebagai berikut:
```
Stopping docker: [ OK ]
Starting docker: . [ OK ]
```
1. Mulai ulang agen Amazon ECS.
```
sudo service ecs restart
```
Catatan Docker Anda sekarang harus menampilkan lebih banyak output verbose.
```
time="2015-12-30T21:48:21.907640838Z" level=debug msg="Unexpected response from server: \"{\\\"errors\\\":[{\\\"code\\\":\\\"DENIED\\\",\\\"message\\\":\\\"User: arn:aws:sts::1111:assumed-role/ecrReadOnly/i-abcdefg is not authorized to perform: ecr:InitiateLayerUpload on resource: arn:aws:ecr:us-east-1:1111:repository/nginx_test\\\"}]}\\n\" http.Header{\"Connection\":[]string{\"keep-alive\"}, \"Content-Type\":[]string{\"application/json; charset=utf-8\"}, \"Date\":[]string{\"Wed, 30 Dec 2015 21:48:21 GMT\"}, \"Docker-Distribution-Api-Version\":[]string{\"registry/2.0\"}, \"Content-Length\":[]string{\"235\"}}"
```
# Memecahkan masalah Docker di Amazon `API error (500): devmapper` ECS
Kesalahan pada Docker berikut ini menunjukkan bahwa penyimpanan kolam yang tipis pada instans kontainer Anda sudah penuh, dan daemon Docker tidak dapat membuat kontainer baru:
```
CannotCreateContainerError: API error (500): devmapper: Thin Pool has 4350 free data blocks which is less than minimum required 4454 free data blocks. Create more free space in thin pool or use dm.min_free_space option to change behavior
```
Secara default, Amazon ECS mengoptimalkan Amazon Linux AMIs dari versi `2015.09.d` dan kemudian diluncurkan dengan volume 8-GiB untuk sistem operasi yang terpasang `/dev/xvda` dan dipasang sebagai root sistem file. Terdapat tambahan volume 22-GiB yang terlampirkan di `/dev/xvdcz` yang Docker gunakan untuk penyimpanan citra dan metadata. Jika ruang penyimpanan ini terisi, daemon Docker tidak dapat membuat kontainer baru.
Cara termudah untuk menambahkan penyimpanan ke instans kontainer Anda adalah dengan mengakhiri instans yang sudah ada dan meluncurkan instans yang baru dengan volume penyimpanan data yang lebih besar. Namun, jika Anda tidak dapat melakukannya, Anda dapat menambahkan penyimpanan ke grup volume yang Docker gunakan dan memperpanjang logika volume dengan mengikuti prosedur di [Linux Amazon ECS yang dioptimalkan AMIs](ecs-optimized_AMI.md).
Jika penyimpanan instans kontainer Anda terlalu cepat terisi, ada beberapa tindakan yang dapat Anda ambil untuk mengurangi efek ini:
+ Untuk melihat informasi jajak pendapat tipis, jalankan perintah berikut pada instance container Anda:
```
docker info
```
+ (Agen kontainer Amazon ECS 1.8.0 dan yang lebih baru) Anda dapat mengurangi jumlah waktu penampung yang berhenti atau keluar tetap pada instance penampung Anda. Parameter variabel konfigurasi agen `ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION` menetapkan durasi waktu untuk menunggu dari saat tugas dihentikan hingga kontainer Docker dihapus (secara default, nilai ini adalah 3 jam). Hal ini akan menghapus data kontainer Docker. Jika nilai ini disetel terlalu rendah, Anda mungkin tidak dapat memeriksa kontainer yang dihentikan atau melihat log sebelum dihapus. Untuk informasi selengkapnya, lihat [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).
+ Anda dapat menghapus kontainer yang tidak berjalan dan gambar yang tidak digunakan dari instance penampung Anda. Anda dapat menggunakan contoh perintah berikut ini untuk menghapus kontainer yang berhenti secara manual dan citra yang tidak terpakai. Kontainer yang dihapus nantinya tidak dapat diperiksa, dan citra yang dihapus harus ditarik lagi sebelum memulai kontainer yang baru dari citra tersebut.
Untuk menghapus kontainer yang tidak berjalan, jalankan perintah berikut pada instance container Anda:
```
docker rm $(docker ps -aq)
```
Untuk menghapus gambar yang tidak digunakan, jalankan perintah berikut pada instance container Anda:
```
docker rmi $(docker images -q)
```
+ Anda dapat menghapus blok data yang tidak digunakan dalam wadah. Anda dapat menggunakan perintah berikut ini untuk menjalankan **fstrim** pada setiap kontainer yang berjalan dan membuang setiap blok data yang tidak digunakan oleh sistem file kontainer.
```
sudo sh -c "docker ps -q | xargs docker inspect --format='{{ .State.Pid }}' | xargs -IZ fstrim /proc/Z/root/"
```
# Memecahkan masalah Amazon ECS Exec
Berikut ini adalah catatan pemecahan masalah untuk membantu mendiagnosis mengapa Anda mungkin mendapatkan kesalahan saat menggunakan ECS Exec.
## Verifikasi menggunakan Pemeriksa Exec
Skrip ECS Exec Checker menyediakan cara untuk memverifikasi dan memvalidasi bahwa cluster dan tugas Amazon ECS Anda telah memenuhi prasyarat untuk menggunakan fitur ECS Exec. Skrip ECS Exec Checker memverifikasi AWS CLI lingkungan dan cluster Anda dan tugas siap untuk ECS Exec, dengan memanggil berbagai atas nama Anda. APIs Alat ini membutuhkan versi terbaru dari AWS CLI dan yang `jq` tersedia. Untuk informasi lebih lanjut, lihat [ECS Exec Checker](https://github.com/aws-containers/amazon-ecs-exec-checker) di. GitHub
## Terjadi kesalahan saat memanggil `execute-command`
Jika terjadi kesalahan `The execute command failed`, berikut ini kemungkinan penyebabnya.
+ Tugas tidak memiliki izin yang diperlukan. Verifikasi bahwa definisi tugas yang digunakan untuk meluncurkan tugas Anda memiliki peran IAM tugas yang ditentukan dan peran tersebut memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat [Izin ECS Exec](task-iam-roles.md#ecs-exec-required-iam-permissions).
+ Agen SSM tidak diinstal atau tidak berjalan.
+ Ada antarmuka titik akhir Amazon VPC untuk Amazon ECS, tetapi tidak ada satu untuk Systems Manager Session Manager.
# Memecahkan masalah Amazon ECS Anywhere
Amazon ECS Anywhere menyediakan dukungan untuk mendaftarkan instans *eksternal* seperti server lokal atau mesin virtual (VM) ke kluster Amazon ECS Anda. Berikut ini adalah permasalahan umum yang mungkin Anda alami serta rekomendasi pemecahan terhadap masalah umum yang mungkin Anda alami.
**Topics**
+ [Permasalahan registrasi instans eksternal](#ecs-anywhere-troubleshooting-registration)
+ [Masalah jaringan instans eksternal](#ecs-anywhere-troubleshooting-networking)
+ [Masalah menjalankan tugas pada instans eksternal](#ecs-anywhere-troubleshooting-runtask)
## Permasalahan registrasi instans eksternal
Saat mendaftarkan instans eksternal dengan cluster Amazon ECS Anda, persyaratan berikut harus dipenuhi:
+ AWS Systems Manager Aktivasi, yang terdiri dari *ID aktivasi* dan *kode aktivasi*, harus diambil. Anda menggunakannya untuk mendaftarkan instance eksternal sebagai instans terkelola Systems Manager. Ketika aktivasi Systems Manager diminta, tentukan batas pendaftaran dan tanggal kedaluwarsa. Batas pendaftaran tersebut menentukan jumlah maksimum instans yang dapat didaftarkan dengan menggunakan aktivasi. Nilai default untuk batas pendaftaran adalah `1` instance. Tanggal kedaluwarsa menentukan kapan aktivasi akan berakhir. Nilai default adalah 24 jam. Jika aktivasi Systems Manager yang Anda gunakan untuk mendaftarkan instance eksternal Anda tidak valid, mintalah yang baru. Untuk informasi selengkapnya, lihat [Mendaftarkan instans eksternal ke kluster Amazon ECS](ecs-anywhere-registration.md).
+ Kebijakan IAM digunakan untuk memberikan instans eksternal Anda izin yang diperlukan untuk berkomunikasi dengan operasi AWS API. Jika kebijakan terkelola ini tidak dibuat dengan benar dan tidak memiliki izin yang diperlukan, pendaftaran instans eksternal akan gagal. Untuk informasi selengkapnya, lihat [Peran IAM Amazon ECS Anywhere](iam-role-ecsanywhere.md).
+ Amazon ECS menyediakan skrip instalasi yang menginstal Docker, agen penampung Amazon ECS, dan Agen Systems Manager pada instans eksternal Anda. Jika penulisan pada penginstalan gagal, penulisan kemungkinan tidak dapat dijalankan lagi pada instans yang sama tanpa terjadinya sebuah kesalahan. Jika ini terjadi, ikuti proses pembersihan untuk menghapus AWS sumber daya dari instance sehingga Anda dapat menjalankan skrip instalasi lagi. Untuk informasi selengkapnya, lihat [Membatalkan pendaftaran instans eksternal Amazon ECS](ecs-anywhere-deregistration.md).
**catatan**
Ketahuilah bahwa, jika skrip instalasi berhasil meminta dan menggunakan aktivasi Systems Manager, menjalankan skrip instalasi untuk kedua kalinya menggunakan aktivasi Systems Manager lagi. Hal ini dapat menyebabkan Anda mencapai batas pendaftaran untuk aktivasi tersebut. Jika batas ini tercapai, Anda harus membuat aktivasi baru.
+ Saat menjalankan skrip instalasi pada instance eksternal untuk beban kerja GPU, jika driver NVIDIA tidak terdeteksi atau dikonfigurasi dengan benar, kesalahan akan terjadi. Skrip instalasi menggunakan `nvidia-smi` perintah untuk mengkonfirmasi keberadaan driver NVIDIA.
## Masalah jaringan instans eksternal
Untuk dapat mengomunikasikan perubahan apa pun, instans eksternal Anda memerlukan koneksi jaringan ke AWS. Jika instans eksternal Anda kehilangan koneksi jaringannya AWS, tugas yang berjalan pada instance Anda tetap berjalan kecuali dihentikan secara manual. Setelah sambungan ke AWS dipulihkan, AWS kredensyal yang digunakan oleh agen penampung Amazon ECS dan Agen Systems Manager pada instans eksternal diperpanjang secara otomatis. Untuk informasi selengkapnya tentang AWS domain yang digunakan untuk komunikasi antara instans eksternal Anda dan AWS, lihat[Jaringan](ecs-anywhere.md#ecs-anywhere-networking).
## Masalah menjalankan tugas pada instans eksternal
Jika tugas atau kontainer Anda gagal dijalanan pada instans eksternal Anda, penyebab paling umum adalah terkait dengan jaringan atau izin. Jika kontainer Anda menarik gambarnya dari Amazon ECR atau dikonfigurasi untuk mengirim log kontainer ke CloudWatch Log, definisi tugas Anda harus menentukan peran IAM eksekusi tugas yang valid. Tanpa peran IAM eksekusi tugas yang valid, kontainer Anda akan gagal untuk memulai. Untuk informasi selengkapnya tentang permasalahan yang berkaitan dengan jaringan, lihat [Masalah jaringan instans eksternal](#ecs-anywhere-troubleshooting-networking).
**penting**
Amazon ECS menyediakan alat pengumpulan log Amazon ECS. Anda dapat menggunakannya untuk mengumpulkan catatan dari instans eksternal Anda dengan tujuan memecahkan permasalahan. Untuk informasi selengkapnya, lihat [Mengumpulkan log kontainer dengan kolektor log Amazon ECS](ecs-logs-collector.md).
# Memecahkan masalah pemuatan kelas Java di Fargate
Aplikasi Java yang berjalan di Fargate mungkin mengalami masalah pemuatan kelas setelah pembaruan platform, terutama ketika aplikasi bergantung pada perilaku pemuatan kelas non-deterministik. Ini dapat bermanifestasi sebagai kesalahan injeksi ketergantungan, kegagalan Spring Boot, atau pengecualian runtime lainnya yang tidak ada dalam penerapan sebelumnya.
## Gejala
Anda mungkin mengalami gejala-gejala berikut:
+ Kesalahan injeksi ketergantungan Spring Boot
+ ClassNotFoundException atau NoClassDefFoundError pengecualian
+ Aplikasi yang sebelumnya bekerja di Fargate sekarang gagal sebentar-sebentar
+ Gambar wadah yang sama berfungsi di Amazon EC2 tetapi gagal di Fargate
+ Perilaku tidak konsisten di seluruh penerapan dengan gambar kontainer yang identik
## Penyebab
Masalah ini biasanya terjadi karena:
+ **Pemuatan kelas non-deterministik:** Aplikasi Java yang bergantung pada urutan kelas dimuat dari file JAR mungkin gagal ketika platform yang mendasarinya mengubah cara file diakses atau di-cache.
+ **Pembaruan platform: Pembaruan** versi platform Fargate dapat mengubah perilaku sistem file yang mendasarinya, memengaruhi urutan kelas ditemukan dan dimuat.
+ **Ketergantungan pemesanan file JAR:** Aplikasi yang secara implisit mengandalkan urutan pemuatan JAR tertentu tanpa manajemen ketergantungan eksplisit.
## Resolusi
Untuk mengatasi masalah pemuatan kelas Java di Fargate, terapkan praktik pemuatan kelas deterministik:
### Perbaikan segera
Jika Anda membutuhkan solusi segera:
1. **Menerapkan urutan pemuatan JAR:** Tentukan secara eksplisit urutan file JAR harus dimuat dalam konfigurasi classpath aplikasi Anda.
1. **Gunakan manajemen dependensi eksplisit:** Pastikan semua dependensi dideklarasikan secara eksplisit dalam konfigurasi build Anda (Maven, Gradle, dll.) daripada mengandalkan dependensi transitif.
### Praktik terbaik jangka panjang
Terapkan praktik ini untuk mencegah masalah pemuatan kelas masa depan:
1. **Jadikan pemuatan kelas deterministik:**
+ Gunakan deklarasi dependensi eksplisit dalam file build Anda
+ Hindari mengandalkan urutan pemindaian classpath
+ Gunakan alat manajemen ketergantungan untuk menyelesaikan konflik versi
+ Gunakan opsi Java Virtual Machine (JVM) seperti `-verbose:class` untuk mendapatkan informasi tentang kelas yang dimuat oleh JVM.
1. **Aplikasi Spring Boot:**
+ Gunakan `@ComponentScan` dengan paket dasar eksplisit
+ Hindari konflik konfigurasi otomatis dengan mengonfigurasi kacang secara eksplisit
+ Gunakan `@DependsOn` anotasi untuk mengontrol urutan inisialisasi kacang
1. **Membangun konfigurasi:**
+ Gunakan bagian manajemen ketergantungan di Maven atau Gradle
+ Kecualikan dependensi transitif yang menyebabkan konflik
+ Gunakan alat seperti Maven Enforcer Plugin untuk mendeteksi masalah ketergantungan
1. **Pengujian:**
+ Uji aplikasi Anda dengan implementasi JVM yang berbeda
+ Jalankan pengujian integrasi yang mensimulasikan lingkungan penerapan yang berbeda
+ Gunakan alat untuk menganalisis konflik classpath selama pengembangan
## Pencegahan
Untuk mencegah masalah pemuatan kelas Java di penerapan masa depan:
+ **Ikuti praktik pemuatan kelas deterministik:** Rancang aplikasi Anda agar tidak bergantung pada urutan kelas dimuat dari classpath.
+ **Gunakan manajemen dependensi eksplisit:** Selalu deklarasikan secara eksplisit semua dependensi yang diperlukan dan versinya dalam konfigurasi build Anda.
+ **Uji lintas lingkungan:** Uji aplikasi Anda secara teratur di berbagai lingkungan dan versi platform untuk mengidentifikasi potensi masalah lebih awal.
+ **Pantau pembaruan platform:** Tetap terinformasi tentang pembaruan platform Fargate dan uji aplikasi Anda dengan versi platform baru sebelum memengaruhi beban kerja produksi.
# AWS Fargate kuota pelambatan
AWS Fargate membatasi tugas Amazon ECS dan tingkat peluncuran pod Amazon EKS ke kuota (sebelumnya disebut sebagai batas) menggunakan [algoritma token bucket](https://en.wikipedia.org/wiki/Token_bucket) untuk setiap AWS akun berdasarkan per wilayah. Dengan algoritme ini, akun Anda memiliki bucket yang memegang sejumlah tertentu token. Jumlah token dalam bucket mewakili kuota tarif Anda pada detik tertentu. Setiap akun pelanggan memiliki bucket token task dan pods yang habis berdasarkan jumlah tugas dan pod yang diluncurkan oleh akun pelanggan. Bucket token ini memiliki bucket maksimum yang memungkinkan Anda membuat jumlah permintaan yang lebih tinggi secara berkala, dan tingkat isi ulang yang memungkinkan Anda mempertahankan tingkat permintaan yang stabil selama diperlukan.
Misalnya, ukuran bucket token task dan pods untuk akun pelanggan Fargate adalah 100 token, dan tingkat isi ulang adalah 20 token per detik. Oleh karena itu, Anda dapat segera meluncurkan hingga 100 tugas Amazon ECS dan pod Amazon EKS per akun pelanggan, dengan tingkat peluncuran berkelanjutan 20 tugas Amazon ECS dan pod Amazon EKS per detik.
| Tindakan | Kapasitas maksimum bucket (atau Burst rate) | Tingkat isi ulang bucket (atau Tarif berkelanjutan) |
| --- | --- | --- |
| [Kuota tarif Fargate Resource untuk tugas Amazon ECS On Demand dan pod Amazon EKS 1](#fargate-throttling-note-1) | 100 | 20 |
| Kuota tarif Fargate Resource untuk tugas Spot Amazon ECS | 100 | 20 |
1 Akun yang hanya meluncurkan pod Amazon EKS memiliki tingkat burst 20 dengan tingkat peluncuran pod berkelanjutan 20 peluncuran pod per detik saat menggunakan versi platform yang disebut dalam versi platform [Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html).
## Melambatkan `RunTask` API di Fargate
Selain itu, Fargate membatasi tingkat permintaan saat meluncurkan tugas menggunakan Amazon ECS `RunTask` API menggunakan kuota terpisah. Fargate membatasi permintaan Amazon ECS `RunTask` API untuk setiap AWS akun berdasarkan per wilayah. Setiap permintaan yang Anda buat menghapus satu token dari ember. Kami melakukan ini untuk membantu kinerja layanan, dan untuk memastikan penggunaan yang adil untuk semua pelanggan Fargate. Panggilan API tunduk pada kuota permintaan apakah berasal dari konsol Amazon Elastic Container Service, alat baris perintah, atau aplikasi pihak ketiga. Kuota tarif untuk panggilan ke Amazon ECS `RunTask` API adalah 20 panggilan per detik (burst dan berkelanjutan). Namun, setiap panggilan ke API ini dapat meluncurkan hingga 10 tugas. Ini berarti Anda dapat meluncurkan 100 tugas dalam satu detik dengan melakukan 10 panggilan ke API ini, meminta 10 tugas untuk diluncurkan di setiap panggilan. Demikian pula, Anda juga dapat membuat 20 panggilan ke API ini, meminta 5 tugas untuk diluncurkan di setiap panggilan. Untuk informasi selengkapnya tentang pembatasan API untuk Amazon ECS `RunTask` API, lihat pembatasan [permintaan API di Referensi](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) API Amazon ECS.
Dalam praktiknya, tingkat peluncuran tugas dan pod juga tergantung pada pertimbangan lain seperti gambar kontainer yang akan diunduh dan dibongkar, pemeriksaan kesehatan dan integrasi lainnya diaktifkan, seperti mendaftarkan tugas atau pod ke penyeimbang beban. Pelanggan melihat variasi dalam tingkat peluncuran tugas dan pod dibandingkan dengan kuota yang diwakili sebelumnya berdasarkan fitur yang diaktifkan pelanggan.
## Menyesuaikan kuota tingkat di Fargate
Anda dapat meminta kenaikan kuota pembatasan tarif Fargate untuk akun Anda. AWS Untuk informasi selengkapnya, lihat [Meminta peningkatan kuota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) di *Service Quotas Panduan Pengguna*.
# Memecahkan Masalah Instans Terkelola Amazon ECS
Gunakan prosedur berikut untuk memecahkan masalah Instans Terkelola Amazon ECS, termasuk masalah umum, teknik diagnostik, dan langkah penyelesaian.
## Prasyarat
Sebelum memecahkan masalah Instans Terkelola Amazon ECS, pastikan Anda memiliki persyaratan berikut.
+ Diinstal dan dikonfigurasi dengan izin yang sesuai AWS CLI
Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui ke versi terbaru](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dari *Panduan AWS Command Line Interface Pengguna*. AWS Command Line Interface
+ Akses ke klaster dengan penyedia kapasitas Instans Terkelola Amazon ECS. Untuk informasi selengkapnya, lihat [Membuat klaster untuk Instans Terkelola Amazon ECS](create-cluster-managed-instances.md).
## Skenario pemecahan masalah umum
### Melihat log agen kontainer Instans Terkelola Amazon ECS
Anda dapat melihat file log Amazon ECS ini di Instans Terkelola Amazon ECS dengan menghubungkan ke wadah istimewa yang berjalan di instans.
#### Langkah-langkah diagnostik
**Menerapkan wadah debug dengan hak istimewa dan kemampuan Linux sebagai tugas Amazon ECS:**
Mengatur variabel lingkungan berikut.
Ganti *user-input* dengan nilai-nilai Anda.
```
export ECS_CLUSTER_NAME="your-cluster-name"
export AWS_REGION="your-region"
export ACCOUNT_ID="your-account-id"
```
Buat definisi tugas menggunakan file CLI JSON yang disebut. `node-debugger.json`
```
cat << EOF > node-debugger.json
{
"family": "node-debugger",
"taskRoleArn": "arn:aws:iam::${ACCOUNT_ID}:role/ecsTaskExecutionRole",
"executionRoleArn": "arn:aws:iam::${ACCOUNT_ID}:role/ecsTaskExecutionRole",
"cpu": "256",
"memory": "1024",
"networkMode": "host",
"pidMode": "host",
"requiresCompatibilities": ["MANAGED_INSTANCES", "EC2"],
"containerDefinitions": [
{
"name": "node-debugger",
"image": "public.ecr.aws/amazonlinux/amazonlinux:2023",
"essential": true,
"privileged": true,
"command": ["sleep", "infinity"],
"healthCheck": {
"command": ["CMD-SHELL", "echo debugger || exit 1"],
"interval": 30,
"retries": 3,
"timeout": 5
},
"linuxParameters": {
"initProcessEnabled": true
},
"mountPoints": [
{
"sourceVolume": "host-root",
"containerPath": "/host",
"readOnly": false
}
],
"logConfiguration": {
"logDriver": "awslogs",
"options": {
"awslogs-group": "/aws/ecs/node-debugger",
"awslogs-create-group": "true",
"awslogs-region": "${AWS_REGION}",
"awslogs-stream-prefix": "ecs"
}
}
}
],
"volumes": [
{
"name": "host-root",
"host": {
"sourcePath": "/"
}
}
]
}
EOF
```
Daftar, lalu jalankan tugas. Jalankan perintah berikut.
```
aws ecs register-task-definition --cli-input-json file://node-debugger.json
TASK_ARN=$(aws ecs run-task \
--cluster $ECS_CLUSTER_NAME \
--task-definition node-debugger \
--enable-execute-command \
--capacity-provider-strategy capacityProvider=managed-instances-default,weight=1 \
--query 'tasks[0].taskArn' --output text)
# Wait for task to be running
aws ecs wait tasks-running --cluster $ECS_CLUSTER_NAME --tasks $TASK_ARN
```
Connect ke wadah. Jalankan perintah berikut.
```
aws ecs execute-command \
--cluster $ECS_CLUSTER_NAME \
--task $TASK_ARN \
--container node-debugger \
--interactive \
--command "/bin/sh"
```
**Periksa log agen Amazon ECS:**
Dalam sesi interaktif wadah, jalankan perintah berikut:
```
# Install required tools
yum install -y util-linux-core
# View ECS agent logs
nsenter -t 1 -m -p cat /var/log/ecs/ecs-agent.log | tail -50
# Check agent registration
nsenter -t 1 -m -p grep "Registered container instance" /var/log/ecs/ecs-agent.log
Example Output:
{"level":"info","time":"2025-10-16T12:39:37.665","msg":"Registered container instance with cluster!"}
# Verify capabilities
nsenter -t 1 -m -p grep "Response contained expected value for attribute" /var/log/ecs/ecs-agent.log
```
**Periksa metrik agen:**
Jalankan perintah berikut untuk melihat log.
```
# View metrics logs
nsenter -t 1 -m -p cat /var/log/ecs/metrics.log | tail -20
```
### Masalah penempatan tugas
Berikut ini adalah gejala masalah penempatan tugas:
+ Tugas terjebak dalam status PENDING
+ Tugas gagal dimulai di Instans Terkelola Amazon ECS
+ Kesalahan sumber daya tidak mencukupi
#### Langkah-langkah diagnostik
Jalankan perintah berikut untuk mendiagnosis masalah penempatan tugas dan mengumpulkan informasi tentang kapasitas cluster, instance kontainer, dan layanan sistem:
```
# Check cluster capacity
aws ecs describe-clusters --clusters cluster-name --include STATISTICS
# Check cluster capacity providers
aws ecs describe-clusters --clusters cluster-name --include STATISTICS --query 'clusters[].capacityProviders'
# List container instances
aws ecs list-container-instances --cluster cluster-name
# Check container instance details
aws ecs describe-container-instances --cluster cluster-name --container-instances container-instance-arn
# Check container instance remaining resources CPU/Mem
aws ecs describe-container-instances --cluster $ECS_CLUSTER_NAME --container-instances container-instance-arn --query 'containerInstances[].remainingResources'
# Check container instance Security Group
aws ecs describe-container-instances --cluster $ECS_CLUSTER_NAME --container-instances container-instance-arn --query 'containerInstances[].ec2InstanceId' --output text
aws ec2 describe-instances --instance-ids instance-id --query 'Reservations[0].Instances[0].SecurityGroups'
aws ec2 describe-security-groups --group-ids security-group-id
```
**Pemantauan layanan sistem:**
```
# Check Containerd status
nsenter -t 1 -m -p systemctl status containerd.service
# Check Amazon ECS container agent status
nsenter -t 1 -m -p systemctl status ecs
```
#### Resolusi
Untuk mengatasi masalah penempatan tugas, ikuti langkah-langkah berikut untuk memastikan konfigurasi dan kapasitas yang tepat:
+ Verifikasi persyaratan sumber daya tugas vs kapasitas yang tersedia
+ Periksa kendala dan strategi penempatan
+ Pastikan penyedia kapasitas Instans Terkelola Amazon ECS dikonfigurasi
+ Pastikan grup keamanan instans tugas dan kontainer memiliki aturan keluar yang memungkinkan lalu lintas untuk titik akhir manajemen agen Amazon ECS
### Masalah jaringan
Berikut ini adalah synptom masalah jaringan:
+ Tugas tidak dapat menjangkau layanan eksternal
+ Masalah resolusi DNS
#### Langkah-langkah diagnostik
**Tes konektivitas jaringan:**
Dari kontainer debug, jalankan perintah berikut:
**catatan**
Konfirmasikan grup keamanan yang dilampirkan ke penyedia kapasitas Anda atau tugas Amazon ECS mengizinkan lalu lintas.
```
# Install DNS Utility
yum install bind-utils -y
# Test DNS resolution
nslookup amazon.com
# Test external connectivity
curl -I https://amazon.com
```
### Kendala sumber daya
Berikut ini adalah synptom masalah jaringan:
+ Tugas terbunuh karena batas memori
+ Pelambatan CPU
+ Masalah ruang disk
#### Langkah-langkah diagnostik
Jalankan perintah untuk memantau sumber daya dan batas kontainer.
**Pemantauan sumber daya:**
```
# Check memory usage
nsenter -t 1 -m -p free -h
# Check disk usage
nsenter -t 1 -m -p lsblk
# Check disk usage
nsenter -t 1 -m -p df -h
```
**Batas Kontainer:**
```
# Check OOM kills
nsenter -t 1 -m -p dmesg | grep -i "killed process"
```
### Masalah pemutusan agen instans kontainer
Berikut ini adalah gejala masalah pemutusan agen instance container:
+ Instans kontainer ditampilkan sebagai terputus di konsol Amazon ECS
+ Tugas gagal ditempatkan pada instance tertentu
+ Kegagalan pendaftaran agen di log
#### Langkah-langkah diagnostik
Jika ada tugas hak istimewa yang berjalan di host yang dapat diakses ECS Exec, jalankan perintah berikut untuk mendiagnosis masalah konektivitas agen:
```
# check service status
nsenter -t 1 -m -p systemctl restart ecs
nsenter -t 1 -m -p systemctl restart containerd
# restart stopped services
nsenter -t 1 -m -p systemctl restart ecs
nsenter -t 1 -m -p systemctl restart containerd
```
Jika tidak, paksa deregister Instans Terkelola Amazon ECS. Jalankan perintah berikut:
```
# list ECS Managed Instance container
aws ecs list-container-instances --cluster managed-instances-cluster --query 'containerInstanceArns' --output text
# deregister the specific container instance
aws ecs deregister-container-instance \
--cluster $ECS_CLUSTER_NAME \
--container-instance container-instance-arn \
--force
```
#### Resolusi
Untuk mengatasi masalah pemutusan agen, ikuti langkah-langkah berikut:
+ Verifikasi izin peran IAM untuk instance kontainer
+ Periksa aturan grup keamanan mengizinkan lalu lintas HTTPS keluar ke titik akhir ECS
+ Pastikan konektivitas jaringan ke AWS layanan
+ Mulai ulang layanan agen ECS jika perlu: `nsenter -t 1 -m -p systemctl restart ecs`
+ Verifikasi konfigurasi ECS\$1CLUSTER di/etc/ecs/ecs.config cocok dengan nama cluster Anda
## Analisis Log di Instans Terkelola Amazon ECS
### Log sistem
Gunakan perintah berikut untuk memeriksa log sistem dan mengidentifikasi potensi masalah dengan instance terkelola:
```
# Check system messages
nsenter -t 1 -m -p journalctl --no-pager -n 50
# Check kernel logs
nsenter -t 1 -m -p dmesg | tail -20
# Check for disk space errors
nsenter -t 1 -m -p journalctl --no-pager | grep -i "no space\|disk full\|enospc"
```
## Gunakan EC2 AWS CLI untuk mendapatkan output konsol dari Instans Terkelola Amazon ECS
Gunakan ID instans Amazon EC2 untuk mengambil output konsol.
Ganti *user-input* dengan nilai-nilai Anda.
```
aws ec2 get-console-output --instance-id instance-id --latest --output text
```
## Pembersihan
Jalankan yang berikut ini untuk menghentikan tugas deug dan membatalkan pendaftaran definisi tugas.
```
# Stop debug task
aws ecs stop-task --cluster $ECS_CLUSTER_NAME --task $TASK_ARN
# Deregister task definition (optional)
aws ecs deregister-task-definition --task-definition node-debugger
```
## Sumber daya tambahan
Untuk informasi selengkapnya tentang pemecahan masalah Instans Terkelola Amazon ECS, lihat sumber daya berikut:
+ [Memecahkan masalah kesalahan Instans Terkelola Amazon ECS Amazon ECS](managed-instances-errors.md)
+ [Pemecahan masalah Amazon ECS](troubleshooting.md)
+ [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md)
+ [Memantau Kontainer Amazon ECS dengan ECS Exec](ecs-exec.md)
# Memecahkan Masalah Instans Terkelola Amazon ECS
Saat meluncurkan tugas dengan Instans Terkelola Amazon ECS, Amazon ECS pertama-tama mencoba menempatkan tugas pada kapasitas yang ada dan meminta kapasitas tambahan untuk tugas yang tidak dapat ditempatkan. Jika penyediaan instans gagal, ID permintaan Amazon EC2 disertakan dalam pesan kegagalan tugas. Anda dapat menggunakan ID permintaan ini untuk mencari detail permintaan yang gagal CloudTrail untuk pemecahan masalah lebih lanjut.
**catatan**
Jika Anda memilih untuk menerapkan izin hak istimewa paling sedikit dan menentukan izin Anda sendiri untuk profil instans alih-alih menggunakan kebijakan `AmazonECSInstanceRolePolicyForManagedInstances` terkelola, Anda dapat menambahkan izin berikut untuk membantu mengatasi masalah terkait tugas dengan Instans Terkelola Amazon ECS:
`ecs:StartTelemetrySession`
`ecs:PutSystemLogEvents`
## Definisi tugas tidak kompatibel dengan Instans Terkelola Amazon ECS
### Penyebab umum
Kesalahan ini terjadi ketika definisi tugas berisi parameter atau konfigurasi yang tidak didukung oleh Instans Terkelola Amazon ECS. Ketidakcocokan umum termasuk mode jaringan yang tidak didukung, peran tugas, atau persyaratan sumber daya.
### Resolusi
1. Verifikasi bahwa definisi tugas Anda menggunakan `requiresCompatibilities` set to`MANAGED_INSTANCES`.
1. Pastikan definisi tugas Anda menggunakan mode `awsvpc` jaringan.
1. Periksa apakah nilai CPU dan memori berada dalam rentang yang didukung untuk Instans Terkelola Amazon ECS.
1. Tinjau pesan kesalahan terperinci untuk detail ketidakcocokan tertentu.
## Penyedia kapasitas tidak terkait dengan cluster
### Penyebab umum
Kesalahan ini terjadi ketika penyedia kapasitas yang ditentukan dalam strategi penyedia kapasitas Anda tidak terkait dengan klaster atau tidak ada.
### Resolusi
1. Verifikasi bahwa penyedia kapasitas ada di akun dan wilayah Anda.
1. Kaitkan penyedia kapasitas dengan klaster Anda menggunakan konsol Amazon ECS atau CLI.
1. Pastikan penyedia kapasitas dalam `ACTIVE` status sebelum menggunakannya.
## Kesalahan izin peran infrastruktur
### Penyebab umum
Kesalahan ini terjadi ketika peran infrastruktur Amazon ECS tidak memiliki izin yang diperlukan untuk melakukan operasi Amazon EC2 atas nama Anda, atau ketika peran tidak dapat diasumsikan karena masalah hubungan kepercayaan.
### Resolusi
1. Verifikasi bahwa peran infrastruktur Anda memiliki hubungan kepercayaan yang tepat dengan Amazon ECS.
1. Pastikan peran memiliki izin Amazon EC2 yang diperlukan termasuk`ec2:RunInstances`,, `ec2:DescribeInstances` dan. `iam:PassRole`
1. Periksa pesan kegagalan otorisasi yang dikodekan CloudTrail untuk detail izin tertentu.
1. Perbarui kebijakan peran untuk menyertakan izin yang hilang yang diidentifikasi dalam pesan kesalahan.
## VcpuLimitExceeded kesalahan
### Penyebab umum
Kesalahan ini terjadi ketika Anda telah mencapai kuota layanan vCPU untuk keluarga tipe instans di wilayah saat ini. Instans Terkelola Amazon ECS tidak dapat meluncurkan instans tambahan hingga kapasitas tersedia.
### Resolusi
1. Minta peningkatan kuota layanan untuk keluarga tipe instans yang terpengaruh melalui AWS Support Center.
1. Pertimbangkan untuk menggunakan jenis instans berbeda yang termasuk dalam kategori kuota vCPU yang berbeda.
1. Hentikan instans Amazon EC2 yang tidak digunakan untuk membebaskan kapasitas vCPU.
1. Tinjau konfigurasi penyedia kapasitas Anda untuk menggunakan tipe instans dengan persyaratan vCPU yang lebih rendah.
## InsufficientCapacity dan kesalahan kapasitas terkait
### Penyebab umum
Kesalahan ini terjadi ketika AWS tidak memiliki kapasitas yang cukup untuk memenuhi permintaan instans Anda. Ini dapat mencakup kapasitas instans yang tidak mencukupi, kapasitas alamat, atau kapasitas volume di Availability Zone yang diminta.
### Resolusi
1. Coba luncurkan instance di Availability Zone yang berbeda dengan mengonfigurasi beberapa subnet di penyedia kapasitas Anda.
1. Pertimbangkan untuk menggunakan berbagai jenis instance yang mungkin memiliki kapasitas lebih banyak.
1. Tunggu dan coba lagi operasi karena ketersediaan kapasitas sering berubah.
1. Untuk kebutuhan kapasitas yang terus-menerus, pertimbangkan untuk menggunakan Instans Cadangan atau Savings Plans.
## UnauthorizedOperation kesalahan
### Penyebab umum
Kesalahan ini terjadi ketika layanan Amazon ECS tidak memiliki izin yang diperlukan untuk melakukan operasi Amazon EC2 atau meneruskan peran IAM. Skenario umum termasuk `ec2:RunInstances` izin atau `iam:PassRole` izin yang hilang untuk profil instance.
### Resolusi
1. Verifikasi bahwa peran infrastruktur Amazon ECS Anda memiliki izin yang diperlukan untuk meluncurkan instans Amazon EC2.
1. Pastikan peran infrastruktur memiliki `iam:PassRole` izin untuk profil instans yang digunakan oleh Instans Terkelola Amazon ECS Anda.
1. Periksa pesan kegagalan otorisasi yang dikodekan CloudTrail untuk detail izin tertentu.
1. Perbarui kebijakan peran untuk menyertakan izin yang hilang yang diidentifikasi dalam pesan galat.
## Waktu tugas habis menunggu kapasitas
### Penyebab umum
Kesalahan ini terjadi ketika instance membutuhkan waktu lebih lama dari yang diharapkan untuk diluncurkan dan mendaftar dengan cluster. Hal ini dapat terjadi karena kendala kapasitas Amazon EC2, kegagalan peluncuran instans, atau masalah konektivitas jaringan.
### Resolusi
1. Periksa kesehatan layanan Amazon EC2 di wilayah Anda untuk masalah yang sedang berlangsung.
1. Pastikan subnet Anda memiliki alamat IP yang cukup tersedia.
1. Pastikan grup keamanan Anda mengizinkan lalu lintas yang diperlukan untuk komunikasi agen Amazon ECS.
1. Pertimbangkan untuk menggunakan beberapa Availability Zone untuk meningkatkan ketersediaan kapasitas.
1. Coba lagi operasi peluncuran tugas karena kendala kapasitas seringkali bersifat sementara.
## Kesalahan konfigurasi jaringan
### Penyebab umum
Kesalahan ini terjadi ketika ada ketidakcocokan antara persyaratan jaringan tugas Anda dan konfigurasi jaringan penyedia kapasitas, seperti ketidakcocokan VPC atau konfigurasi jaringan yang hilang.
### Resolusi
1. Verifikasi bahwa penyedia kapasitas Anda dikonfigurasi dengan VPC dan subnet yang benar.
1. Pastikan bahwa grup keamanan dan subnet milik VPC yang sama.
1. Periksa apakah konfigurasi jaringan definisi tugas Anda kompatibel dengan penyedia kapasitas.
1. Perbarui konfigurasi penyedia kapasitas Anda dengan pengaturan jaringan yang benar.
## Penyedia kapasitas tidak dapat dihapus karena instance macet
### Penyebab umum
Kesalahan ini terjadi ketika Instans Terkelola Amazon ECS macet dalam `DRAINING` status `ACTIVE` atau tetapi tidak ada tugas yang berjalan pada instans.
### Resolusi
Untuk memungkinkan penghapusan penyedia kapasitas untuk melanjutkan, Anda dapat memaksa deregister instance yang macet menggunakan perintah berikut.
```
aws ecs deregister-container-instance \
--cluster arn:aws:ecs:us-east-1:111122223333:cluster/MyCluster \
--container-instance arn:aws:ecs:us-east-1:111122223333:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
--force
```
# Memecahkan masalah kesalahan Instans Terkelola Amazon ECS Amazon ECS
Berikut ini adalah beberapa pesan kesalahan Amazon ECS Managed Instances dan tindakan yang dapat Anda lakukan untuk memperbaiki kesalahan.
## Penyedia Instans Terkelola Amazon ECS tidak didukung tanpa Nama Cluster
Kesalahan ini terjadi saat Anda mencoba membuat penyedia kapasitas dengan parameter penyedia Instans Terkelola Amazon ECS tetapi tidak ada bidang klaster.
Untuk mengatasi masalah ini, tentukan nama cluster yang valid saat membuat penyedia kapasitas.
## Detail penyedia Instans Terkelola Amazon ECS diperlukan saat membuat penyedia kapasitas Instans Terkelola Amazon ECS
Kesalahan ini muncul saat Anda mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS tetapi tidak menyediakan objek yang sebenarnya.
Untuk memperbaiki masalah ini, tentukan detail penyedia Instans Terkelola Amazon ECS yang valid dan coba lagi.
## Penyedia kapasitas Instans Terkelola Amazon ECS harus menentukan profil instans
Anda akan melihat kesalahan ini saat mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS tetapi tidak menyediakan Ec2. InstanceProfile
Untuk mengatasinya, tentukan profil instans EC2 yang valid untuk penyedia kapasitas Instans Terkelola Amazon ECS Anda. Untuk informasi selengkapnya, lihat [Profil instans Instans Terkelola Amazon ECS](managed-instances-instance-profile.md).
## Penyedia kapasitas Instans Terkelola Amazon ECS harus menentukan InfrastructureRole
Pesan ini muncul saat Anda mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS tetapi tidak menyediakan. InfrastructureRole
Untuk memperbaikinya, tentukan peran infrastruktur yang valid untuk penyedia kapasitas Instans Terkelola Amazon ECS Anda. Untuk informasi selengkapnya, lihat [Peran IAM Infrastruktur Amazon ECS](infrastructure_IAM_role.md).
## Penyedia kapasitas Instans Terkelola Amazon ECS harus menentukan Konfigurasi Jaringan
Anda akan mengalami kesalahan ini saat mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS tetapi tidak menyediakan konfigurasi jaringan.
Untuk mengatasinya, tentukan konfigurasi jaringan yang valid dengan subnet yang tidak kosong untuk penyedia kapasitas Instans Terkelola Amazon ECS Anda. Untuk informasi selengkapnya, lihat [Jaringan tugas Amazon ECS untuk Instans Terkelola Amazon ECS](managed-instance-networking.md).
## Tidak ada jenis instans yang memenuhi persyaratan instans yang ditentukan dalam penyedia kapasitas Instans Terkelola Amazon ECS
Ini terjadi ketika Anda mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS tetapi tidak ada jenis instans EC2 yang memenuhi persyaratan instans.
Untuk mengatasi hal ini, tinjau dan sesuaikan persyaratan instans agar sesuai dengan jenis instans EC2 yang tersedia.
## Peran infrastruktur yang ditentukan arn tidak valid
Kesalahan ini terjadi ketika InfrastructureRole tidak mengikuti format ARN tertentu.
Format yang diharapkan:`arn:partition:iam::account-id:role/role-name`. Tentukan peran ARN yang valid dan coba lagi. Untuk informasi selengkapnya, lihat [Peran IAM Infrastruktur Amazon ECS](infrastructure_IAM_role.md).
## Peran profil instance yang ditentukan arn tidak valid
Kesalahan ini terjadi ketika profil instance tidak mengikuti format ARN tertentu.
Format yang diharapkan:`arn:partition:iam::account-id:instance-profile/profile-name`. Tentukan peran ARN yang valid dan coba lagi. Untuk informasi selengkapnya, lihat [Profil instans Instans Terkelola Amazon ECS](managed-instances-instance-profile.md).
## Id grup keamanan yang ditentukan tidak valid
Kesalahan ini terjadi ketika ID grup keamanan tidak mengikuti format tertentu.
Format yang diharapkan: `sg-xxxxxxxx` atau `sg-xxxxxxxxxxxxxxxxxx` (8 atau 17 karakter termasuk huruf (huruf kecil), dan angka setelah 'sg-'). Tentukan ID grup keamanan dan coba lagi.
## Id subnet yang ditentukan tidak valid
Kesalahan ini terjadi ketika ID subnet tidak mengikuti format tertentu.
Format yang diharapkan: `subnet-xxxxxxxx` atau `subnet-xxxxxxxxxxxxxxxxxx` (8 atau 17 karakter termasuk huruf (huruf kecil), dan angka setelah 'subnet-'). Tentukan ID subnet dan coba lagi.
## Penyedia kapasitas Instans Terkelola Amazon ECS harus menentukan Konfigurasi Jaringan dengan subnet yang tidak kosong
Kesalahan ini terjadi saat Anda mencoba membuat penyedia kapasitas dengan penyedia Instans Terkelola Amazon ECS dan konfigurasi jaringan dengan subnet kosong.
Untuk mengatasinya, tentukan konfigurasi jaringan yang valid dengan subnet yang tidak kosong untuk penyedia kapasitas Instans Terkelola Amazon ECS Anda.
## Penyedia kapasitas Instans Terkelola Amazon ECS tidak dapat memiliki jumlah tag yang melebihi nilai maksimum yang diizinkan
Kesalahan ini terjadi ketika Anda mencoba membuat penyedia kapasitas dengan lebih dari jumlah tag maksimum yang diizinkan (45).
Untuk mengatasi ini, kurangi jumlah tag menjadi 45 atau kurang dan coba lagi.
## Nilai tidak valid untuk PropagateTags
Kesalahan ini terjadi ketika Anda mencoba membuat penyedia kapasitas dengan nilai PropagateTags yang tidak valid.
Nilai harus salah satu nilai PropagateTags yang valid. Tentukan nilai yang valid dan coba lagi.
## Penyedia kapasitas yang ditentukan sudah ada dengan cakupan cluster
Kesalahan ini terjadi saat Anda mencoba membuat, memperbarui, atau menghapus penyedia kapasitas Instans Terkelola Amazon ECS tanpa nama cluster, tetapi ada penyedia kapasitas cakupan klaster yang ada.
Untuk mengubah konfigurasi atau menghapus penyedia kapasitas, perbarui atau hapus penyedia kapasitas dengan parameter cluster.
## Penyedia kapasitas yang ditentukan sudah ada dengan akun atau cluster yang berbeda
Kesalahan ini terjadi saat Anda mencoba membuat, memperbarui, atau menghapus penyedia kapasitas Instans Terkelola Amazon ECS dengan bidang klaster, sementara ada penyedia kapasitas cakupan akun yang ada atau penyedia kapasitas cakupan klaster yang ada untuk klaster yang berbeda.
Untuk mengatasi hal ini, gunakan nama penyedia kapasitas yang berbeda atau bekerja dengan penyedia kapasitas yang ada.
## Nama cluster aktif penyedia kapasitas tidak cocok dengan nama cluster dalam permintaan
Kesalahan ini terjadi ketika nama cluster aktif penyedia kapasitas tidak cocok dengan nama cluster yang ditentukan dalam permintaan.
Pastikan bahwa nama cluster dalam permintaan Anda cocok dengan kluster terkait penyedia kapasitas.
## Penyedia kapasitas bukan penyedia kapasitas Instans Terkelola Amazon ECS
Kesalahan ini terjadi saat Anda mencoba menggunakan penyedia kapasitas yang bukan penyedia kapasitas Instans Terkelola Amazon ECS dalam konteks yang memerlukannya.
Pastikan Anda menggunakan penyedia kapasitas Instans Terkelola Amazon ECS yang valid untuk permintaan Anda.
## CapacityProvider nama tidak boleh kosong
Kesalahan ini terjadi ketika Anda mencoba membuat penyedia kapasitas tanpa menentukan nama penyedia kapasitas.
Tentukan nama penyedia kapasitas yang valid dan coba lagi.
## Nama diperlukan saat memperbarui penyedia kapasitas
Kesalahan ini terjadi ketika Anda mencoba memperbarui penyedia kapasitas tanpa menentukan nama penyedia kapasitas.
Tentukan nama yang valid dan coba lagi.
## Tag tidak bisa null atau memiliki elemen null
Kesalahan ini terjadi ketika Anda mencoba menandai penyedia kapasitas dengan nilai nol.
Pastikan semua nilai tag ditentukan dengan benar dan bukan null.
# Alasan kegagalan Amazon ECS API
Jika tindakan API yang dipicu melalui Amazon ECS API, konsol, atau AWS CLI keluar dengan pesan `failures` galat, berikut ini mungkin membantu memecahkan masalah penyebabnya. Kegagalan mengembalikan alasan dan Nama Sumber Daya Amazon (ARN) dari sumber daya yang terkait dengan kegagalan.
Banyak sumber daya merupakan wilayah yang khusus, jadi ketika menggunakan konsol tersebut pastikan bahwa Anda mengatur Wilayah yang benar untuk sumber daya Anda. Saat menggunakan AWS CLI, pastikan AWS CLI perintah Anda dikirim ke Wilayah yang benar dengan `--region region` parameter.
Untuk informasi selengkapnya tentang struktur tipe `Failure` data, lihat [Kegagalan](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) dalam *Referensi API Amazon Elastic Container Service*.
Berikut ini adalah contoh pesan kegagalan yang mungkin Anda terima saat menjalankan perintah API.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/api_failures_messages.html)
**catatan**
Selain skenario kegagalan yang dijelaskan di sini, operasi API juga dapat gagal karena pengecualian, yang mengakibatkan respons kesalahan. Untuk daftar pengecualian tersebut, lihat [Kesalahan Umum](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html).
# Pemecahan Masalah dengan Pengembang Amazon Q
Anda dapat menggunakan [Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/what-is.html) di konsol Amazon ECS untuk membantu mendiagnosis dan menyelesaikan masalah dengan sumber daya Amazon ECS Anda. Untuk kesalahan dan pesan status tertentu pada container, task, service, deployment, dan definisi tugas, konsol menampilkan opsi **Inspect with Amazon Q** Developer. Saat Anda memilih opsi ini, Pengembang Amazon Q menganalisis masalah dalam konteks dan menyarankan kemungkinan penyebab dan langkah perbaikan.
## Izin yang diperlukan
+ Izin untuk melihat sumber daya Amazon ECS yang ingin Anda pecahkan, seperti klaster, layanan, tugas, dan definisi tugas.
+ [Izin untuk menggunakan Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/security_iam_permissions.html) di konsol.
+ (Disarankan) Izin untuk melihat log dan metrik terkait, seperti:
+ CloudWatch Log
+ CloudWatch
## Prosedur
1. Buka konsol di[https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Tentukan sumber daya yang ingin Anda pecahkan masalah.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonECS/latest/developerguide/troubleshooting-with-Q.html)
1. Pada halaman detail sumber daya, cari status atau alasan kesehatan yang menjelaskan masalah tersebut.
1. Klik alasan status untuk membuka popover.
1. Jika tersedia, pilih **Periksa dengan Pengembang Amazon Q**.
1. Tinjau penjelasan dan langkah-langkah perbaikan yang disarankan yang disediakan oleh Pengembang Amazon Q. Terapkan konfigurasi atau perubahan operasional yang sesuai untuk lingkungan Anda.
## Pertimbangan-pertimbangan
Pertimbangkan hal berikut saat menggunakan Amazon Q Developer dengan Amazon ECS:
+ **Ketersediaan tombol** - Tombol “Periksa dengan Pengembang Amazon Q” hanya ditampilkan untuk sumber daya yang mengalami masalah potensial. Opsi ini tidak tersedia untuk sumber daya yang sehat.
+ **Operasi hanya-baca** - Integrasi Pengembang Amazon Q hanya melakukan operasi baca. Itu tidak membuat tindakan bermutasi atau menulis.
+ **Pemrosesan lintas wilayah** - Pengembang Amazon Q dapat memproses data di seluruh AWS wilayah untuk memberikan analisis yang didukung AI. Untuk informasi selengkapnya tentang pemrosesan lintas wilayah, lihat [Pemrosesan lintas wilayah di Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html).
+ **Hanya konsol** - Integrasi ini hanya tersedia melalui Konsol. Ini tidak tersedia melalui AWS CLI, AWS APIs, atau infrastruktur sebagai alat kode.
## Pelajari selengkapnya
Untuk informasi selengkapnya tentang menggunakan Pengembang Amazon Q, lihat [Mengobrol dengan Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/chat-with-q.html). AWS