Simple Log Service：Jenis jaringan Logtail, parameter startup, dan file konfigurasi

Jenis jaringan dan pemilihan

Saat Anda memasang Logtail, pilih jenis jaringan berdasarkan lokasi server relatif terhadap Simple Log Service. Hal ini memastikan transmisi data log yang lebih cepat dan stabil. Contoh berikut menunjukkan cara memilih jenis jaringan.

1. Masuk ke Konsol Layanan Log Sederhana. Di halaman Project Overview proyek Anda, aktifkan Acceleration Endpoint.

2. Baca prompt di kotak dialog dan klik Confirm.

3. Konfigurasikan akselerasi pengumpulan Logtail dengan salah satu cara berikut:

   Instal Logtail menggunakan akselerasi transfer

   Jika Anda mengaktifkan akselerasi transfer sebelum menginstal Logtail, Anda dapat menginstal Logtail menggunakan fitur akselerasi transfer. Untuk informasi lebih lanjut, lihat Instal Logtail.

   Ubah Konfigurasi Logtail

   Jika Anda telah menginstal Logtail sebelum mengaktifkan akselerasi transfer, Anda dapat mengubah konfigurasi Logtail.

   1. Hentikan Logtail.

      • Linux

        Jalankan perintah sudo /etc/init.d/ilogtaild stop.

      • Windows

        1. Pergi ke Start > Control Panel > Administrative Tools > Services.

        2. Di kotak dialog Services, temukan layanan LogtailDaemon untuk Logtail versi 1.0.0.0 atau yang lebih baru, atau layanan LogtailWorker untuk Logtail versi 0.x.x.x. Klik kanan layanan tersebut dan pilih Stop.

   2. Ubah file konfigurasi startup Logtail ilogtail_config.json.

      Di parameter data_server_list, ganti baris titik akhir dengan log-global.aliyuncs.com. Untuk informasi lebih lanjut tentang jalur file, lihat File Konfigurasi Parameter Startup (ilogtail_config.json).

   3. Mulai Logtail.

      • Linux

        Jalankan perintah sudo /etc/init.d/ilogtaild start.

      • Windows

        1. Pergi ke Start > Control Panel > Administrative Tools > Services.

        2. Di kotak dialog Services, temukan layanan LogtailDaemon untuk Logtail versi 1.0.0.0 atau yang lebih baru, atau layanan LogtailWorker untuk Logtail versi 0.x.x.x. Klik kanan layanan tersebut dan pilih Start.

Untuk informasi lebih lanjut tentang operasi terkait, lihat Kelola Akselerasi Transfer.

Skenario

Nilai parameter yang direkomendasikan

Pengaturan parameter berikut direkomendasikan berdasarkan pengalaman praktis dan cocok untuk mengumpulkan file JSON umum. Kinerja mode regex penuh dan mode pembatas serupa dengan mode JSON. Kinerja mode sederhana lima kali lipat dari mode JSON. Kompleksitas data dan aturan, serta jumlah direktori dan file yang dikumpulkan memengaruhi konsumsi CPU dan memori. Sesuaikan parameter sesuai kebutuhan berdasarkan tabel berikut dan situasi aktual Anda.

• Lingkungan Host

  Parameter	Tingkat pengumpulan default	Tingkat pengumpulan lebih dari 10 MB/s	Tingkat pengumpulan lebih dari 20 MB/s	Tingkat pengumpulan lebih dari 40 MB/s
  cpu_usage_limit	0,4	1	2	4
  mem_usage_limit	384	1024	2048	4.096
  max_bytes_per_sec	20971520	209715200	209715200	209715200
  process_thread_count	1	2	4	8
  send_request_concurrency	4	20	40	80

• Lingkungan Kontainer atau Kubernetes

  Variabel lingkungan	Tingkat pengumpulan default	Tingkat pengumpulan lebih dari 10 MB/s	Tingkat pengumpulan lebih dari 20 MB/s	Tingkat pengumpulan lebih dari 40 MB/s
  cpu_usage_limit	2	3	5	9
  mem_usage_limit	2048	2.048	2048	4096
  max_bytes_per_sec	209715200	209715200	209715200	209715200
  process_thread_count	1	2	4	8
  send_request_concurrency	20	20	40	80
  resources.limits.cpu	500M	1000M	2000M	4000M
  resources.limits.memory	2 Gi	2 Gi	3 Gi	5 Gi

  Berikut ini menjelaskan cara memodifikasi parameter startup Logtail di lingkungan kontainer atau Kubernetes.

  • Jika Logtail diterapkan dalam kluster Alibaba Cloud Kubernetes (ACK) dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, Anda dapat memodifikasi parameter di Konsol Container Service for Kubernetes (ACK). Di halaman Add-ons, modifikasi parameter dalam komponen logtail-ds.

  • Jika Logtail diterapkan dalam lingkungan kontainer mandiri atau Kubernetes dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, Anda dapat memodifikasi parameter startup Logtail dengan memodifikasi variabel lingkungan daemonset. Beberapa lingkungan merujuk pada ConfigMap. Jalur ConfigMap adalah configmap > kube-system > alibaba-log-configuration.

  • Jika versi Logtail lebih lama dari Logtail-ds 1.7.3, Anda dapat memodifikasi parameter startup Logtail dengan memodifikasi variabel lingkungan daemonset. Beberapa lingkungan merujuk pada ConfigMap. Jalur ConfigMap adalah configmap > kube-system > alibaba-log-configuration. Anda juga perlu menyesuaikan parameter resources.limits.cpu dan resources.limits.memory di daemonset > kube-system > logtail-ds untuk mencegah kontainer melebihi batas sumber dayanya.

