Simple Log Service:Mengelola tag pengumpulan LoongCollector

Limitations

• Fitur ini memerlukan LoongCollector versi 3.0.10 atau lebih baru. Jika Anda menggunakan Logtail atau versi LoongCollector yang lebih lama, lakukan upgrade ke versi terbaru.

• Jika proses konsumsi log Anda bergantung pada tag yang telah dimodifikasi, Anda mungkin mengalami masalah kompatibilitas.

Tag categories

Sebuah tag terdiri dari pasangan kunci-nilai, mirip dengan field index. Sebagai contoh, dalam __tag__:__inode__:263554, __tag__:__inode__ adalah kuncinya (nama tag) dan 263554 adalah nilainya.

Tag dibagi menjadi dua kategori berdasarkan sumbernya:

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

• Terkait input plugin: Ditambahkan oleh input plugin untuk memperkaya log dengan informasi kontekstual, seperti inode file, offset baca, nama pod, namespace, dan nama image.

Billing

Tag tidak dikenai biaya. Namun, jika Anda mengonfigurasi tag sebagai field index, biaya akan dikenakan. Untuk informasi lebih lanjut tentang penagihan, lihat Billing. Untuk informasi lebih lanjut tentang cara membuat dan menghapus field index, lihat Create an index.

Create or modify a tag name

LoongCollector menyediakan fitur pemrosesan tag. Anda dapat mengonfigurasi parameter advanced untuk menambahkan, menghapus, dan mengganti nama tag.

Delete a tag

Untuk menghapus tag, atur nilainya ke string kosong dalam konfigurasi parameter advanced.

Pada contoh berikut, nilai AGENT_TAG diatur ke string kosong untuk menghapus tag tersebut. Untuk informasi lebih lanjut, lihat Create or modify a tag name.

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

View tags

1. Di bagian Projects, klik proyek yang diinginkan.

   

2. Di sebelah kanan Logstore yang dituju, klik ikon lalu pilih Query and Analysis.

3. Bidang tag ditampilkan di baris paling atas halaman log.

   • Agent-related tags

     • __tag__:sourceName: Tag ini merepresentasikan hostname sumber. Nama bidangnya diatur ke sourceName menggunakan kunci PipelineMetaTagKey.HOST_NAME. Nilai default-nya adalah __hostname__.

     • __tag__:__host_id__: Kunci tag diatur ke PipelineMetaTagKey.HOST_ID. Nilai default __host_id__ digunakan.

     • __tag__:__cloud_provider__: Kunci tag diatur ke PipelineMetaTagKey.CLOUD_PROVIDER. Nilai default __cloud_provider__ digunakan.

     • __tag__:__user_defined_id__: Kunci tag diatur ke AGENT_TAG. Parameter ini hanya berlaku untuk machine group with custom identifiers dan tidak berlaku untuk machine group with IP addresses.

   • Input plugin-related tags

     • __tag__:__inode__: Kunci tag diatur ke Tags.FileInodeTagKey. Nilai default __inode__ digunakan.

     • __tag__:__path__: Kunci tag diatur ke Tags.FilePathTagKey. Nilai default __path__ digunakan.

     • __file_offset__: Kunci tag diatur ke FileOffsetKey. Nilai default __file_offset__ digunakan.

       Penting

       • Jika Anda mengatur FileOffsetKey dalam konfigurasi input, fitur Auto Generate Index secara otomatis membuat field index untuk tag ini (__file_offset__). Untuk informasi lebih lanjut tentang penagihan, lihat Billing. Jika Anda tidak memerlukan field index tersebut, Anda dapat menghapusnya tanpa menghapus tag-nya. Untuk informasi lebih lanjut, lihat Update an index.

       • Tag ini tidak ditampilkan di bagian atas halaman Search & Analysis. Tag ini memiliki properti dan fitur unik, dan namanya adalah __file_offset__.

         Di halaman Search & Analysis, bidang __file_offset__ muncul dalam daftar Displayed Fields di sebelah kiri dan di area detail log. Nilainya adalah offset baca file, misalnya 1465.

Modify a tag value

Anda dapat menggunakan plugin pemrosesan SPL untuk memodifikasi nilai tag. Saat menggunakan SPL untuk memproses tag, ikuti aturan berikut:

1. SPL menggunakan awalan __tag__: untuk mengidentifikasi tag. Awalan ini secara otomatis ditambahkan ke semua tag selama pemrosesan SPL, sehingga Anda harus menyertakannya dalam nama bidang saat menulis pernyataan SPL.

2. Dalam output SPL, setiap bidang dengan awalan __tag__: dianggap sebagai tag. Anda dapat menggunakan metode ini untuk membuat tag baru.

Bagian ini memberikan contoh menambahkan pernyataan SPL saat memodifikasi konfigurasi pengumpulan untuk mengubah nilai __tag__ :sourceName. Untuk menyederhanakan kueri log, Anda dapat mengubah nilainya menjadi user_module agar log dapat dibedakan berdasarkan nama aplikasi. Untuk informasi tentang cara menambahkan pernyataan SPL saat membuat konfigurasi pengumpulan, lihat Add an SPL statement when you create a collection configuration.

1. Di bagian Projects, klik proyek yang diinginkan.

   

2. Di tab Log Storage > Logstores, klik > di samping Logstore yang dituju, lalu pilih Data Collection > Logtail Configuration.

3. Di daftar Logtail Configuration, temukan konfigurasi yang dituju lalu klik Manage Logtail Configuration di kolom Actions.

4. Klik Edit di bagian atas halaman. Di area Processor Configurations di bagian bawah halaman, pada Processor Configurations, pilih SPL untuk Processing Method, lalu klik Save.

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

5. Di sebelah kanan Logstore yang dituju, klik ikon lalu pilih Query and Analysis.

   Nilai bidang __tag__:sourceName adalah user_module.

Related documents

Anda juga dapat mengonfigurasi bidang indeks standar sebagai tag. Bidang tag yang dihasilkan dapat ditampilkan atau disembunyikan. Untuk informasi lebih lanjut, lihat Tag fields.