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 が labels に設定されている場合に、ラベルをアルファベット順にソートするかどうかを指定します。ソートされていないラベルによるクエリエラーを防ぐには、このパラメーターを true に設定します。デフォルト値: 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"