Titik akhir metadata tugas Amazon ECS versi 4

Agen kontainer Amazon ECS menyuntikkan variabel lingkungan ke dalam setiap kontainer, yang disebut sebagai titik akhir metadata tugas yang menyediakan berbagai metadata tugas dan statistik Docker ke wadah.

Metadata tugas dan statistik tingkat jaringan dikirim ke CloudWatch Wawasan Kontainer dan dapat dilihat di. AWS Management Console Untuk informasi selengkapnya, lihat Pantau kontainer Amazon ECS menggunakan Container Insights dengan kemampuan observasi yang ditingkatkan.

catatan

Amazon ECS menyediakan versi sebelumnya dari titik akhir metadata tugas. Untuk menghindari kebutuhan membuat versi titik akhir metadata tugas di masa mendatang, metadata tambahan dapat ditambahkan ke output versi 4. Kami tidak akan menghapus metadata yang ada atau mengubah nama bidang metadata.

Variabel lingkungan disuntikkan secara default ke dalam wadah tugas Amazon ECS yang diluncurkan di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen 1.39.0 penampung Amazon ECS. Untuk instans Amazon EC2 Windows yang menggunakan mode awsvpc jaringan, agen penampung Amazon ECS harus setidaknya versi. 1.54.0 Untuk informasi selengkapnya, lihat Manajemen instans penampung Amazon ECS Linux.

catatan

Anda dapat menambahkan dukungan untuk fitur ini di EC2 instans Amazon menggunakan versi lama agen penampung Amazon ECS dengan memperbarui agen ke versi terbaru. Untuk informasi selengkapnya, lihat Memperbarui agen kontainer Amazon ECS.

Untuk keluaran contoh metadata tugas, lihat contoh metadata tugas Amazon ECS v4.

Jalur titik akhir metadata tugas versi 4

Jalur titik akhir metadata tugas berikut tersedia untuk kontainer.

${ECS_CONTAINER_METADATA_URI_V4}

Jalur ini mengembalikan metadata untuk kontainer.

${ECS_CONTAINER_METADATA_URI_V4}/task

Jalur ini mengembalikan metadata untuk tugas, termasuk daftar wadah IDs dan nama untuk semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang respons titik akhir ini, lihat Metadata tugas Amazon ECS V4 Respons JSON.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Jalur ini mengembalikan metadata untuk tugas termasuk dalam titik akhir /task selain tugas dan tanda instans kontainer yang dapat diambil menggunakan API ListTagsForResource. Setiap kesalahan yang diterima saat mengambil metadata tanda akan disertakan dalam kolom Errors sebagai responsnya.

catatan

ErrorsBidang ini hanya dalam respons untuk tugas yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen 1.50.0 penampung. Untuk instans Amazon EC2 Windows yang menggunakan mode awsvpc jaringan, agen penampung Amazon ECS harus setidaknya versi 1.54.0

Titik akhir ini membutuhkan ecs.ListTagsForResource izin.

penting

Saat menggunakan ${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags titik akhir, ketahuilah bahwa setiap panggilan membuat hingga dua permintaan API ecs:ListTagsForResource (satu untuk tag instance kontainer dan satu untuk tag tugas) dan bahwa setiap wadah sespan dalam tugas dapat melakukan panggilan ini atas nama Anda. Panggilan endpoint yang sering dapat mengakibatkan pelambatan API.

Pertimbangkan untuk menerapkan strategi caching atau batching untuk mengurangi frekuensi panggilan, terutama dalam aplikasi dengan lalu lintas tinggi, dan men-debug masalah pelambatan API yang digunakan. AWS CloudTrail Untuk informasi tentang batas pembatasan untuk ListTagsForResource API, lihat Meminta pembatasan untuk Amazon ECS API di Referensi API Amazon Elastic Container Service. Untuk informasi selengkapnya tentang men-debug panggilan Amazon ECS API menggunakan AWS CloudTrail, lihat. Log panggilan Amazon ECS API menggunakan AWS CloudTrail

${ECS_CONTAINER_METADATA_URI_V4}/stats

Jalur ini mengembalikan statistik Docker untuk kontainer tertentu. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat ContainerStatsdi dokumentasi Docker API.

Untuk tugas Amazon ECS yang menggunakan mode bridge jaringan awsvpc atau yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya versi 1.43.0 agen kontainer, akan ada statistik tarif jaringan tambahan yang disertakan dalam respons. Untuk semua tugas lainnya, respons hanya akan mencakup statistik jaringan kumulatif.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Jalan ini mengembalikan statistik Docker untuk semua kontainer yang terkait dengan tugas. Hal ini dapat digunakan oleh kontainer sidecar untuk mengekstrak metrik jaringan. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat ContainerStatsdi dokumentasi Docker API.

Untuk tugas Amazon ECS yang menggunakan mode bridge jaringan awsvpc atau yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya versi 1.43.0 agen kontainer, akan ada statistik tarif jaringan tambahan yang disertakan dalam respons. Untuk semua tugas lainnya, respons hanya akan mencakup statistik jaringan kumulatif.