如何使用processor_appender外掛程式為指定的欄位追加特定的值 - Simple Log Service

您可以使用processor_appender外掛程式為指定的欄位（可以為不存在的欄位）追加特定的值，支援在欄位值中添加模板變數。該外掛程式通常與input_prometheus、input_system_v2等時序監控相關的外掛程式結合使用，用於給拉取到的Prometheus資料追加特定的值。

重要

Logtail 0.16.66及以上版本支援processor_appender外掛程式。

參數說明

配置type為processor_appender，detail說明如下表所示。

表 1. 外掛程式說明

參數	類型	是否必選	參數說明
Key	string	是	欄位名稱。
Value	string	是	添加的欄位值。Log Service支援在該欄位值中添加模板變數。更多資訊，請參見模板變數。
SortLabels	boolean	否	如果您要添加__labels__欄位，即配置Key為__labels__，則需要設定SortLabels為true，用於對Labels進行重新排序，避免因為Labels不遵循字母序而導致查詢異常。該值預設為false。

表 2. 模板變數

模板變數	說明	配置樣本	結果樣本
{{__ip__}}	替換為Logtail所在伺服器的IP地址。	"Value": "{{__ip__}}"	"Value": "192.0.2.1"
{{__host__}}	替換為Logtail所在伺服器的主機名稱。	"Value": "{{__host__}}"	"Value": "logtail-ds-xdfaf"
{{$xxxx}}	通過環境變數引用，需以貨幣符號（$）開頭。替換為環境變數的取值。	"Value": "{{$WORKING_GROUP}}"	"Value": "prod"

樣本

例如Logtail所在伺服器的IP地址為192.0.2.1，主機名稱為david，存在環境變數WORKING_GROUP的值為prod。如果您需要為__labels__欄位添加以上資料，可參見如下配置：

未經處理資料
```
"__labels__":"a#$#b"
```

Logtail外掛程式處理配置

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

處理結果

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