全部产品
Search
文档中心

Elastic Container Instance:Konfigurasikan pengumpulan log untuk sebuah contoh kontainer elastis

更新时间:Nov 11, 2025

Elastic Container Instance dapat mengekspor log kontainer ke Simple Log Service. Topik ini menjelaskan cara menggunakan variabel lingkungan untuk mengonfigurasi pengumpulan log untuk sebuah contoh kontainer elastis, termasuk cara menentukan Proyek, Logstore, dan grup mesin.

Informasi latar belakang

Simple Log Service Alibaba Cloud adalah layanan pencatatan data ujung ke ujung yang memungkinkan Anda mengumpulkan, mengonsumsi, mengirimkan, menanyai, dan menganalisis data log tanpa perlu melakukan pengembangan lebih lanjut. Untuk informasi lebih lanjut, lihat Apa itu Simple Log Service?.

Penting

Anda akan dikenakan biaya berdasarkan penggunaan aktual saat menggunakan Simple Log Service. Untuk informasi tentang penagihan Simple Log Service, lihat Ikhtisar Penagihan.

Jika Anda mengaktifkan pengumpulan log saat membuat sebuah contoh kontainer elastis, sistem secara otomatis menghasilkan Proyek dan grup mesin.

  • Nama Proyek: eci-log-default-project-{Region}-{Account ID}.

  • Nama kelompok mesin: eci-log-default-machine-group-{Region}.

Untuk mengonfigurasi pengaturan pengumpulan log, seperti pengaturan untuk mengumpulkan log ke Proyek kustom dan Logstore kustom atau pengaturan untuk menambahkan contoh kontainer elastis yang menjadi host aplikasi berbeda ke grup mesin yang berbeda, Anda dapat menggunakan variabel lingkungan kontainer untuk memasukkan konfigurasi kustom terkait log. Jika Anda tidak memiliki Proyek, Logstore, atau grup mesin yang sesuai dengan variabel lingkungan, sistem secara otomatis membuat Proyek, Logstore, atau grup mesin tersebut.

Catatan

  • Anda hanya dapat menggunakan variabel lingkungan untuk mengonfigurasi pengumpulan log saat membuat sebuah contoh kontainer elastis. Variabel lingkungan terkait log yang dimasukkan saat memperbarui sebuah contoh kontainer elastis tidak akan berlaku.

  • Jika Anda tidak lagi menggunakan Proyek kustom atau konfigurasi Logtail, hapus Proyek atau konfigurasi Logtail tersebut tepat waktu untuk menghindari biaya yang tidak perlu.

  • Jika Anda mengubah nama variabel lingkungan kustom, konfigurasi aslinya tidak akan dihapus secara otomatis. Anda harus menghapus konfigurasi lama secara manual untuk menghindari biaya tambahan.

Deskripsi Konfigurasi

Saat membuat sebuah contoh kontainer elastis, Anda dapat menggunakan variabel lingkungan kontainer untuk memasukkan konfigurasi log kustom, seperti Proyek, Logstore, konfigurasi Logtail, grup mesin, shard, periode retensi log, dan tag. Tabel berikut menjelaskan variabel lingkungan yang dapat dikonfigurasikan.

Catatan

Nama variabel lingkungan terkait log harus memiliki awalan aliyun_logs_{key}. Dalam format ini, {key} adalah nama konfigurasi Logtail dalam Simple Log Service dan hanya boleh berisi huruf kecil, angka, dan tanda hubung (-).

Objek Konfigurasi

Nama Variabel Lingkungan

Deskripsi Variabel Lingkungan

Konfigurasi Logtail

aliyun_logs_{key}

Variabel ini membuat konfigurasi Logtail. Atur variabel ini ke jalur pengumpulan log.

  • Jika Logtail mengumpulkan log keluaran standar (stdout), atur variabel ini ke salah satu nilai berikut:

    • stdout: mengumpulkan log stdout dan log kesalahan standar (stderr).

    • stderr-only: mengumpulkan log stderr, tetapi tidak mengumpulkan log stdout.

    • stdout-only: mengumpulkan log stdout, tetapi tidak mengumpulkan log stderr.

  • Jika Logtail mengumpulkan log teks, atur variabel ini ke direktori file di dalam kontainer.

Proyek

aliyun_logs_{key}_project

Variabel ini menentukan sebuah Proyek di Simple Log Service. Nama Proyek harus memenuhi persyaratan berikut:

  • Nama harus memiliki panjang 3 hingga 63 karakter.

  • Nama hanya dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama harus dimulai dan diakhiri dengan huruf kecil atau angka.

Catatan

Nama harus unik secara global, dan tidak dapat diubah setelah Proyek dibuat. Jika nama tidak memenuhi persyaratan sebelumnya dan gagal verifikasi format nama, konfigurasi Proyek akan diabaikan dan Proyek default akan digunakan.

Logstore

aliyun_logs_{key}_logstore

