1. Tarik citra

Pada mesin host yang telah menginstal Docker, jalankan perintah berikut untuk menarik citra LoongCollector. Ganti ${region_id} dengan ID wilayah tempat mesin host berada atau wilayah terdekat, seperti cn-hangzhou, untuk meningkatkan kecepatan unduh dan stabilitas.

# Alamat citra LoongCollector
docker pull aliyun-observability-release-registry.${region_id}.cr.aliyuncs.com/loongcollector/loongcollector:v3.0.12.0-25723a1-aliyun
# Alamat citra Logtail
docker pull registry.${region_id}.aliyuncs.com/log-service/logtail:v2.1.11.0-aliyun

2. Jalankan kontainer LoongCollector

Jalankan perintah berikut untuk memulai kontainer. Pastikan Anda memasang direktori yang diperlukan dan mengatur variabel lingkungan yang diperlukan:

docker run -d \
    -v /:/logtail_host:ro \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/${sls_upload_channel}/ilogtail_config.json \
    --env ALIYUN_LOGTAIL_USER_ID=${aliyun_account_id} \
    --env ALIYUN_LOGTAIL_USER_DEFINED_ID=${user_defined_id} \
    aliyun-observability-release-registry.${region_id}.cr.aliyuncs.com/loongcollector/loongcollector:v3.0.12.0-25723a1-aliyun

Parameter:

• ${aliyun_account_id}: ID akun Alibaba Cloud Anda.

• ${user_defined_id}: Pengenal kustom kelompok mesin, yang mengikat kontainer ke kelompok mesin, seperti user-defined-docker-1. Pengenal tersebut harus unik dalam wilayah tersebut.

• ${sls_upload_channel}: Saluran unggah log. Nilainya terdiri dari wilayah tempat proyek berada dan jenis transmisi jaringan, seperti dijelaskan dalam tabel berikut.

Untuk karakteristik jaringan di balik setiap jenis transmisi, lihat bagian Lampiran: Jenis Transmisi Jaringan dalam topik ini.

Syarat startup yang diperlukan:

• Konfigurasikan dengan benar tiga variabel lingkungan utama: ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID, dan ALIYUN_LOGTAIL_USER_DEFINED_ID.

• Pasang /var/run/docker.sock untuk mendengarkan event siklus hidup kontainer.

• Pasang / ke /logtail_host untuk mengakses sistem file mesin host.

3. Verifikasi status kontainer

Jalankan perintah berikut:

docker ps | grep loongcollector

Output berikut dikembalikan:

6ad510001753   aliyun-observability-release-registry.cn-beijing.cr.aliyuncs.com/loongcollector/loongcollector:v3.0.12.0-25723a1-aliyun   "/usr/local/ilogtail…"   About a minute ago   Up About a minute             recursing_shirley

4. Konfigurasikan kelompok mesin

Di panel navigasi kiri, pilih Resource Group > Machine Groups. Klik > Create Machine Group, konfigurasikan parameter berikut, lalu klik OK:

• Name: Masukkan nama kustom untuk kelompok mesin, seperti docker-host-group.

• Machine Group Identifier: Pilih Custom Identifier.

• Custom Identifier: Masukkan ${user_defined_id} yang Anda atur saat memulai kontainer. Nilainya harus identik. Jika tidak, asosiasi gagal.

5. Verifikasi heartbeat kelompok mesin

Klik nama kelompok mesin baru untuk membuka halaman detailnya, lalu periksa Machine Group Status:

• OK: LoongCollector terhubung ke Simple Log Service.

• FAIL: Lihat Summary of heartbeat issues untuk melakukan troubleshooting.

1. Konfigurasi Global dan Input

Sebelum memulai, pastikan Anda telah memilih templat impor data dan mengikat kelompok mesin. Langkah ini menentukan nama konfigurasi pengumpulan, sumber log, serta cakupan pengumpulan.

2. Pemrosesan dan penstrukturan log

Konfigurasikan aturan pemrosesan log untuk mengubah log mentah yang tidak terstruktur menjadi data terstruktur serta meningkatkan efisiensi kueri dan analisis log. Kami menyarankan Anda menambahkan sampel log terlebih dahulu:

Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Sample Log dan masukkan konten log yang ingin Anda kumpulkan. Simple Log Service mengidentifikasi format log dari sampel tersebut dan membantu menghasilkan ekspresi reguler serta aturan penguraian, sehingga menyederhanakan konfigurasi.

