「JSON の構文解析」フィールド・ルールを使用した JSON ストリングから JSON オブジェクトへの変換
IBM® Cloud Logsでは、 「JSON フィールドの解析」 ルールを使用して、エスケープされたログまたはストリング化されたログを JSON 形式に変換できます。
マッピング例外の原因となる宛先フィールドを選択した場合、ルールを適用すると、例外を作成していることを示すメッセージが表示されます。
開始前に
語句解析ルールは、 *「ルール・グループ」*内に編成されています。 各グループには、名前とルールのセットがあり、それらの間に論理関係があります。 ログは、ルール・グループの順序 (最初から最後まで) に従って処理されます。 その後、ルール・グループ内のルールの順序、およびルール・グループ間の論理演算子 (AND/OR) に従って処理されます。 ルールは、ログ・データを処理、解析、および再構成して、モニターおよび分析の準備をするのに役立ちます。 詳しくは、
ルール・グループの操作 を参照してください。
解析 JSON フィールド・ルールの構成
以下のステップを実行します。
-
「データ・パイプライン」 アイコン
> 「ルールの構文解析」 をクリックし、 「新規ルール・グループ」 をクリックします。
-
「詳細」 セクションで、 「ルール・グループ名」 および *「ルール・グループの説明」*を入力します。
-
「ルール・マッチャー」 セクションで、ルール・グループに含まれるルールを適用するログを定義するアプリケーション、サブシステム、および重大度を構成します。
-
「ルール」 セクションで、 「JSON フィールドの構文解析」
を選択します。
-
名前を入力します。
-
オプションで、説明を入力します。
-
「ソース・フィールド」 に、テキストに変換するフィールドを入力します。
-
宛先フィールドにマージするか、宛先フィールドを上書きするかを構成します。
-
元のフィールドとその内容を保持し、変更をマージする場合は、 「マージ先」 を選択します。
-
元のフィールドとその内容を上書きする場合は、 「上書き」 を選択します。
-
-
「宛先フィールド」 に、ソースの内容を保存するフィールドを入力します。
-
ソース・フィールドを保持するか削除するかを構成します。
-
元のフィールドとその内容を保持する場合は、 「保持」 を選択します。
-
元のフィールドとその内容を削除する場合は、 「削除」 を選択します。
-
ルールを有効にする場合は、状況を 「アクティブ」 に切り替えます。
-
-
さらにルール・グループを追加するには、 「ルールの追加」 をクリックし、目的のルール・タイプを選択します。 「AND/OR」 を切り替えて、追加ルールの処理方法を選択します。
-
ルールグループの作成 ]をクリックします。
例: エスケープ文字の削除と JSON への形式設定
この例では、ログをアンエスケープし、JSON 形式にします。