カスタムコネクタとの統合の有効化

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む8読むのに数分

    • カスタムコネクタコンソールで標準 Webhook を追加して、カスタムコネクタ イベント管理 を統合します。表示された URL 値をクリップボードにコピーし、それを使用してカスタムコネクタコンソールで Webhook を構成することで、カスタムコネクタを設定します。

    始める前に

    イベント管理コネクター (sn_em_connector) プラグインがインスタンスにインストールされNow Platformていることを確認します。

    カスタムコネクタで管理されるホストの構成アイテムが、Now Platform インスタンスに存在していることを確認します。これらの CI は物理的または仮想的なものである可能性があり、手動で作成されていることも、IP 検出や クラウドディスカバリー を介して検出されていることもあります。

    必要なロール：evt_mgmt_admin

    このタスクについて

    カスタムコネクタからのイベント収集用にイベント管理環境を構成するには、カスタムコネクタをデータソースとして認証します。カスタムコネクタコンソールで、標準 Webhook を使用してインスタンスを REST エンドポイントとして設定 Now Platform します。

    手順

    1. [統合を参照 (Browse Integrations)] タブで、[すべての統合 (All integrations)] ドロップダウンリストから [カスタム] を選択します。
    2. カスタムコネクタタイルを選択します。
    3. [詳細を入力 (Provide details)] ページでコネクタの詳細を入力します。
      1. [コネクタ名] フィールドで、そのコネクタタイプの一意のわかりやすい統合名を入力します。
      2. オプション: [説明] フィールドに、このコネクタタイプの識別に役立つ情報を入力します。
      3. オプション: [アサイン先グループ] ドロップダウンリストで、コネクタのアサイン先グループを含むアサイン先グループテーブルからレコードを選択します。
      4. [ソース] フィールドで、外部イベントソースからのイベントの収集に使用されるベンダーとプロトコルを入力します。

        この情報は、イベントを認識するための識別子として使用され、コネクタがアクティブになった後にイベントとアラートのソースを簡単に認識できるようにします。

    4. オプション: イベントに追加するタグを設定して、このタイプのコネクタをマーク および識別し、そのアラート を で Express List監視します。
      1. [タグ] フィールドの横にあるプラス記号を選択します。
      2. ポップアップメニューで、タグキーと値を入力します。
      3. [追加] を選択します。
    5. オプション: システムからロゴをドラッグまたはアップロードして、コネクタタイルに表示します。
      • 画像をボックスにドラッグします。
      • [画像のアップロード] を選択し、ファイル システムから画像を選択します。
      アップロードファイルの最大サイズは 1 MB です。
    6. イベントを ITOM インスタンスに直接接続するか、MID サーバーを介して接続するかを決定します。
      • ITOM インスタンスにイベントを送信するには、 [ITOM インスタンスに直接 (Directly to the ITOM instance)] を選択します。
      • イベントメッセージを処理してイベントをインスタンスに渡す MID サーバーを介してイベントを送信するには、[MID サーバー経由 (Via the MID server)] を選択します。

        MID サーバーが存在する場合は、イベントリスナーに接続されている利用可能な MID サーバーから選択します。MID サーバーを作成する必要がある場合は、MID Web サーバー拡張または MID Web サービスのイベントコレクターコンテキストを構成します。詳細については、「MID Web サーバー 拡張の設定」と「MID Web サービスイベントコレクターコンテキストの設定」を参照してください。

    7. [次へ] を選択します。
    8. イベントデータを収集する方法を選択します。
      イベントをストリーミングするライブシステムがある場合は、[ 実際のソースイベントを収集してフィールドを定義する] を選択します。サンプル JSON がある場合は、 [ JSON サンプルを使用してフィールドをマップする] を選択します。
      メソッド説明
      実際のソースイベントを収集してフィールドを定義 (Gather real source events to define fields)
      1. [実際のソースイベントを収集してフィールドを定義 (Gather real source events to define fields)] を選択し、複数のイベントを参照として使用してイベントとアラートの精度を向上させます 。
      2. [クリップボードにコピー] を選択して URL をコピーします。
      3. この URL を Webhook セットアップに貼り付け、サードパーティコネクタが ServiceNow インスタンスにイベントを送信できるようにする Webhook を作成します。サードパーティコネクタから実際のソースイベントを収集することで、複数のイベントを参照として使用してフィールドを定義して、イベントとアラートの精度を向上させます。
      4. [イベントのチェック (Check for events)] を選択します。JSON ファイルが作成されます。
      JSON サンプルを使用したフィールドのマッピング (Use a JSON sample to map fields)
      1. [JSON サンプルを使用したフィールドのマッピング (Use a JSON sample to map fields)] を選択します。
      2. [ペイロードを入力 (Enter payload)] ダイアログボックスで、JSON サンプルペイロードをコピーして貼り付け、フィールドをマップするマッピングを作成して表示します。
      3. [JSON をアップロード (Upload JSON)] を選択します。
      4. [新しい JSON を編集または貼り付け (Edit or paste new JSON)] を選択して、アップロードした JSON を編集するか、新しい JSON を貼り付けます。
    9. [次へ] を選択します。
    10. [フィールドのマッピング (Map Fields)] ページで、JSON コードサンプルのフィールドを ServiceNow フィールドにマッピングすると、システムは受信データでイベントを正しく作成できるようになります。
      1. カスタムコネクタの JSON ペイロードから取得した JSON コードサンプルをコピーして、[JSON コードサンプル元 custom_test (JSON code sample from custom_test)] 列に貼り付けます。
        [重大度] と [メッセージキー] 情報は自動的に入力されるため、手間を省くことができます。メッセージキーはイベントの正しい識別子を提供します。そのため、たとえば、重複排除が正しく機能し、冗長なアラートが表示されなくなります。
      2. コネクタフィールド名列に、[重大度] フィールドの ServiceNow 列にリストされている重大度の値にマップする値を少なくとも 1 つ入力します。

        JSON コードサンプルの重大度の値を入力できます。重大度の値を設定するには、サードパーティコネクタのペイロードと、コネクタがサポートする重大度のタイプについてよく理解している必要があります。受信したイベントの重大度の値は、システムで生成されたイベントに一致している必要があります。

    11. [次へ進んで保存] を選択します。
    12. [プッシュコネクタの設定 (Set-up push connector)] 画面で、[クリップボードにコピー] を選択して、自動生成された URL パラメーター値をクリップボードにコピーします。
    13. オプション: コネクタ列の [その他のフィールド (Other fields)] セクションで、必要でないサードパーティのイベントパラメーターを指定しますが、イベントに関する追加情報を指定します。
      オプションの情報を指定しないことを選択した場合は、フィールドを空のままにします。
      1. [説明] フィールドに、わかりやすいアラートの説明を入力します。
      2. [測定基準名] フィールドに、アラートをトリガーしたパフォーマンス測定基準または KPI にイベントを関連付けることができる測定基準の名前を入力します。
      3. [ノード] フィールドに、CI バインディングに使用するノード値を入力します。
      4. [イベント時間] フィールドに、サードパーティイベントの作成時間を入力します。
        イベント時間がマッピングされていない場合、システムはデフォルトのイベント時間を使用します。
      5. [イベント時間の設定 (Event time settings)] フィールドで、時間形式とイベントのタイムゾーンを選択します。
        • 時間形式：UTC または GMT 形式の GlideDateTime フィールドで、最大長は 40 文字です。
        • タイムゾーン：時間は協定世界時 (UTC) で保存され、システムのタイムゾーンに基づいてグローバルに表示されます。
    14. [次へ] を選択します。
    15. [コネクタの設定] 画面の [URL パラメーター値] フィールドで、[クリップボードにコピー] を選択して、自動生成された URL パラメーター値をクリップボードにコピーします。
    16. URL を Webhook 設定に貼り付け、基本認証資格情報を監視システムの Webhook 構成に入力します (ユーザー名やパスワードなど)。

      この Webhook を使用して、サードパーティコネクタは ServiceNow インスタンスにイベントを送信できます。

    17. [有効化] を選択してコネクタをアクティブ化し保存して、確認ポップアップウィンドウで [OK] を選択します。
      [詳細] タブでコネクタの詳細を表示し、[フィールドマッピング] タブでフィールドマッピングを表示できます。
    18. オプション: [関連イベント] タブを選択して関連イベントを表示することで、プロセスが正常に完了し、イベントがシステムに取り込まれていることを確認します。

    タスクの結果

    コネクタがアクティブ化されると、 カスタムコネクタコンソールからインスタンスに ServiceNow イベントが送られ始めます。このプラグインは、元のカスタム・コネクター・イベント・メッセージから情報を抽出し、必要なイベント・フィールドに値を入力して、イベントをデータベースに挿入します。インスタンス内の Now Platform イベントを表示するには、[All Events] に移動します。詳細については、「イベントの表示」を参照してください。

    次のタスク

    アラートの自動化を作成するには、 [ 自動化の追加] を選択します。詳細については、「」を参照してください。ソースとアサイン先グループは、アラート自動化に自動入力されます。