Saat Anda mengonfigurasi parameter startup Logtail berdasarkan nilai di kolom Tingkat Pengumpulan Lebih dari 40 MB/s, kinerja pengumpulan Logtail mendekati batasnya. Menambahkan lebih banyak thread tidak akan secara signifikan meningkatkan kinerja. Tabel berikut menjelaskan batas kinerja klien pengumpulan.

Atur parameter startup

1. Pada server tempat Logtail diinstal, buka file /usr/local/ilogtail/ilogtail_config.json.

   Langkah ini berlaku untuk lingkungan host.

   Dalam lingkungan kontainer atau Kubernetes, Anda dapat memodifikasi parameter startup Logtail dengan memodifikasi variabel lingkungan daemonset. Beberapa lingkungan merujuk ke ConfigMap. Jalur ConfigMap adalah configmap > kube-system > alibaba-log-configuration.

2. Atur parameter startup sesuai kebutuhan.

   Kode berikut menunjukkan contoh parameter startup.

   {
       ...
       "cpu_usage_limit" : 0.4,
       "mem_usage_limit" : 384,
       "max_bytes_per_sec" : 20971520,
       "process_thread_count" : 1,
       "send_request_concurrency" : 4,
       "buffer_file_num" : 25,
       "buffer_file_size" : 20971520,
       "buffer_file_path" : "",
       ...
   }

   Catatan

   • Tabel berikut hanya menjelaskan parameter startup yang umum. Untuk parameter lainnya, Anda dapat mempertahankan konfigurasi default.

   • Anda dapat menambah atau memodifikasi parameter startup yang ditentukan sesuai kebutuhan.

   Tabel 1. Parameter Startup Logtail

   Parameter	Tipe	Deskripsi	Contoh
   cpu_usage_limit	double	Ambang batas pemanfaatan CPU, dihitung berdasarkan satu inti. Nilai valid adalah sebagai berikut: Rentang: 0,1 hingga jumlah inti CPU pada mesin saat ini Nilai default: 0,4 Peringatan Parameter cpu_usage_limit merupakan batas lunak. Pemanfaatan CPU aktual Logtail mungkin melebihi batas tersebut. Jika batas dilampaui selama 5 menit, mekanisme perlindungan pemutusan sirkuit akan dipicu, dan Logtail akan otomatis memulai ulang. Sebagai contoh, jika Anda mengatur parameter ini menjadi 0,4, Simple Log Service akan mencoba membatasi pemanfaatan CPU Logtail hingga 40% dari satu inti CPU. Jika pemanfaatan melebihi batas ini, Logtail akan otomatis memulai ulang. Secara umum, satu inti dapat memproses sekitar 100 MB/detik data dalam mode sederhana dan sekitar 20 MB/detik dalam mode regex penuh. Catatan Jika Logtail diterapkan dalam kluster ACK dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, atur ambang batas pemanfaatan CPU di Konsol ACK. Di halaman Add-ons, modifikasi parameter LogtailDSLimitCPU dari komponen logtail-ds. Untuk informasi lebih lanjut, lihat Kelola komponen.	"cpu_usage_limit" : 0.4
   mem_usage_limit	int	Ambang batas penggunaan memori. Nilai valid adalah sebagai berikut: Rentang: 128 MB hingga 8192 MB Nilai default: 384 MB (host), 2048 MB (komponen ACK) Peringatan Parameter mem_usage_limit merupakan batas lunak. Penggunaan memori aktual Logtail mungkin melebihi batas tersebut. Jika batas dilampaui selama 5 menit, mekanisme perlindungan pemutusan sirkuit akan dipicu, dan Logtail akan otomatis memulai ulang. Tingkat pengumpulan, jumlah direktori dan file yang dimonitor, serta tingkat pemblokiran pengiriman terkait dengan parameter mem_usage_limit. Untuk informasi lebih lanjut, lihat Batasan Logtail. Catatan Jika Logtail diterapkan dalam kluster ACK dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, atur ambang batas penggunaan memori di Konsol ACK. Di halaman Add-ons, modifikasi parameter LogtailDSLimitMemory dari komponen logtail-ds. Untuk informasi lebih lanjut, lihat Kelola komponen.	"mem_usage_limit" : 384
   max_bytes_per_sec	int	Batas lalu lintas untuk mengirim data mentah dari Logtail per detik. Nilai valid adalah sebagai berikut: Rentang: 1024 Byte/detik hingga 52428800 Byte/detik Nilai default: 20971520 Byte/detik Penting Jika Anda mengatur parameter ini ke nilai lebih besar dari 20971520 Byte/detik (20 MB/detik), kecepatan tidak dibatasi. Sebagai contoh, jika Anda mengatur parameter ini menjadi 2097152, Logtail mengirim data pada laju 2 MB/detik. Catatan Jika Logtail diterapkan dalam kluster ACK dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, atur batas lalu lintas di Konsol ACK. Di halaman Add-ons, modifikasi parameter LogtailDSMaxBytePerSec dari komponen logtail-ds. Untuk informasi lebih lanjut, lihat Kelola komponen.	"max_bytes_per_sec" : 2097152
   process_thread_count	int	Jumlah thread yang digunakan Logtail untuk memproses data. Nilai valid adalah sebagai berikut: Rentang: 1 hingga 64 Nilai default: 1 Secara umum, satu thread dapat menangani penulisan data sebesar 24 MB/detik dalam mode sederhana atau 12 MB/detik dalam mode regex penuh. Anda tidak perlu menyesuaikan nilai parameter ini dalam kebanyakan kasus. Catatan Jika Logtail diterapkan dalam kluster ACK dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, atur jumlah thread di Konsol ACK. Di halaman Add-ons, modifikasi parameter LogtailDSProcessThreadCount dari komponen logtail-ds. Untuk informasi lebih lanjut, lihat Kelola komponen.	"process_thread_count" : 1
   send_request_concurrency	int	Jumlah permintaan konkuren asinkron. Nilai valid adalah sebagai berikut: Rentang: 1 hingga 50 Nilai default: 20 Jika TPS tulis tinggi, Anda dapat mengatur jumlah permintaan konkuren asinkron yang lebih tinggi. Anda dapat menghitung ini berdasarkan satu permintaan konkuren mendukung throughput jaringan 0,5 MB/detik hingga 1 MB/detik. Nilai aktual tergantung pada latensi jaringan. Catatan Mengatur jumlah permintaan konkuren asinkron terlalu tinggi dapat menyebabkan penggunaan port jaringan yang berlebihan. Sesuaikan parameter terkait TCP. Jika Logtail diterapkan dalam kluster ACK dan versi Logtail adalah Logtail-ds 1.7.3 atau lebih baru, atur jumlah permintaan konkuren asinkron di Konsol ACK. Di halaman Add-ons, modifikasi parameter LogtailDSSendRequestConcurrency dari komponen logtail-ds. Untuk informasi lebih lanjut, lihat Kelola komponen.	"send_request_concurrency" : 4
   buffer_file_num	int	Jumlah maksimum file cache. Nilai valid adalah sebagai berikut: Rentang: 1 hingga 100 Nilai default: 25 Jika terjadi pengecualian jaringan atau kuota tulis dilampaui, Logtail menulis log yang diurai secara real-time ke file lokal di direktori instalasi untuk caching. Logtail mencoba mengirimnya kembali setelah masalah diselesaikan.	"buffer_file_num" : 25
   buffer_file_size	int	Ukuran maksimum file cache tunggal dalam byte. Nilai valid adalah sebagai berikut: Rentang: 1048576 Byte hingga 104857600 Byte Nilai default: 20971520 Byte Ruang disk maksimum yang dapat digunakan oleh file cache adalah buffer_file_size × buffer_file_num.	"buffer_file_size" : 20971520
   buffer_file_path	String	Direktori tempat file cache disimpan. Nilai default kosong, yang berarti file cache disimpan di direktori instalasi Logtail /usr/local/ilogtail. Setelah Anda mengatur parameter ini, pindahkan file bernama logtail\_buffer\_file_* dari direktori asli ke direktori ini secara manual. Ini memastikan bahwa Logtail dapat membaca file cache dan menghapusnya setelah dikirim.	"buffer_file_path" : ""
   bind_interface	String	Nama kartu antarmuka jaringan (NIC) yang terikat ke mesin lokal. Nilai default kosong, yang berarti NIC yang tersedia secara otomatis terikat. Jika Anda mengatur ini ke NIC tertentu, seperti eth1, Logtail dipaksa menggunakan NIC itu untuk mengunggah log. Parameter ini hanya didukung untuk Linux.	"bind_interface" : ""
   check_point_filename	String	Path tempat file checkpoint Logtail disimpan. Nilai default: /tmp/logtail_check_point. Jika Anda menggunakan Docker atau Kubernetes, konfigurasikan parameter ini dengan merujuk ke Keandalan data iLogtail setelah kontainer di-restart. Ini mencegah duplikasi atau kehilangan data yang disebabkan oleh hilangnya informasi checkpoint ketika kontainer Logtail di-restart.	"check_point_filename" : /tmp/logtail_check_point
   check_point_dump_interval	int	Interval waktu Logtail memperbarui file checkpoint. Nilai default: 900. Unit: detik. Secara default, Logtail memperbarui file checkpoint setiap 15 menit. Parameter ini hanya didukung di Linux Logtail 1.0.19 dan lebih baru atau Windows Logtail 1.0.19.0 dan lebih baru.	"check_point_dump_interval" : 900
   user_config_file_path	String	Path tempat file konfigurasi Logtail disimpan. Secara default, ini adalah direktori binari proses, dan nama file adalah user_log_config.json. Jika Anda menggunakan Docker atau Kubernetes, konfigurasikan parameter ini dengan merujuk ke Keandalan data iLogtail setelah kontainer di-restart. Ini mencegah duplikasi atau kehilangan data ketika kontainer Logtail di-restart.	"user_config_file_path" : user_log_config.json
   docker_file_cache_path	String	File ini mencatat pemetaan path dari file kontainer ke file host. Path default adalah /usr/local/ilogtail/docker_path_config.json. Jika Anda menggunakan Docker atau Kubernetes, konfigurasikan parameter ini dengan merujuk ke Keandalan data iLogtail setelah kontainer di-restart. Ini mencegah duplikasi atau kehilangan data ketika kontainer Logtail di-restart. Parameter ini hanya didukung di Linux Logtail 0.16.54 dan lebih baru atau Windows Logtail 0.16.54.0 dan lebih baru.	"docker_file_cache_path": /usr/local/ilogtail/docker_path_config.json
   discard_old_data	Boolean	Menentukan apakah akan membuang log historis. Nilai default: true. Ini berarti log yang lebih tua dari 12 jam dari waktu saat ini dibuang.	"discard_old_data" : true
   ilogtail_discard_interval	int	Ambang batas untuk membuang log historis relatif terhadap waktu saat ini. Nilai default: 43200 (12 jam). Unit: detik.	"ilogtail_discard_interval": 43200
   working_ip	String	Nilai default kosong, yang berarti alamat IP secara otomatis diperoleh dari server lokal. Setelah dimodifikasi, Logtail melaporkan nilai ini sebagai alamat IP server.	"working_ip" : ""
   working_hostname	String	Nama host server lokal yang dilaporkan oleh Logtail. Nilai default kosong, yang berarti nama host secara otomatis diperoleh dari server lokal.	"working_hostname" : ""
   max_read_buffer_size	long	Ukuran maksimum entri log tunggal yang dapat dibaca. Nilai default: 524288 (512 KB). Nilai maksimum: 8388608 (8 MB). Unit: Byte. Jika entri log tunggal melebihi 524288 Byte, modifikasi parameter ini.	"max_read_buffer_size" : 524288
   oas_connect_timeout	long	Timeout koneksi untuk permintaan yang diinisiasi oleh Logtail untuk mendapatkan konfigurasi, Pasangan Kunci Akses, dan informasi lainnya. Nilai default: 5. Unit: detik. Modifikasi parameter ini jika koneksi memerlukan waktu terlalu lama untuk dibangun karena kondisi jaringan yang buruk.	"oas_connect_timeout" : 5
   oas_request_timeout	long	Timeout total permintaan untuk permintaan yang diinisiasi oleh Logtail untuk mendapatkan konfigurasi, Pasangan Kunci Akses, dan informasi lainnya. Nilai default: 10. Unit: detik. Modifikasi parameter ini jika koneksi memerlukan waktu terlalu lama untuk dibangun karena kondisi jaringan yang buruk.	"" : 10
   data_server_port	long	Setelah Anda mengatur data_server_port menjadi 443, Logtail mentransmisikan data ke Simple Log Service melalui HTTPS. Parameter ini hanya didukung di Linux Logtail 1.0.10 dan lebih baru atau Windows Logtail 1.0.10.0 dan lebih baru.	"data_server_port": 443
   enable_log_time_auto_adjust	Boolean	Setelah Anda mengatur enable_log_time_auto_adjust menjadi true, waktu log menyesuaikan dengan waktu lokal server. Untuk keamanan data, Simple Log Service memvalidasi waktu yang dibawa oleh permintaan, termasuk permintaan dari Logtail. Permintaan dengan selisih waktu lebih dari 15 menit dari waktu server ditolak. Permintaan Logtail membawa waktu lokal server. Jika waktu lokal server diubah, misalnya, ke waktu mendatang untuk pengujian, permintaan Logtail ditolak, menyebabkan kegagalan penulisan data. Gunakan parameter ini untuk membuat waktu log menyesuaikan dengan waktu lokal server. Parameter ini hanya didukung di Linux Logtail 1.0.19 dan lebih baru atau Windows Logtail 1.0.19.0 dan lebih baru. Penting Ketika fitur ini diaktifkan, offset antara waktu server Simple Log Service dan waktu server lokal ditambahkan ke waktu log. Karena offset hanya diperbarui ketika permintaan ditolak oleh server Simple Log Service, waktu log yang diperoleh pada server mungkin tidak sama dengan waktu tulis log sebenarnya. Beberapa logika Logtail bergantung pada peningkatan waktu sistem. Mulai ulang Logtail setelah setiap penyesuaian waktu mesin.	"enable_log_time_auto_adjust": true
   accept_multi_config	Boolean	Menentukan apakah mengizinkan beberapa konfigurasi Logtail untuk mengumpulkan log dari file yang sama. Nilai default: false. Ini berarti tidak diizinkan. Secara default, file hanya dapat dikumpulkan oleh satu konfigurasi Logtail. Gunakan parameter ini untuk menghapus batasan tersebut. Pemrosesan setiap konfigurasi Logtail bersifat independen. Mengizinkan beberapa konfigurasi Logtail untuk mengumpulkan log dari file yang sama mengonsumsi overhead CPU dan memori beberapa kali lipat. Parameter ini hanya didukung di Linux Logtail 0.16.26 dan lebih baru atau Windows Logtail 0.16.26.0 dan lebih baru.	"accept_multi_config": true
   enable_checkpoint_sync_write	Boolean	Menentukan apakah akan mengaktifkan fitur penulisan sinkron. Nilai default: false. Ini berarti tidak diaktifkan. Fitur penulisan sinkron utamanya digunakan dengan fitur penulisan ExactlyOnce. Setelah fitur penulisan ExactlyOnce diaktifkan, Logtail mencatat informasi checkpoint detail halus pada tingkat file di disk lokal. Namun, demi alasan performa, fitur penulisan sinkron tidak dipanggil secara default saat menulis checkpoint. Oleh karena itu, jika mesin di-restart dan data buffer tidak ditulis ke disk tepat waktu, checkpoint mungkin hilang. Dalam kasus ini, atur enable_checkpoint_sync_write menjadi true untuk mengaktifkan fitur penulisan sinkron. Untuk informasi lebih lanjut, lihat Konfigurasi Logtail (legacy). Parameter ini hanya didukung di Linux Logtail 1.0.20 dan lebih baru atau Windows Logtail 1.0.20.0 dan lebih baru.	"enable_checkpoint_sync_write": false
   enable_env_ref_in_config	Boolean	Menentukan apakah akan mengaktifkan fitur penggantian variabel lingkungan untuk konfigurasi koleksi. Nilai default: false. Setelah Anda mengaktifkan fitur ini, Anda dapat menggunakan ${xxx} sebagai placeholder untuk variabel lingkungan xxx dalam konfigurasi koleksi Logtail di konsol. Sebagai contoh, jika Anda mengatur path koleksi menjadi /${xxx}/logs dan variabel lingkungan menjadi xxx=user, path koleksi efektif adalah /user/logs. Untuk menggunakan ${ atau } dalam konfigurasi, gunakan $${ atau $} untuk melarikannya. Parameter ini hanya didukung di Linux Logtail 1.0.31 dan lebih baru atau Windows Logtail 1.0.31.0 dan lebih baru.	"enable_env_ref_in_config": false
   docker_config_update_interval	int	Interval waktu minimum untuk memperbarui path kontainer. Parameter ini digunakan bersama dengan max_docker_config_update_times. Jika ambang batas salah satu parameter tercapai, path kontainer tidak diperbarui lagi. Untuk Linux Logtail 1.0.32 dan lebih baru atau Windows Logtail 1.0.32.0 dan lebih baru, nilai default adalah 3. Unit: detik. Untuk Linux Logtail sebelum 1.0.32 atau Windows Logtail sebelum 1.0.32.0, nilai default adalah 10. Unit: detik.	"docker_config_update_interval": 3
   max_docker_config_update_times	int	Jumlah maksimum kali path kontainer dapat diperbarui dalam 3 menit. Secara default, jika path kontainer diperbarui lebih dari 3 kali dalam 3 menit, path tersebut tidak akan diperbarui lagi. Untuk Linux Logtail 1.0.32 dan lebih baru atau Windows Logtail 1.0.32.0 dan lebih baru, nilai default adalah 10. Untuk Linux Logtail sebelum 1.0.32 atau Windows Logtail sebelum 1.0.32.0, nilai default adalah 3.	"max_docker_config_update_times": 10
   DOCKER_HOST	String	Alamat socket untuk berkomunikasi dengan Docker. Konfigurasikan ini menggunakan variabel lingkungan. Nilai default kosong, yang berarti alamat default unix:///var/run/docker.sock digunakan.	DOCKER_HOST=unix:///var/run/docker.sock
   CONTAINERD_SOCK_PATH	String	Alamat socket untuk berkomunikasi dengan containerd. Konfigurasikan ini menggunakan variabel lingkungan. Nilai default kosong, yang berarti alamat default unix:///run/containerd/containerd.sock digunakan. Jika ini adalah kluster K3s, Anda dapat memodifikasinya seperti yang ditunjukkan dalam contoh.	CONTAINERD_SOCK_PATH=/run/k3s/containerd/containerd.sock
   logreader_max_rotate_queue_size	Int	Panjang maksimum antrian rotasi. Nilai default: 20. Saat pengumpulan log terblokir atau tertunda, file yang akan dikumpulkan memegang handle file dan menunggu di antrian. Saat pengumpulan tertunda, pertimbangkan untuk mengurangi nilai ini untuk mengontrol penggunaan disk maksimum. Peringatan Ketika jumlah file yang tertunda melebihi nilai ini, Logtail melewati pengumpulan file baru.	"logreader_max_rotate_queue_size" : 10
   force_release_deleted_file_fd_timeout	Int	Handle dilepaskan dalam periode tertentu setelah kontainer keluar atau file dihapus. Anda dapat menentukan waktu tersebut. Nilai default: -1, yang berarti fitur dinonaktifkan. Nilai 0 berarti pelepasan segera. Unit: detik. Jika Anda ingin mengontrol penundaan maksimum penghancuran kontainer containerd, pertimbangkan untuk mengatur parameter ini. Peringatan Saat pengumpulan tertunda, data yang tertunda melebihi waktu yang dikonfigurasi akan hilang.	"force_release_deleted_file_fd_timeout" : 0
   data_endpoint_policy	string	Kebijakan Alih bencana untuk Logtail mengakses titik akhir Simple Log Service. Nilai-nilai berikut dapat dipilih: Catatan Dalam file ilogtail_config.json, periksa parameter data_server_list untuk melihat apakah nama domain default dikonfigurasikan. Untuk informasi lebih lanjut, lihat File konfigurasi parameter startup (ilogtail_config.json). designated_first (default) Jika nama domain default ditentukan untuk wilayah dan tersedia, sistem menggunakan nama domain default terlebih dahulu. Jika nama domain default ditentukan untuk wilayah tetapi tidak tersedia, sistem secara otomatis memilih nama domain yang tersedia. Jika tidak ada nama domain default yang ditentukan untuk wilayah, sistem secara otomatis memilih nama domain yang tersedia. designated_locked Jika nama domain default ditentukan untuk wilayah, sistem hanya menggunakan nama domain default, terlepas dari ketersediaannya. Jika tidak ada nama domain default yang ditentukan untuk wilayah, sistem secara otomatis memilih nama domain yang tersedia. Parameter ini hanya didukung di Linux Logtail 1.5.0 dan lebih baru atau Windows Logtail 1.5.0.0 dan lebih baru.	"data_endpoint_policy" : "designated_first"
   inotify_black_list	Array<String>	Daftar hitam pendengar inotify. Daftar hitam menggunakan pencocokan eksak. Direktori dalam daftar ini tidak mengaktifkan pendengaran inotify.	"inotify_black_list": ["/tmp"]
   host_path_blacklist	String	Daftar hitam global jalur host. Daftar hitam menggunakan pencocokan substring. Di Linux, pisahkan beberapa substring dengan titik dua (:). Di Windows, pisahkan beberapa substring dengan titik koma (;). Sebagai contoh, "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-" melarang pengumpulan data mount NAS. Parameter ini hanya didukung di Linux Logtail 1.8.0 dan lebih baru atau Windows Logtail 1.8.0.0 dan lebih baru.	"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"
   LOGTAIL_LOG_LEVEL	String	Tingkat pencetakan log. Konfigurasikan ini menggunakan variabel lingkungan. Nilai default kosong, yang berarti info. Nilai opsional adalah trace, debug, info, warning, error, dan fatal. Parameter ini hanya didukung di Linux Logtail 1.8.0 dan lebih baru atau Windows Logtail 1.8.0.0 dan lebih baru.	LOGTAIL_LOG_LEVEL=info
   FORCE_RELEASE_STOP_CONTAINER_FILE	Boolean	Metode konfigurasi: Parameter ini hanya dapat dikonfigurasikan menggunakan variabel lingkungan. Deskripsi fitur: Ketika parameter ini disetel ke true, Logtail segera melepaskan handle file kontainer ketika kontainer aplikasi keluar. Operasi ini mencegah kontainer gagal keluar secara normal karena handle file tidak dilepaskan. Catatan: Dalam kasus ini, kelengkapan pengumpulan data dari kontainer tidak dapat dijamin. Tambahkan penundaan beberapa detik sebelum aplikasi keluar untuk memastikan bahwa log dapat dikumpulkan sepenuhnya. Versi yang didukung: Linux Logtail 2.1.6 dan lebih baru	"FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"
   default_reader_flush_timeout	int	Periode timeout untuk menentukan kelengkapan baris log terakhir. Nilai default: 60. Unit: detik. Parameter ini hanya didukung di Logtail 2.0.0 dan lebih baru.	"default_reader_flush_timeout" : 1