Skenario 1: Memproses log multi-baris, seperti log stack Java

Log seperti stack exception Java dan JSON biasanya mencakup beberapa baris. Dalam mode pengumpulan default, log tersebut dipisah menjadi beberapa entri yang tidak lengkap sehingga konteksnya hilang. Untuk mencegah hal ini, aktifkan mode multi-baris dan konfigurasikan ekspresi reguler baris pertama untuk menggabungkan baris-baris berurutan dari log yang sama menjadi satu entri lengkap.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, aktifkan Multi-line Mode:

• Type: Pilih Custom atau Multi-line JSON.

  • Custom: Format log mentah tidak tetap. Konfigurasikan Regex to Match First Line untuk mengidentifikasi baris awal setiap log.

    • Regex to Match First Line: Anda dapat menghasilkan ekspresi secara otomatis atau memasukkannya secara manual. Ekspresi reguler harus sesuai dengan satu baris lengkap. Pada contoh sebelumnya, ekspresinya adalah \[\d+-\d+-\w+:\d+:\d+,\d+]\s\[\w+]\s.*.

      • Generasi otomatis: Klik Automatically Generate Regular Expression, pilih konten log yang ingin diekstraksi di kotak teks Log Sample, lalu klik Generate Regular Expression.

      • Masukan manual: Klik Manually Enter Regular Expression. Setelah memasukkan ekspresi, klik Validate.

  • Multi-line JSON: Jika semua log mentah berada dalam format JSON standar, Simple Log Service secara otomatis menangani jeda baris di dalam satu log JSON.

• Processing Method If Splitting Fails:

  • Discard: Jika segmen teks tidak sesuai dengan aturan baris pertama, segmen tersebut dibuang.

  • Retain Single Line: Teks yang tidak sesuai dipisah dan dipertahankan dalam mode satu baris aslinya.

Skenario 2: Menstrukturkan log

Saat log mentah berupa teks tidak terstruktur atau semi-terstruktur—seperti access log NGINX atau output log aplikasi—melakukan kueri dan analisis secara langsung menjadi tidak efisien. Simple Log Service menyediakan berbagai plugin penguraian data yang secara otomatis mengonversi log mentah dalam berbagai format menjadi data terstruktur, sehingga memberikan fondasi data yang kuat untuk analisis, pemantauan, dan peringatan selanjutnya.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations:

• Tambahkan plugin penguraian: Klik Add Processor dan konfigurasikan plugin seperti penguraian ekspresi reguler, penguraian pembatas (delimiter), atau penguraian JSON sesuai format aktual. Untuk parameter tiap plugin, lihat bagian Lampiran: Plugin penguraian native pada topik ini. Contoh berikut mengumpulkan log NGINX, sehingga pilih Native Processor > Data Parsing (NGINX Mode).

  • NGINX Log Configuration: Salin definisi lengkaplog_format dari file konfigurasi server NGINX (nginx.conf) dan tempelkan ke kotak teks ini. Contoh:

    log_format main  '$remote_addr - $remote_user [$time_local] "$request" ''$request_time $request_length ''$status $body_bytes_sent "$http_referer" ''"$http_user_agent"';

    persis sama dengan format yang menghasilkan log di server. Jika tidak, penguraian log akan gagal.

• Parameter konfigurasi umum: Parameter berikut muncul di berbagai plugin penguraian data dan memiliki fungsi serta penggunaan yang sama.

  • Source field: Nama bidang sumber yang akan diurai. Nilai default: content, yaitu seluruh konten log yang dikumpulkan.

  • Keep source field on parse failure: Kami menyarankan Anda mengaktifkan opsi ini. Jika plugin tidak dapat mengurai log—misalnya karena ketidaksesuaian format—opsi ini mempertahankan konten log mentah lengkap di bidang sumber yang ditentukan alih-alih membuangnya.

  • Keep source field on parse success: Jika Anda memilih opsi ini, konten log mentah tetap dipertahankan meskipun log berhasil diurai.

3. Penyaringan log

Mengumpulkan volume besar log bernilai rendah atau tidak relevan—seperti log DEBUG atau INFO—memboroskan sumber daya penyimpanan, meningkatkan biaya, menurunkan efisiensi kueri, dan berpotensi menyebabkan kebocoran data. Gunakan kebijakan penyaringan detail halus untuk pengumpulan log yang efisien dan aman.

