Cara menggunakan plugin processor_appender untuk menambahkan nilai tertentu ke bidang yang ditentukan - Simple Log Service

Plugin processor_appender menambahkan nilai tertentu ke bidang yang sudah ada atau baru dan mendukung variabel templat dalam nilai tersebut. Plugin ini umumnya digunakan bersama plugin pemantauan deret waktu seperti input_prometheus dan input_system_v2 untuk memperkaya data yang diambil dari Prometheus.

Penting

Logtail versi 0.16.66 dan yang lebih baru mendukung plugin processor_appender.

Parameter

Atur type ke processor_appender. Tabel berikut menjelaskan parameter dalam bidang detail.

Tabel 1. Parameter Plugin

Parameter	Type	Wajib	Deskripsi
Key	string	Ya	Nama bidang.
Value	string	Ya	Nilai yang akan ditambahkan. Variabel templat didukung. Untuk informasi selengkapnya, lihat Variabel templat.
SortLabels	boolean	Tidak	Menentukan apakah label harus diurutkan secara alfabetis ketika Key diatur ke __labels__. Atur parameter ini ke true untuk mencegah error kueri yang disebabkan oleh label yang tidak terurut. Nilai default: false.

Tabel 2. Variabel Template

Variabel templat	Deskripsi	Contoh konfigurasi	Contoh hasil
{{__ip__}}	Alamat IP server tempat Logtail diinstal.	"Value": "{{__ip__}}"	"Value": "192.0.2.1"
{{__host__}}	Hostname server tempat Logtail diinstal.	"Value": "{{__host__}}"	"Value": "logtail-ds-xdfaf"
{{$xxxx}}	Nilai dari variabel lingkungan yang ditentukan. Nama variabel harus diawali dengan tanda dolar ($).	"Value": "{{$WORKING_GROUP}}"	"Value": "prod"

Contoh

Asumsikan server Logtail memiliki alamat IP 192.0.2.1, hostname david, dan variabel lingkungan WORKING_GROUP diatur ke prod. Konfigurasi berikut menambahkan data tersebut ke bidang __labels__:

Data mentah
```
"__labels__":"a#$#b"
```

Konfigurasi plugin Logtail

{
  "processors":[
    {
      "type":"processor_appender",
      "detail": {
        "Key": "__labels__",
        "Value": "|host#$#{{__host__}}|ip#$#{{__ip__}}|group#$#{{$WORKING_GROUP}}",
        "SortLabels": true
      }
    }
  ]
}

Hasil

"__labels__":"a#$#b|group#$#prod|host#$#david|ip#$#192.0.2.1"