フィールドのカプセル化 - Simple Log Service - Alibaba Cloud ドキュメントセンター

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

制限事項

テキストログとコンテナーstdoutおよびstderrは、フォーム設定のみをサポートします。他のlogtailプラグインは、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に設定します。次に、次の表に基づいて他のパラメーターを詳細に設定します。

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

設定例

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

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

データ処理用のLogtailプラグイン設定

{
  "processors":[
    {
      "type":"processor_packjson" 、
      "detail": {
        "SourceKeys": ["a" 、"b"] 、
        "DestKey":"d_key" 、
        "KeepSource":true、
        "AlarmIfEmpty":true
      }
    }
  ]
}

結果

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