Penyaringan dikonfigurasi di dua lokasi dalam Konsol: penyaringan konten diatur melalui plugin pemrosesan pada bagian Processor Configurations, sedangkan daftar hitam koleksi dan penyaringan kontainer dikendalikan melalui sakelar di bagian Input Configurations.

4. Kategorisasi log

Ketika beberapa aplikasi atau instans menggunakan format log yang sama, sumber log menjadi sulit dibedakan, sehingga kueri kehilangan konteks dan efisiensi analisis menurun. Untuk mengatasi hal ini, konfigurasikan topik dan penandaan log guna mengasosiasikan konteks secara otomatis serta melakukan kategorisasi logis.

/data/logs
├── userA
│   └── serviceA
│       └── service.log
├── userB
│   └── serviceA
│       └── service.log
└── userC
    └── serviceA
        └── service.log

5. Konfigurasi Output

Secara default, semua log dikirim ke LogStore saat ini dengan kompresi lz4. Untuk mendistribusikan log dari sumber yang sama ke LogStore berbeda, ikuti langkah-langkah berikut.

Distribusi dinamis ke beberapa target

• Pengiriman ke beberapa target memerlukan LoongCollector versi 3.0.0 atau lebih baru. Logtail tidak mendukung fitur ini.

• Anda dapat mengonfigurasi hingga lima target output.

• Setelah mengonfigurasi beberapa target output, konfigurasi pengumpulan tersebut tidak lagi muncul dalam daftar konfigurasi pengumpulan LogStore saat ini. Untuk melihat, mengubah, atau menghapus konfigurasi distribusi multi-target, lihat Cara mengelola konfigurasi distribusi multi-target?.

  Prosedur: Pada halaman Logtail Configuration, di bagian Output Configurations:

1. Klik untuk memperluas konfigurasi output.

2. Klik Add Output Targets dan lengkapi pengaturan berikut:

   • Logstores: Pilih LogStore tujuan.

   • Compression Method: Metode lz4 dan zstd didukung.

   • Route Settings: Merutekan dan mendistribusikan log berdasarkan bidang tag-nya. Log yang memenuhi konfigurasi routing diunggah ke LogStore tujuan. Jika konfigurasi routing kosong, semua log yang dikumpulkan diunggah ke LogStore tujuan.

     • Tag Name: Nama bidang tag yang digunakan untuk routing. Masukkan nama bidang secara langsung, seperti __path__, tanpa awalan __tag__:. Bidang tag terbagi menjadi dua kategori berikut:

       • Terkait Agen: Terkait dengan agen pengumpulan itu sendiri dan independen dari plugin, seperti __hostname__ dan __user_defined_id__.

       • Terkait input plugin: Disediakan oleh input plugin, yang memperkaya log dengan informasi terkait, seperti __path__ untuk pengumpulan file dan _pod_name_ serta _container_name_ untuk pengumpulan Kubernetes.

         Untuk informasi lebih lanjut tentang tag, lihat Kelola tag pengumpulan.

     • Tag Value: Log yang nilai bidang tagnya cocok dengan nilai ini dikirim ke LogStore tujuan.

     • Discard this tag?: Jika Anda mengaktifkan sakelar ini, log yang diunggah tidak akan berisi bidang tag ini.

Lihat log yang diunggah

• Konfirmasi bahwa file log memiliki konten baru: LoongCollector hanya mengumpulkan log inkremental. Jalankan tail -f /path/to/your/log/file dan picu operasi aplikasi untuk memastikan log baru sedang ditulis.

• Kueri log: Buka halaman kueri dan analisis LogStore tujuan dan klik Search & Analyze. Rentang waktu default adalah 15 menit terakhir. Periksa apakah log baru tiba. Secara default, setiap log teks kontainer Docker yang dikumpulkan berisi field berikut:

Untuk nama field metadata yang digunakan oleh output standar kontainer, lihat bagian Lampiran: Perbandingan Versi Output Standar Kontainer Baru dan Lama dalam topik ini.

Atasi masalah umum

Lihat status berjalan LoongCollector (Logtail)

Jalankan perintah berikut:

docker exec ${logtail_container_id} /etc/init.d/ilogtaild status

Lihat versi, alamat IP, waktu mulai, dan informasi lainnya LoongCollector (Logtail)

Jalankan perintah berikut:

docker exec ${logtail_container_id} cat /usr/local/ilogtail/app_info.json

Lihat log operasional LoongCollector (Logtail)

