「JSON の構文解析」フィールド・ルールを使用した JSON ストリングから JSON オブジェクトへの変換

IBM® Cloud Logsでは、 「JSON フィールドの解析」 ルールを使用して、エスケープされたログまたはストリング化されたログを JSON 形式に変換できます。

マッピング例外の原因となる宛先フィールドを選択した場合、ルールを適用すると、例外を作成していることを示すメッセージが表示されます。

開始前に

語句解析ルールは、 *「ルール・グループ」*内に編成されています。 各グループには、名前とルールのセットがあり、それらの間に論理関係があります。 ログは、ルール・グループの順序 (最初から最後まで) に従って処理されます。 その後、ルール・グループ内のルールの順序、およびルール・グループ間の論理演算子 (AND/OR) に従って処理されます。 ルールは、ログ・データを処理、解析、および再構成して、モニターおよび分析の準備をするのに役立ちます。 詳しくは、 ルール・グループの操作 を参照してください。

解析 JSON フィールド・ルールの構成

以下のステップを実行します。

  1. 「データ・パイプライン」 アイコン 「データ・パイプライン」アイコン > 「ルールの構文解析」 をクリックし、 「新規ルール・グループ」 をクリックします。

  2. 「詳細」 セクションで、 「ルール・グループ名」 および *「ルール・グループの説明」*を入力します。

  3. 「ルール・マッチャー」 セクションで、ルール・グループに含まれるルールを適用するログを定義するアプリケーション、サブシステム、および重大度を構成します。

  4. 「ルール」 セクションで、 「JSON フィールドの構文解析」 「構文解析ルール」アイコン を選択します。

    1. 名前を入力します。

    2. オプションで、説明を入力します。

    3. 「ソース・フィールド」 に、テキストに変換するフィールドを入力します。

    4. 宛先フィールドにマージするか、宛先フィールドを上書きするかを構成します。

      • 元のフィールドとその内容を保持し、変更をマージする場合は、 「マージ先」 を選択します。

      • 元のフィールドとその内容を上書きする場合は、 「上書き」 を選択します。

    5. 「宛先フィールド」 に、ソースの内容を保存するフィールドを入力します。

    6. ソース・フィールドを保持するか削除するかを構成します。

      • 元のフィールドとその内容を保持する場合は、 「保持」 を選択します。

      • 元のフィールドとその内容を削除する場合は、 「削除」 を選択します。

    ルールを有効にする場合は、状況を 「アクティブ」 に切り替えます。

  5. さらにルール・グループを追加するには、 「ルールの追加」 をクリックし、目的のルール・タイプを選択します。 「AND/OR」 を切り替えて、追加ルールの処理方法を選択します。

  6. ルールグループの作成 ]をクリックします。

例: エスケープ文字の削除と JSON への形式設定

この例では、ログをアンエスケープし、JSON 形式にします。

元のログ。
「元のログ」

構文解析 JSON の例。
JSON の構文解析の例。

ログを変更しました。
「変更されたログ」