3. Restart Logtail agar konfigurasi berlaku.

   /etc/init.d/ilogtaild stop && /etc/init.d/ilogtaild start                        

   Setelah restart, Anda dapat menjalankan perintah /etc/init.d/ilogtaild status untuk memeriksa status Logtail.

Lampiran: Variabel lingkungan

Tabel berikut menjelaskan pemetaan antara variabel lingkungan dan parameter startup Logtail.

File konfigurasi parameter startup (ilogtail_config.json)

• Lokasi File

  • Lingkungan Host

    Sistem operasi	Logtail	Lokasi file ilogtail_config.json
    Linux	Logtail (program 64-bit)	/usr/local/ilogtail/ilogtail_config.json
    Windows (OS 64-bit)	Logtail (program 64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
    	Logtail (program 32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json Catatan OS Windows 64-bit mendukung aplikasi 32-bit dan 64-bit. Untuk kompatibilitas, Windows menggunakan direktori x86 terpisah untuk menyimpan aplikasi 32-bit.
    Windows (OS 32-bit)	Logtail (program 32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

  • Lingkungan Kontainer

    File ilogtail_config.json disimpan di kontainer Logtail. Lokasi file dikonfigurasi dalam variabel lingkungan ALIYUN_LOGTAIL_CONFIG dari kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_CONFIG untuk melihat lokasi. Contoh: /etc/ilogtail/conf/cn-hangzhou/ilogtail_config.json.

• Contoh File

  $cat /usr/local/ilogtail/ilogtail_config.json
  {
      "config_server_address" : "http://logtail.cn-hangzhou-intranet.log.aliyuncs.com",
      "data_server_list" :
      [
          {
              "cluster" : "cn-hangzhou",
              "endpoint" : "cn-hangzhou-intranet.log.aliyuncs.com"
          }
      ],
      "cpu_usage_limit" : 0.4,
      "mem_usage_limit" : 100,
      "max_bytes_per_sec" : 2097152,
      "process_thread_count" : 1,
      "send_request_concurrency" : 4,
      "streamlog_open" : false
  }

File konfigurasi pengidentifikasi pengguna

File konfigurasi pengidentifikasi pengguna berisi ID Akun Alibaba Cloud Anda. ID ini menunjukkan bahwa akun tersebut memiliki izin untuk mengakses server ini dan mengumpulkan log-nya. Untuk informasi lebih lanjut, lihat Konfigurasikan Pengidentifikasi Pengguna.

• Jalur File

  • Lingkungan Host

    • Linux: /etc/ilogtail/users/

    • Windows: C:\LogtailData\users\

  • Lingkungan Kontainer

    Pengidentifikasi pengguna disimpan dalam Variabel lingkungan ALIYUN_LOGTAIL_USER_ID dari Kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_ID untuk melihat pengidentifikasi pengguna.

• Contoh File

  $ls /etc/ilogtail/users/

File identifier kustom (user_defined_id)

File user_defined_id digunakan untuk mengonfigurasi ID kustom. Untuk informasi lebih lanjut, lihat Buat Kelompok Mesin Berdasarkan ID Kustom.

• Jalur File

  • Lingkungan Host

    • Linux: /etc/ilogtail/user_defined_id

    • Windows: C:\LogtailData\user_defined_id

  • Lingkungan Kontainer

    ID kustom dikonfigurasi dalam ALIYUN_LOGTAIL_USER_DEFINED_ID variabel lingkungan Kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID untuk melihat ID kustom.

• Contoh File

  $cat /etc/ilogtail/user_defined_id
  aliyun-ecs-rs1e16355

File konfigurasi koleksi Logtail (user_log_config.json)

File user_log_config.json mencatat informasi konfigurasi koleksi Logtail yang diperoleh dari Simple Log Service. File ini dalam format JSON dan diperbarui secara sinkron setiap kali konfigurasi koleksi Logtail diperbarui. Anda dapat menggunakan file user_log_config.json untuk memastikan apakah konfigurasi koleksi Logtail telah dikirimkan ke server. Jika file konfigurasi koleksi Logtail ada dan isinya konsisten dengan konfigurasi koleksi Logtail pada Simple Log Service, maka konfigurasi telah dikirimkan.

• Lokasi File

  • Lingkungan Host

    Sistem operasi	Logtail	Lokasi file user_log_config.json
    Linux	Logtail (program 64-bit)	/usr/local/ilogtail/user_log_config.json
    Windows (OS 64-bit)	Logtail (program 64-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json
    	Logtail (program 32-bit)	C:\Program Files (x86)\Alibaba\Logtail\user_log_config.json Catatan OS Windows 64-bit mendukung aplikasi 32-bit dan 64-bit. Untuk kompatibilitas, Windows menggunakan direktori x86 terpisah untuk menyimpan aplikasi 32-bit.
    Windows (OS 32-bit)	Logtail (program 32-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json

  • Lingkungan Kontainer

    File user_log_config.json disimpan di kontainer Logtail pada lokasi /usr/local/ilogtail/user_log_config.json.

• Contoh File

  $cat /usr/local/ilogtail/user_log_config.json
  {
     "metrics" : {
        "##1.0##k8s-log-c12ba2028*****939f0b$app-java" : {
           "aliuid" : "16542189*****50",
           "category" : "app-java",
           "create_time" : 1534739165,
           "defaultEndpoint" : "cn-hangzhou-intranet.log.aliyuncs.com",
           "delay_alarm_bytes" : 0,
           "enable" : true,
           "enable_tag" : true,
           "filter_keys" : [],
           "filter_regs" : [],
           "group_topic" : "",
           "local_storage" : true,
           "log_type" : "plugin",
           "log_tz" : "",
           "max_send_rate" : -1,
           "merge_type" : "topic",
           "plugin" : {
              "inputs" : [
                 {
                    "detail" : {
                       "IncludeEnv" : {
                          "aliyun_logs_app-java" : "stdout"
                       },
                       "IncludeLable" : {
                          "io.kubernetes.container.name" : "java-log-demo-2",
                          "io.kubernetes.pod.namespace" : "default"
                       },
                       "Stderr" : true,
                       "Stdout" : true
                    },
                    "type" : "service_docker_stdout"
                 }
              ]
           },
           "priority" : 0,
           "project_name" : "k8s-log-c12ba2028c*****ac1286939f0b",
           "raw_log" : false,
           "region" : "cn-hangzhou",
           "send_rate_expire" : 0,
           "sensitive_keys" : [],
           "tz_adjust" : false,
           "version" : 1
        }
     }
  }

File Catatan AppInfo (app_info.json)

File app_info.json mencatat waktu mulai Logtail, alamat IP yang diperoleh, hostname, dan informasi lainnya.

• Path File

  • Lingkungan Host

    Sistem operasi	Logtail	Path file app_info.json
    Linux	Logtail (program 64-bit)	/usr/local/ilogtail/app_info.json
    Windows (OS 64-bit)	Logtail (program 64-bit)	C:\Program Files\Alibaba\Logtail\app_info.json
    	Logtail (program 32-bit)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json Catatan OS Windows 64-bit mendukung aplikasi 32-bit dan 64-bit. Untuk kompatibilitas, Windows menggunakan direktori x86 terpisah untuk menyimpan aplikasi 32-bit.
    Windows (OS 32-bit)	Logtail (program 32-bit)	C:\Program Files\Alibaba\Logtail\app_info.json

  • Lingkungan Kontainer

    File app_info.json disimpan di kontainer Logtail pada jalur /usr/local/ilogtail/app_info.json.

• Contoh File

  $cat /usr/local/ilogtail/app_info.json
  {
     "UUID" : "",
     "hostname" : "logtail-ds-slpn8",
     "instance_id" : "E5F93BC6-B024-11E8-8831-0A58AC14039E_1**.***.***.***_1536053315",
     "ip" : "1**.***.***.***",
     "logtail_version" : "0.16.13",
     "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
     "update_time" : "2018-09-04 09:28:36"
  }

  Bidang	Deskripsi
  UUID	Nomor seri server.
  hostname	Nama hostname.
  instance_id	Pengenal unik yang dihasilkan secara acak untuk Logtail.
  ip	Alamat IP yang diperoleh oleh Logtail. Jika bidang ini kosong, Logtail belum memperoleh alamat IP dan tidak dapat berjalan dengan normal. Tetapkan alamat IP untuk server dan restart Logtail. Catatan Jika Anda membuat kelompok mesin berbasis alamat IP, pastikan bahwa alamat IP yang dikonfigurasi dalam kelompok mesin sama dengan alamat IP yang ditampilkan di sini. Jika tidak sama, konfirmasikan alamat IP host yang benar. Kemudian, modifikasi alamat IP dalam kelompok mesin di Simple Log Service console atau modifikasi parameter working_ip dalam Setel parameter startup Logtail.
  logtail_version	Versi klien Logtail.
  os	Versi sistem operasi.
  update_time	Waktu terakhir Logtail dimulai.

Log operasional Logtail (ilogtail.LOG)

File ilogtail.LOG mencatat log operasional dari Logtail. Tingkat log, dari yang terendah hingga tertinggi, adalah INFO, WARN, dan ERROR. Anda dapat mengabaikan log dengan tingkat INFO.

• Path File

  • Lingkungan Host

    Sistem operasi	Logtail	Path file ilogtail.LOG
    Linux	Logtail (program 64-bit)	/usr/local/ilogtail/ilogtail.LOG
    Windows (OS 64-bit)	Logtail (program 64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG
    	Logtail (program 32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail.LOG Catatan OS Windows 64-bit mendukung aplikasi 32-bit dan 64-bit. Untuk kompatibilitas, Windows menggunakan direktori x86 terpisah untuk menyimpan aplikasi 32-bit.
    Windows (OS 32-bit)	Logtail (program 32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG

  • Lingkungan Kontainer

    File ilogtail.LOG disimpan di kontainer Logtail pada path /usr/local/ilogtail/ilogtail.LOG.

• Contoh File

  $tail /usr/local/ilogtail/ilogtail.LOG
  [2018-09-13 01:13:59.024679]    [INFO]    [3155]    [build/release64/sls/ilogtail/elogtail.cpp:123]    mengubah direktori kerja:/usr/local/ilogtail/
  [2018-09-13 01:13:59.025443]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:175]    memuat file konfigurasi logtail, path:/etc/ilogtail/conf/ap-southeast-1/ilogtail_config.json
  [2018-09-13 01:13:59.025460]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:176]    memuat file konfigurasi logtail, detail:{
     "config_server_address" : "http://logtail.ap-southeast-1-intranet.log.aliyuncs.com",
     "data_server_list" : [
        {
           "cluster" : "ap-southeast-1",
           "endpoint" : "ap-southeast-1-intranet.log.aliyuncs.com"
        }
  ]

Log Logtail plugin (logtail_plugin.LOG)

File logtail_plugin.LOG mencatat log operasional dari plugin Logtail. Tingkat log, dari yang terendah hingga tertinggi, adalah INFO, WARN, dan ERROR. Anda dapat mengabaikan log dengan tingkat INFO.

Jika terjadi kesalahan seperti CANAL_RUNTIME_ALARM selama diagnosis, gunakan file logtail_plugin.LOG untuk menyelesaikan kesalahan tersebut.

• Lokasi File

  • Lingkungan Host

    Sistem operasi	Logtail	Jalur file logtail_plugin.LOG
    Linux	Logtail (program 64-bit)	/usr/local/ilogtail/logtail_plugin.LOG
    Windows (OS 64-bit)	Logtail (program 64-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG
    	Logtail (program 32-bit)	C:\Program Files (x86)\Alibaba\Logtail\logtail_plugin.LOG Catatan OS Windows 64-bit mendukung aplikasi 32-bit dan 64-bit. Untuk kompatibilitas, Windows menggunakan direktori x86 terpisah untuk menyimpan aplikasi 32-bit.
    Windows (OS 32-bit)	Logtail (program 32-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG

  • Lingkungan Kontainer

    File logtail_plugin.LOG disimpan di kontainer Logtail pada lokasi /usr/local/ilogtail/logtail_plugin.LOG.

• Contoh File

  $tail /usr/local/ilogtail/logtail_plugin.LOG
  2018-09-13 02:55:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 02:55:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:00:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:00:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    membuka file untuk dibaca, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    membuka file untuk dibaca, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:04:26 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    menutup file, alasan:tidak ada waktu baca    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:04:27 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    menutup file, alasan:tidak ada waktu baca    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:05:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:05:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop

File Pemetaan Path Kontainer (docker_path_config.json)

File docker_path_config.json hanya dibuat saat mengumpulkan log kontainer. File ini mencatat hubungan pemetaan path antara file kontainer dan file host. File ini berformat JSON.

Jika terjadi kesalahan DOCKER_FILE_MAPPING_ALARM selama diagnosis, itu menunjukkan kegagalan dalam menambahkan pemetaan file Docker. Gunakan file docker_path_config.json untuk menganalisis kesalahan tersebut.

• Path File

  /usr/local/ilogtail/docker_path_config.json

• Contoh File

  $cat /usr/local/ilogtail/docker_path_config.json
  {
     "detail" : [
        {
           "config_name" : "##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$nginx",
           "container_id" : "df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10",
           "params" : "{\n   \"ID\" : \"df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10\",\n   \"Path\" : \"/logtail_host/var/lib/docker/overlay2/947db346695a1f65e63e582ecfd10ae1f57019a1b99260b6c83d00fcd1892874/diff/var/log\",\n   \"Tags\" : [\n      \"nginx-type\",\n      \"access-log\",\n      \"_image_name_\",\n      \"registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest\",\n      \"_container_name_\",\n      \"nginx-log-demo\",\n      \"_pod_name_\",\n      \"nginx-log-demo-h2lzc\",\n      \"_namespace_\",\n      \"default\",\n      \"_pod_uid_\",\n      \"87e56ac3-b65b-11e8-b172-00163f008685\",\n      \"_container_ip_\",\n      \"172.20.4.224\",\n      \"purpose\",\n      \"test\"\n   ]\n}\n"
        } 
     ],
     "version" : "0.1.0"
  }