Log operasional LoongCollector (Logtail) disimpan di direktori /usr/local/ilogtail/ di dalam kontainer. Nama file-nya adalah ilogtail.LOG, dan file yang dirotasi dikompresi dan disimpan sebagai ilogtail.LOG.x.gz. Contoh:

# Lihat log operasional LoongCollector

docker exec a287de895e40 tail -n 5 /usr/local/ilogtail/loongcollector.LOG

# Lihat log operasional Logtail

docker exec a287de895e40 tail -n 5 /usr/local/ilogtail/ilogtail.LOG

Output berikut dikembalikan:

[2025-08-25 09:17:44.610496]    [info]  [22]    /build/loongcollector/file_server/polling/PollingModify.cpp:75          polling modify resume:succeeded
[2025-08-25 09:17:44.610497]    [info]  [22]    /build/loongcollector/file_server/polling/PollingDirFile.cpp:100                polling discovery resume:starts
[2025-08-25 09:17:44.610498]    [info]  [22]    /build/loongcollector/file_server/polling/PollingDirFile.cpp:103                polling discovery resume:succeeded
[2025-08-25 09:17:44.610499]    [info]  [22]    /build/loongcollector/file_server/FileServer.cpp:117            file server resume:succeeded
[2025-08-25 09:17:44.610500]    [info]  [22]    /build/loongcollector/file_server/EventDispatcher.cpp:1019              checkpoint dump:succeeded

Restart LoongCollector (Logtail)

Jalankan perintah berikut:

# Hentikan LoongCollector

docker exec a287de895e40 /etc/init.d/ilogtaild stop

# Mulai LoongCollector

docker exec a287de895e40 /etc/init.d/ilogtaild start

Pesan error umum

Log error: The parameter is invalid : uuid=none

Deskripsi masalah: File log LoongCollector (Logtail) (/usr/local/ilogtail/ilogtail.LOG) berisi log error The parameter is invalid : uuid=none.

Solusi: Di mesin host, buat file product_uuid, masukkan UUID valid apa pun ke dalamnya, seperti 169E98C9-ABC0-4A92-B1D2-AA6239C0D261, dan pasang file tersebut ke direktori /sys/class/dmi/id/product_uuid di kontainer LoongCollector (Logtail).

Bagaimana cara mengumpulkan file log atau output standar kontainer yang sama dengan beberapa konfigurasi pengumpulan?

Secara default, untuk mencegah data duplikat, Simple Log Service hanya mengizinkan setiap sumber log dikumpulkan oleh satu konfigurasi pengumpulan:

• File log teks hanya dapat dicocokkan oleh satu konfigurasi pengumpulan Logtail.

• Output standar kontainer (stdout):

• Jika Anda menggunakan templat output standar baru, output standar hanya dapat dikumpulkan oleh satu konfigurasi pengumpulan output standar secara default.

• Jika Anda menggunakan templat output standar lama, pengumpulan oleh beberapa konfigurasi didukung secara default dan tidak memerlukan konfigurasi tambahan.

  Untuk mengizinkan sumber log yang sama dikumpulkan oleh beberapa konfigurasi pengumpulan, lakukan langkah-langkah berikut:

1. Masuk ke Konsol Simple Log Service dan buka proyek tujuan.

2. Di panel navigasi kiri, pilih LogStores dan temukan LogStore tujuan.

3. Klik ikon di samping namanya untuk memperluas LogStore.

4. Klik Logtail Configuration, temukan konfigurasi Logtail tujuan di daftar konfigurasi, dan klik Manage Logtail Configuration di kolom Actions.

5. Di halaman konfigurasi Logtail, klik Edit dan gulir ke bawah ke bagian Input Configurations: - Untuk mengumpulkan log file teks: Nyalakan Allow File to Be Collected for Multiple Times. - Untuk mengumpulkan output standar kontainer: Nyalakan Allow Collection by Different Logtail Configurations.

Bagaimana cara mengelola konfigurasi distribusi multi-target?

Karena konfigurasi distribusi multi-target dikaitkan dengan beberapa LogStore, Anda harus memelihara jenis konfigurasi ini di halaman manajemen tingkat proyek:

1. Masuk ke Konsol Simple Log Service dan klik nama proyek tujuan.

2. Di halaman proyek tujuan, di panel navigasi kiri, klik Resource Group > Configurations.

   Halaman ini mengelola secara terpusat semua konfigurasi pengumpulan dalam proyek, termasuk konfigurasi yang tersisa setelah LogStore dihapus secara tidak sengaja.

