ナビゲーション全体を読み込み中です。

LogicMonitor では、Webhook LogSource により、外部プラットフォームがイベントベースのデータを直接 LogicMonitor にプッシュしてログを取り込むことができます。

LogSourcesの仕組みの詳細については、以下を参照してください。 LogSource 構成ガイド.

WebhookメッセージはJSON形式でフォーマットされます。LogSource設定により、以下のことが可能になります。

  • JSONペイロードからキーと値のマッピングを定義する
  • 正規表現(regex)を使用してログメッセージから動的な値を取得します
  • 正規表現グループを適用して、ログ フィールドまたはリソース マッピングの複数の値を抽出します。

Webhook LogSource 構成にフィルターを含める

アプリケーションなど、特定の種類のリソースを含めるためのフィルターを追加できます。フィルター条件に一致する出力は、ログ取り込みプロセスに転送されます。

次の表に、使用可能なパラメータの詳細を示します。

属性比較演算子値の例 詳細説明
ソース名等しい、等しくない、含む、含まない、正規表現に一致する、正規表現に一致しないMeraki+顧客Aログをフィルタリングする sourceName Webhookメッセージに含まれる値。複数のソースからのログを区別するのに役立ちます。
組織名等しい、等しくない、含む、含まない、正規表現に一致する、正規表現に一致しない、存在する、存在しない 顧客_XYZ_組織Webhookペイロード内の組織名属性でログをフィルタリングします。これにより、特定の事業部門からのログを分離できます。
メッセージ等しい、等しくない、含む、含まない、正規表現に一致する、正規表現に一致しない「認証に失敗しました」メッセージ フィールドの内容に基づいてログをフィルターし、特定のイベント タイプを含めたり除外したりすることができます。

Webhook LogSource 設定のログフィールド

ログフィールド(タグ)を設定することで、ログに追加のメタデータを送信できます。利用可能なパラメータは以下の表のとおりです。

方法主な例値の例 詳細説明
静的Customer顧客_XYZLogSource によって処理されるすべてのログに固定のキーと値のペアを添付し、一貫したメタデータのタグ付けを保証します。
動的 (正規表現)主催者ホスト=*メッセージフィールドに対して正規表現クエリを実行してメタデータを抽出します。ホスト名やサービス名などの値を取得するのに便利です。
動的グループ正規表現スキーム、ログイン(https*):\/\/([az]+)グループを使用して単一の正規表現から複数の値を抽出し、各グループは個別のキーにマッピングされます。この方法は、ネストされたJSONからログフィールドを取得する場合に特に便利です。標準のWebhook属性ではJSONフィールド名でフィールドを直接取得できますが、必要なデータがJSON配列内にネストされている場合は、動的グループ正規表現を使用して抽出する必要があります。
Webhook属性 ソース名Meraki+顧客名Webhookペイロードに含まれるJSONフィールドを直接マッピングします(例: sourceName)をログフィールドに追加します。Webhookのソースを区別するのに役立ちます。

Webhook LogSource構成のリソースマッピング

監視対象リソースに一致するようにログプロパティを設定します。利用可能なマッピングの詳細は次のとおりです。

方法主な例値の例 詳細説明
静的顧客ID1921固定キーと値のペアを適用することで、このLogSourceからのすべてのWebhookイベントを特定の監視対象リソースにマッピングします。既知のソースからのログにタグを付けるのに役立ちます。
動的 (正規表現)システム.サービス名service = *メッセージ フィールドに適用された正規表現を使用して、Webhook ペイロードからリソース識別子 (サービス名など) を抽出します。
動的グループ正規表現スキーム、ログイン(https*):\/\/([az]+)正規表現グループを使用して、Webhookペイロードから複数の値をキャプチャします。各グループは個別のリソースプロパティにマッピングされます。
Webhook属性自動エンドポイントシリアル番号deviceSerial (deviceSerial は Cisco Meraki の Webhook 属性です)Webhook ペイロードのプロパティ (デバイスのシリアル番号など) を LogicMonitor の監視対象リソースに直接マップします。

Webhook LogSource の設定要件

Webhook LogSource を構成するには、Webhook の HTTP ヘッダーに単一の Bearer Token または API Token を含める必要があります。
要件の詳細については、以下を参照してください。 Webhookイベントをログとして保存.

Webhook LogSource の設定

  1. LogicMonitorで、次の場所に移動します より多くのオプション その他 > モジュール.
  2. 選択 データソースを追加 追加.
  3. [追加] ウィンドウで、 ログソース。 「新しいログソースの追加」ウィンドウが表示されます。
  4. 基本情報 の インフォ このセクションで、必要な設定を構成します。
    詳細については、を参照してください。 LogSource の基本情報の設定. 
  5. 製品概要 の インフォ セクションで、「LM Logs: Webhook」を選択します。 タイプ ドロップダウンメニュー。
  6. 追加 アクセスグループ ログの閲覧、管理、操作を誰が行えるかを指定する。
    詳細については、を参照してください。 アクセスグループ.
    Webhook LogSource の設定
  7. フィールドの設定 フィルタ のセクションから無料でダウンロードできます。
    詳細については、を参照してください。 LogSource のフィルタの設定.
    フィルターモーダルを追加
  8. 定義する ログフィールド メタデータを添付します。
    ログ フィールドを追加するには、次の手順を実行します。
    1. 選択 フィールドを追加構成用の新しいログ フィールド行が開きます。
    2. ノーザンダイバー社の 方法 ドロップダウンで、ログ フィールドの定義方法を選択します。
      • 静的 – すべてのログに固定のキーと値のペアを添付します。
      • 動的(正規表現) – メッセージ フィールドに対して正規表現クエリを使用して、単一の動的な値を抽出します。
      • 動的グループ正規表現 – グループを使用して正規表現から複数の値をキャプチャし、各グループを個別のキーにマッピングします。
      • Webhook属性 – Webhook ペイロードから直接値をマップします。
        たとえば、次の Webhook ペイロードを考えてみましょう。
        
        {
          "eventId": "evt-12345",
          "severity": "critical",
          "timestamp": 1708179200,
          "device": {
            "name": "router-01",
            "ip": "10.0.0.15"
          },
          "tags": ["network", "core", "production"],
          "acknowledged": false
        }
        このペイロードから、以下のフィールドをメタデータとして添付できます。
        • 重症度
        • イベントID
        • デバイス(オブジェクト)
        • タグ(配列)
        • 承認済み(ブール値)
    3. に名前を入力します キー フィールド。キーは作成するメタデータフィールドの名前です。たとえば、 ClientIP
    4. 対応する値を 値 選択した方法に基づいて、フィールドに表示されます。
    5. 詳細を追加する コメント 追加のコンテキストが必要な場合、フィールドを入力します。
    6. 選択 Save 青い保存アイコン.
      ログフィールドモーダルの追加

      Webhook ログフィールドエントリ
  1. セットアップ リソースマッピング ログを監視対象デバイスに関連付けます。
    詳細については、を参照してください。 LogSource のリソース マッピングの設定.
    リソースマッピングモーダルを追加
  2. 選択 Save.

Webhook LogSourceが作成され、受信するWebhookイベントの処理に使用できるようになります。LogicMonitorは、ログが取り込まれる際に、設定されたフィルタ、ログフィールド、およびリソースマッピングを、一致するWebhookペイロードに適用します。

14日間フルアクセス LogicMonitor プラットフォーム