processor_packjson プラグインを使用してフィールドをカプセル化する方法 - Simple Log Service

Logtail を使用してログを収集する場合、processor_packjson プラグインを使用して、1 つ以上のフィールドを JSON オブジェクト形式のフィールドにカプセル化できます。このトピックでは、processor_packjson プラグインのパラメーターについて説明し、プラグインを構成する方法の例を示します。

制限事項

テキストログとコンテナーの標準出力および標準エラー用の入力プラグインは、フォーム構成のみをサポートしています。その他の入力プラグインは、JSON でのエディター構成のみをサポートしています。

エントリポイント

Logtail プラグインを使用してログを処理する場合、Logtail 構成の作成時または変更時に Logtail プラグイン構成を追加できます。詳細については、「データ処理用の Logtail プラグインの概要」をご参照ください。

構成の説明

重要

Logtail V0.16.28 以降のみが processor_packjson プラグインをサポートしています。

フォーム構成

パラメーター

[プロセッサの種類] パラメーターを [フィールドをカプセル化] に設定します。次に、以下の表に基づいて他のパラメーターを構成します。

パラメーター	説明
[元のフィールド]	カプセル化する元のフィールド。
[新しいフィールド]	カプセル化後の新しいフィールド。
[元のフィールドを保持]	解析後に取得された新しいログに元のフィールドを保持するかどうかを指定します。
[元のフィールドがないエラーを報告]	生のログに元のフィールドが含まれていない場合にエラーを報告するかどうかを指定します。

例
次の例は、a フィールドと b フィールドを d_key JSON フィールドにカプセル化する方法を示しています。
- 生のログ
```
"a":"1"
"b":"2"
```
- データ処理用の Logtail プラグイン構成
- 処理結果
```
"a":"1"
"b":"2"
"d_key":"{\"a\":\"1\",\"b\":\"2\"}"
```

JSON でのエディター構成

パラメーター

type パラメーターを processor_packjson に設定します。次に、以下の表に基づいて detail セクションで他のパラメーターを構成します。

パラメーター	タイプ	必須	説明
SourceKeys	文字列配列	はい	カプセル化する元のフィールド。
DestKey	文字列	いいえ	カプセル化後の新しいフィールド。
KeepSource	ブール値	いいえ	解析後に取得された新しいログに元のフィールドを保持するかどうかを指定します。有効な値： true (デフォルト) false
AlarmIfIncomplete	ブール値	いいえ	生のログに元のフィールドが含まれていない場合にエラーを報告するかどうかを指定します。有効な値： true (デフォルト) false

例

次の例は、a フィールドと b フィールドを d_key JSON フィールドにカプセル化する方法を示しています。

生のログ
```
"a":"1"
"b":"2"
```

データ処理用の Logtail プラグイン構成

{
  "processors":[
    {
      "type":"processor_packjson", // タイプ：processor_packjson
      "detail": {
        "SourceKeys": ["a","b"], // ソースキー：["a","b"]
        "DestKey":"d_key", // デスティネーションキー："d_key"
        "KeepSource":true, // ソースを保持：true
        "AlarmIfEmpty":true // 空の場合にアラーム：true
      }
    }
  ]
}

処理結果

"a":"1"
"b":"2"
"d_key":"{\"a\":\"1\",\"b\":\"2\"}"