Penguraian ekspresi reguler

Mengekstraksi field log dengan ekspresi reguler dan mengurai log menjadi pasangan kunci-nilai sehingga setiap field dapat dikueri dan dianalisis secara independen.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Data Parsing (Regex Mode):

• Regular Expression: Ekspresi yang digunakan untuk mencocokkan log. Anda dapat menghasilkannya secara otomatis atau memasukkannya secara manual:

• Generasi otomatis:

  1. Klik Automatically Generate Regular Expression.

  2. Di bagian Log Sample, sorot konten log yang ingin Anda ekstraksi.

  3. Klik Generate Regular Expression.

     Konfirmasi bahwa konten log dalam format yang benar ditempelkan di bagian Log Sample, seperti log akses Apache Combined, lalu klik Generate Regular Expression di bagian tersebut untuk menghasilkan ekspresi penguraian secara otomatis. - Input manual: Manually enter a regular expression berdasarkan format log.

  Setelah menyelesaikan konfigurasi, klik Validate untuk menguji apakah ekspresi reguler mengurai konten log dengan benar. - Extracted Field: Tetapkan nama field (Key) untuk setiap bagian konten log yang diekstraksi (Value). - Untuk informasi tentang parameter lainnya, lihat parameter konfigurasi umum yang dijelaskan di Skenario 2: Strukturisasi log.

Penguraian delimiter

Menstrukturisasi konten log dengan delimiter dan mengurai-nya menjadi beberapa pasangan kunci-nilai. Delimiter karakter tunggal dan multi-karakter didukung.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Data Parsing (Delimiter Mode):

• Delimiter: Tentukan karakter yang digunakan untuk memisahkan konten log. Contoh: Untuk file CSV, pilih Custom dan masukkan koma (,).

• Quote: Jika nilai field berisi delimiter, tentukan karakter quote untuk membungkus field dan mencegah pemisahan yang salah.

• Extracted Field: Tetapkan nama field (Key) untuk setiap kolom sesuai urutan pemisahannya. Aturan berikut berlaku:

• Nama field hanya boleh berisi huruf, angka, dan garis bawah (_).

• Nama field harus dimulai dengan huruf atau garis bawah (_).

• Panjang maksimum: 128 byte.

• Untuk informasi tentang parameter lainnya, lihat parameter konfigurasi umum yang dijelaskan di Skenario 2: Strukturisasi log.

Penguraian JSON standar

Menstrukturisasi log JSON bertipe Object dan mengurai-nya menjadi pasangan kunci-nilai.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Data Parsing (JSON Mode):

• Original Field: Nilai default: content. Field ini menyimpan konten log mentah yang akan diurai.

• Untuk informasi tentang parameter lainnya, lihat parameter konfigurasi umum yang dijelaskan di Skenario 2: Strukturisasi log.

Penguraian JSON bersarang

Mengurai log JSON bersarang menjadi pasangan kunci-nilai dengan menentukan kedalaman ekspansi.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Extended Processor > Expand JSON Field:

• Original Field: Nama field asli yang akan diekspansi, seperti content.

• JSON Expansion Depth: Tingkat ekspansi objek JSON. Nilai 0 menunjukkan ekspansi penuh (nilai default), nilai 1 menunjukkan tingkat saat ini, dan seterusnya.

• Character to Concatenate Expanded Keys: Karakter yang digunakan untuk menggabungkan nama field selama ekspansi JSON. Nilai default: garis bawah (_).

• Name Prefix of Expanded Keys: Awalan nama field setelah ekspansi JSON.

• Expand Array: Nyalakan opsi ini untuk mengekspansi array menjadi pasangan kunci-nilai dengan indeks. Contoh: {"k":["a","b"]} diekspansi menjadi {"k[0]":"a","k[1]":"b"}.

  Untuk mengganti nama field yang diekspansi, misalnya mengubah prefix_s_key_k1 menjadi new_field_name, tambahkan plugin Rename Fields setelahnya untuk menyelesaikan pemetaan.

• Untuk informasi tentang parameter lainnya, lihat parameter konfigurasi umum yang dijelaskan di Skenario 2: Strukturisasi log.

Penguraian array JSON

Gunakan fungsi json_extractfunction untuk mengekstraksi objek JSON dari array JSON.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, ubah Processing Method ke SPL, konfigurasikan pernyataan SPL, dan gunakan fungsi json_extract untuk mengekstraksi objek JSON dari array JSON.

