Kirim log Amazon ECS ke AWS layanan atau AWS Partner

Jika tugas Anda dihosting di Fargate dan Anda menarik gambar kontainer dari Amazon ECR atau mereferensikan data sensitif dari AWS Secrets Manager konfigurasi log Anda, maka Anda harus menyertakan peran IAM eksekusi tugas.

Saat Anda menggunakan file konfigurasi khusus yang dihosting di Amazon S3, peran IAM eksekusi tugas Anda harus menyertakan s3:GetObject izin tersebut.

Sebaiknya tambahkan my_service_ ke nama wadah log sehingga Anda dapat dengan mudah membedakan nama wadah di konsol.

Amazon ECS menambahkan ketergantungan pesanan kontainer awal antara wadah aplikasi dan FireLens wadah secara default. Saat Anda menentukan urutan kontainer antara wadah aplikasi dan FireLens wadah, maka urutan kontainer awal default diganti.

FireLensuntuk Amazon ECS didukung untuk tugas-tugas yang dihosting AWS Fargate di Linux dan Amazon EC2 di Linux. Wadah Windows tidak mendukungFireLens.

Untuk informasi tentang cara mengonfigurasi logging terpusat untuk wadah Windows, lihat Pencat atan terpusat untuk wadah Windows di Amazon ECS menggunakan Fluent Bit.

Anda dapat menggunakan CloudFormation templat FireLens untuk mengonfigurasi Amazon ECS. Untuk informasi selengkapnya, lihat AWS: :ECS:: TaskDefinition FirelensConfiguration di Panduan Pengguna AWS CloudFormation

FireLensmendengarkan pada port24224, jadi untuk memastikan bahwa router FireLens log tidak dapat dijangkau di luar tugas, Anda tidak boleh mengizinkan lalu lintas masuk pada port 24224 di grup keamanan yang digunakan tugas Anda. Untuk tugas yang menggunakan mode awsvpc jaringan, ini adalah grup keamanan yang terkait dengan tugas. Untuk tugas yang menggunakan mode host jaringan, ini adalah grup keamanan yang terkait dengan instans Amazon EC2 yang menghosting tugas tersebut. Untuk tugas yang menggunakan mode bridge jaringan, jangan membuat pemetaan port apa pun yang menggunakan port. 24224

Untuk tugas yang menggunakan mode bridge jaringan, wadah dengan FireLens konfigurasi harus dimulai sebelum wadah aplikasi apa pun yang bergantung padanya dimulai. Untuk mengendalikan urutan mulai kontainer Anda, gunakan syarat dependensi dalam ketentuan tugas Anda. Untuk informasi selengkapnya, lihat Dependensi kontainer.

Secara default, FireLens tambahkan nama definisi cluster dan tugas serta Nama Sumber Daya Amazon (ARN) dari cluster sebagai kunci metadata ke log stdout/stderr kontainer Anda. Berikut ini adalah contoh format metadata.

"ecs_cluster": "cluster-name",
"ecs_task_arn": "arn:aws:ecs:region:111122223333:task/cluster-name/f2ad7dba413f45ddb4EXAMPLE",
"ecs_task_definition": "task-def-name:revision",

Jika Anda tidak ingin metadata di log Anda, set false el enable-ecs-log-metadata ke di firelensConfiguration bagian definisi tugas.

"firelensConfiguration":{
   "type":"fluentbit",
   "options":{
      "enable-ecs-log-metadata":"false",
      "config-file-type":"file",
      "config-file-value":"/extra.conf"
}

Untuk mengonfigurasi FireLens wadah agar dijalankan sebagai pengguna non-root, Anda harus menentukan pengguna dalam salah satu format berikut:

Untuk informasi selengkapnya tentang menentukan pengguna dalam definisi wadah, lihat Refer ContainerDefinition ensi API Layanan Kontainer Amazon Elastic.

FireLensWadah menerima log aplikasi melalui so UNIX ket. Agen Amazon ECS menggunakan uid untuk menetapkan kepemilikan direktori soket ke FireLens wadah.

Mengkonfigurasi FireLens wadah untuk dijalankan sebagai pengguna non-root didukung pada versi Agen Amazon ECS dan yang lebih baru, 1.96.0 dan versi Amazon ECS-optimized AMI dan yang lebih baruv20250716.

Ketika Anda menentukan pengguna untuk FireLens wadah, itu uid harus unik dan tidak digunakan untuk proses lain milik wadah lain dalam tugas atau instance kontainer.