Simple Log Service：Kelola tag koleksi LoongCollector

Batasan

• Fitur ini hanya didukung di LoongCollector versi 3.0.10 dan lebih baru. Jika Anda menggunakan Logtail atau versi LoongCollector yang lebih lama, tingkatkan ke versi terbaru LoongCollector.

• Fitur ini memodifikasi nama dan lokasi penyimpanan tag. Jika proses konsumsi log Anda bergantung pada bidang tag yang dimodifikasi, mungkin terjadi masalah kompatibilitas.

Klasifikasi Tag

Bidang tag mirip dengan indeks bidang dan berisi kunci serta nilai. Sebagai contoh, dalam __tag__:__inode__:263554, __tag__:__inode__ adalah nama tag (kunci), dan 263554 adalah nilai tag.

Tag diklasifikasikan menjadi dua jenis utama berdasarkan sumbernya:

• Terkait Agen: Tag ini terkait dengan agen pengumpulan itu sendiri dan tidak bergantung pada plugin. Contohnya termasuk alamat IP dan hostname.

• Terkait Plugin Input: Tag ini bergantung pada plugin input. Plugin menyediakan dan memperkaya log dengan informasi relevan, seperti inode file, offset baca, nama pod, namespace, dan nama citra.

Penagihan

Bidang tag tidak dikenakan biaya. Namun, biaya akan dikenakan jika Anda mengaturnya sebagai bidang indeks. Untuk informasi lebih lanjut tentang standar penagihan, lihat Penagihan. Untuk informasi lebih lanjut tentang cara mengatur dan menghapus indeks bidang, lihat Buat Indeks.

Buat atau modifikasi nama tag

LoongCollector menstandarisasi tag dan menyediakan fitur pemrosesan tag. Anda dapat mengonfigurasi parameter lanjutan untuk menambah, menghapus, dan mengganti nama tag.

Hapus tag

Untuk menghapus tag, atur nilainya menjadi string kosong dalam konfigurasi parameter lanjutan.

Dalam contoh berikut, nilai AGENT_TAG disetel menjadi string kosong, sehingga tag tidak ditampilkan. Untuk informasi lebih lanjut, lihat Buat atau Modifikasi Nama Tag.

{
  "PipelineMetaTagKey": {
    "HOST_NAME": "sourceName",
    "AGENT_TAG": "",
    "HOST_ID": "__default__",
    "CLOUD_PROVIDER": "__default__"
  }
}

Lihat tag

1. Di bagian Proyek, klik yang Anda inginkan.

   

2. Di sebelah kanan Logstore target, klik ikon dan pilih Query & Analysis untuk melihat log dari Logstore saat ini.

   

3. Seperti yang ditunjukkan pada gambar berikut, bidang tag ditampilkan di baris teratas halaman log.

   

   • Tag Terkait Agen

     • __tag__:sourceName: Kunci tag disetel ke PipelineMetaTagKey.HOST_NAME. Nilai defaultnya adalah __tag__:__hostname__. Dalam contoh ini, nilainya disetel ke __tag__:sourceName, yang mewakili nama host sumber.

     • __tag__:__host_id__: Kunci tag disetel ke PipelineMetaTagKey.HOST_ID. Nilai default __host_id__ digunakan untuk parameter ini.

     • __tag__:__cloud_provider__: Kunci tag disetel ke PipelineMetaTagKey.CLOUD_PROVIDER. Nilai default __cloud_provider__ digunakan untuk parameter ini.

     • __tag__:__user_defined_id__: Kunci tag disetel ke AGENT_TAG. Parameter ini hanya berlaku untuk kelompok mesin dengan pengenal kustom dan tidak berlaku untuk kelompok mesin dengan alamat IP.

   • Tag Terkait Plugin Input

     • __tag__:__inode__: Kunci tag disetel ke Tags.FileInodeTagKey. Nilai default __inode__ digunakan untuk parameter ini.

     • __tag__:__path__: Kunci tag disetel ke Tags.FilePathTagKey. Nilai default __path__ digunakan untuk parameter ini.

     • __file_offset__: Kunci tag disetel ke FileOffsetKey. Nilai default __file_offset__ digunakan untuk parameter ini.

       Penting

       • Jika Anda mengatur FileOffsetKey dalam konfigurasi input, fitur Auto Generate Index dari konfigurasi koleksi mengatur bidang tag ini (__file_offset__) sebagai bidang indeks. Untuk informasi lebih lanjut tentang penagihan, lihat Penagihan. Jika Anda tidak perlu membuat indeks untuk bidang ini, Anda dapat menghapus indeks tetapi tetap menyimpan bidang tag. Untuk informasi lebih lanjut, lihat Perbarui Indeks.

       • Tag ini tidak ditampilkan di bagian atas halaman analisis kueri. Ini memiliki properti dan fitur unik, dan namanya adalah __file_offset__. Gambar berikut menunjukkan contohnya:

         

Modifikasi nilai tag

Anda dapat menggunakan plugin pemrosesan Bahasa Proses Terstruktur (SPL) untuk mengelola bidangtag dan memodifikasi nilai tag. Saat menggunakan SPL untuk memproses bidang tag, ikuti aturan berikut:

1. SPL menggunakan awalan __tag__: untuk mengidentifikasi tag dan secara otomatis menambahkan awalan ini ke semua bidang tag selama pemrosesan. Oleh karena itu, saat Anda menulis pernyataan SPL, pastikan nama bidang mencakup awalan ini untuk merujuk dengan benar pada data terkait tag.

2. Dalam output SPL, semua bidang dengan awalan tag diidentifikasi sebagai tag. Anda dapat menggunakan metode ini untuk menambahkan tag.

Topik ini menjelaskan cara menambahkan pernyataan SPL saat Anda memodifikasi konfigurasi koleksi, menggunakan __tag__:sourceName sebagai contoh. Untuk mempermudah kueri log, Anda dapat mengubah nilainya menjadi user_module dalam konfigurasi pengumpulan log untuk membedakan log yang berbeda berdasarkan nama aplikasi. Untuk informasi lebih lanjut tentang cara menambahkan pernyataan SPL saat Anda membuat konfigurasi koleksi, lihat Tambahkan Pernyataan SPL Saat Membuat Konfigurasi Koleksi.

1. Di bagian Proyek, klik yang Anda inginkan.

   

2. Pada tab Log Storage > Logstores, klik ikon > di sebelah logstore yang Anda inginkan, lalu pilih Data Collection > Logtail Configurations.

   

3. Dalam daftar Logtail Configuration, temukan konfigurasi Logtail yang diperlukan dan klik Manage Logtail Configuration di kolom Actions.

4. Klik Edit di bagian atas halaman. Di bagian Processing Configuration di bagian bawah halaman, atur Processing Mode dalam Processing Configuration ke SPL, lalu klik Save.

   Atur pernyataan SPL menjadi berikut: * | extend "__tag__:sourceName"='user_module'

5. Di sebelah kanan Logstore target, klik ikon dan pilih Query & Analysis untuk melihat log dari Logstore saat ini.

   Nilai dari bidang __tag__:sourceName adalah user_module.

   

Referensi

Anda dapat mengatur bidang indeks normal sebagai bidang tag. Bidang tag dapat ditampilkan atau disembunyikan. Untuk informasi lebih lanjut, lihat Bidang Tag.