Variabel ini menentukan sebuah Logstore. Nama Logstore harus memenuhi persyaratan berikut:

  • Nama harus memiliki panjang 3 hingga 63 karakter.

  • Nama hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dan diakhiri dengan huruf kecil atau angka.

Catatan

Jika format nama tidak valid, konfigurasi akan diabaikan dan Logstore default digunakan. Secara default, nama Logstore sama dengan nama konfigurasi Logtail {key}.

Grup mesin

aliyun_logs_{key}_machinegroup

Variabel ini menentukan sebuah grup mesin. Nama grup mesin harus memenuhi persyaratan berikut:

  • Nama harus memiliki panjang 3 hingga 63 karakter.

  • Nama hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dan diakhiri dengan huruf kecil atau angka.

Catatan

Jika nama tidak memenuhi persyaratan sebelumnya dan gagal verifikasi format nama, konfigurasi grup mesin akan diabaikan dan grup mesin default akan digunakan.

Partisi

aliyun_logs_{key}_shard

Variabel ini menentukan jumlah shard dalam sebuah Logstore. Nilai valid: 1 hingga 10.

Log baca dan tulis harus disimpan dalam shard Logstore. Secara default, setiap Logstore berisi dua shard.

Periode retensi log

aliyun_logs_{key}_ttl

Variabel ini menentukan periode retensi log. Nilai valid: 1 hingga 3650. Unit: hari.

  • Nilai 3650 menentukan bahwa data log disimpan secara permanen di Logstore.

  • Nilai default: 90.

Tag

aliyun_logs_{key}_tags

Menambahkan tag ke log untuk identifikasi. Nilainya harus dalam format tag-key=tag-value.

Contoh Konfigurasi

Sebagai contoh, Anda perlu menentukan konfigurasi log berikut:

  • Logstore dan konfigurasi Logtail: Log stdout dikumpulkan dan disimpan di Logstore bernama stdout-eci. Log teks dikumpulkan dan disimpan di Logstore bernama file-eci.

  • Nama Proyek: eci-test-project.

  • Nama grup mesin: mg-eci-test.

Catatan

Contoh berikut menjelaskan cara menentukan konfigurasi log. Dalam skenario aktual, tentukan konfigurasi log sesuai kebutuhan dan pastikan nama proyek bersifat unik secara global.

OpenAPI

Saat memanggil operasi CreateContainerGroup untuk membuat sebuah contoh kontainer elastis, Anda dapat menggunakan parameter Container.N.EnvironmentVar.N.Key dan Container.N.EnvironmentVar.N.Value untuk mengonfigurasi variabel lingkungan, seperti yang ditunjukkan dalam kode sampel berikut.

ContainerGroupName=test-sls
Container.1.Name=busybox
Container.1.Image=registry-vpc.cn-shanghai.aliyuncs.com/eci_open/busybox:1.30
Container.1.Command.1=/bin/sh
Container.1.Arg.1=-c
Container.1.Arg.2=mkdir -p /log;while true; do echo hello world; date; echo hello sls >> /log/busy.log; sleep 1;done
# Kumpulkan log stdout.
Container.1.EnvironmentVar.1.Key=aliyun_logs_stdout-eci
Container.1.EnvironmentVar.1.Value=stdout
Container.1.EnvironmentVar.2.Key=aliyun_logs_stdout-eci_project
Container.1.EnvironmentVar.2.Value=project-eci-test
Container.1.EnvironmentVar.3.Key=aliyun_logs_stdout-eci_machinegroup
Container.1.EnvironmentVar.3.Value=mg-eci-test
# Kumpulkan log teks.
Container.1.EnvironmentVar.4.Key=aliyun_logs_file-eci
Container.1.EnvironmentVar.4.Value=/log/*.log
Container.1.EnvironmentVar.5.Key=aliyun_logs_file-eci_project
Container.1.EnvironmentVar.5.Value=project-eci-test
Container.1.EnvironmentVar.6.Key=aliyun_logs_file-eci_machinegroup
Container.1.EnvironmentVar.6.Value=mg-eci-test

Konsol

Saat membuat sebuah contoh kontainer elastis di Konsol Elastic Container Instance, Anda dapat memilih sebuah kontainer di bagian Container Configurations, memperluas Pengaturan Lanjutan kontainer tersebut, dan kemudian mengaktifkan Environment Variable untuk menambahkan variabel lingkungan, seperti yang ditunjukkan pada gambar berikut.

设置环境变量采集日志.png

Hasil Contoh

Di Konsol Simple Log Service, temukan proyek yang ingin Anda kelola dan klik nama proyek tersebut untuk membuka halaman detail proyek. Kemudian, pilih Logstores dari daftar Logstore di panel navigasi sebelah kiri untuk melihat log, seperti yang ditunjukkan pada gambar berikut.

Pengumpulan log stdout

日志-标准.png

Berkas teks

日志-文本.png