Contoh: Ekstraksi elemen array JSON dari field log content dan simpan hasilnya di field baru json1 dan json2.

* | extend json1 = json_extract(content, '$[0]'), json2 = json_extract(content, '$[1]')

Penguraian log Apache

Menstrukturisasi konten log berdasarkan definisi dalam file konfigurasi log Apache dan mengurai-nya menjadi beberapa pasangan kunci-nilai.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Data Parsing (Apache Mode):

• Log Format: combined

• APACHE LogFormat Configuration: Simple Log Service secara otomatis mengisi pengaturan ini berdasarkan Log Format. Periksa konten yang diisi secara otomatis untuk memastikan bahwa kontennya identik dengan LogFormat yang didefinisikan dalam file konfigurasi Apache di server Anda, yang biasanya terletak di /etc/apache2/apache2.conf.

• Untuk informasi tentang parameter lainnya, lihat parameter konfigurasi umum yang dijelaskan di Skenario 2: Strukturisasi log.

Penyamaran data

Menyamarkan data sensitif dalam log.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Data Masking:

• Original Field: Field asli yang menyimpan konten log sebelum penguraian.

• Data Masking Method:

  • const: Mengganti konten sensitif dengan string yang ditentukan.

  • md5: Mengganti konten sensitif dengan nilai MD5-nya.

• Replacement String: Jika Anda mengatur Data Masking Method ke const, masukkan string yang digunakan untuk mengganti konten sensitif.

• Content Expression that Precedes Replaced Content: Menemukan konten sensitif. Konfigurasikan dengan sintaks RE2.

• Content Expression to Match Replaced Content: Ekspresi konten sensitif. Konfigurasikan dengan sintaks RE2.

Penguraian waktu

Mengurai field waktu dalam log dan mengatur hasil penguraian sebagai field __time__ log.

Contoh:

Prosedur: Pada halaman Logtail Configuration, di bagian Processor Configurations, klik Add Processor dan pilih Native Processor > Time Parsing:

• Original Field: Field asli yang menyimpan konten log sebelum penguraian.

• Time Format: Atur format waktu yang cocok berdasarkan konten waktu dalam log.

• Time Zone: Pilih zona waktu field waktu dalam log. Zona waktu mesin digunakan secara default, yaitu zona waktu lingkungan tempat proses LoongCollector (Logtail) berjalan.

Keunggulan utama output standar baru

• Kinerja yang jauh lebih baik

• Direkayasa ulang dalam C++, versi baru memberikan peningkatan kinerja 180% hingga 300% dibandingkan implementasi Go sebelumnya.

• Mendukung pemrosesan data dengan plugin native dan pemrosesan paralel multi-threading, yang sepenuhnya memanfaatkan resource sistem.

• Mendukung kombinasi fleksibel plugin native dan plugin Go untuk memenuhi kebutuhan skenario kompleks.

• Keandalan yang lebih kuat

• Mendukung antrian rotasi untuk log output standar dan menyatukan mekanisme pengumpulan log dengan mekanisme pengumpulan file, yang memberikan keandalan tinggi saat log output standar berotasi dengan cepat.

• Konsumsi resource yang lebih rendah

• Penggunaan CPU berkurang 20% hingga 25%.

• Penggunaan memori berkurang 20% hingga 25%.

• Konsistensi O&M yang ditingkatkan

• Konfigurasi parameter terpadu: Parameter konfigurasi plugin pengumpulan output standar baru konsisten dengan plugin pengumpulan file.

• Manajemen metadata terpadu: Penamaan field metadata kontainer dan lokasi penyimpanan tag disatukan dengan skenario pengumpulan file kontainer, sehingga sisi konsumen hanya memelihara satu set logika pemrosesan.

Perbandingan fitur versi baru dan lama

Pemetaan field metadata kontainer

Dalam versi baru, semua field metadata disimpan di bagian tag log dalam format __tag__:<key> alih-alih disematkan dalam konten log.

Dampak versi baru terhadap pengguna

• Adaptasi sisi konsumen: Karena lokasi penyimpanan berubah dari konten ke tag, Anda harus menyesuaikan logika konsumsi log Anda. Misalnya, Anda harus mengakses field melalui __tag__ saat menjalankan kueri.

• Kompatibilitas SQL: SQL kueri sudah secara otomatis kompatibel dengan kedua versi, sehingga Anda tidak perlu memodifikasi pernyataan kueri Anda untuk memproses log dari versi mana pun.