MID サーバーコンシューマー向けのガイド付きセットアップ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：11分

    • MID サーバーコンシューマー向けの完全なガイド付きセットアップを行うには、次の手順を実行します。

    始める前に

    移動先 ログエクスポートサービス (LES) > MID サーバーコンシューマー > ガイド付きセットアップ. 構成するセットアップのタイプを選択し、[ 続行] を選択します。
    注:
    ログエクスポートサービスアプリケーションのインストール中、ServiceNow は、基盤となる Hermes メッセージングサービスインフラストラクチャをプロビジョニングします。このプロセスは、ログエクスポートサービスアプリケーションのインストールを要求してから最大で 2 時間程度かかることがあることに注意してください。

    必要なロール：admin

    手順

    1. Hermes メッセージングサービス診断をレビューします。

      このステップで画面に表示される Hermes 診断ツールを使用して、Hermes メッセージングサービスが稼働していることを確認することをお勧めします。このページに「ページが見つかりません」というエラーが表示された場合、Hermes はインストールされていません。システムアドミンに連絡してください。

      • セットアップ情報：次のブートストラップ情報は、Hermes Messaging Service への接続に使用されます。「プロデューサーブートストラップ」は、Hermes にメッセージを送信するために使用される接続であり、「コンシューマーブートストラップ 1 および 2」は、Hermes からメッセージを取得するために使用されます。
        • プロデューサーブートストラップ
        • コンシューマーブートストラップ 1
        • コンシューマーブートストラップ 2
      • インスタンス PKI：インスタンス公開鍵インフラストラクチャ (PKI) コンポーネントにより、ServiceNow インスタンスは、X.509 信頼階層内で発行者として機能します。
      • ブートストラップ接続:[ テストを実行 ] を選択して、外部クライアントが定義されたインスタンスポート (プロデューサーとコンシューマー) に接続できることを確認します。
      • インスタンス接続:[ テストを実行 ] を選択して、インスタンスがメッセージを送受信できることを確認します。
      • トピックを表示:リストされたトピックを選択して、最後の既知のメッセージのタイムスタンプを取得します。
      注:
      今後、 Hermes 診断にアクセスして、潜在的な接続の問題をトラブルシューティングするには、ガイド付きセットアップのこのステップに戻るか、 すべて > Hermes メッセージングサービス > 診断.
    2. Hermes Messaging Service への安全な接続のための証明書を生成し、そこからログイベントをプルします。

      Hermes Messaging Service (メッセージングサービス) への安全な接続をセットアップします。詳細については、「 LES 用 Hermes Messaging Service への安全な接続を設定する」 を参照してください。これらの証明書は、Hermes からログをプルするクライアントでの認証と承認に必要となります。

      注:
      この手順には、admin ロールまたは Hermes_admin ロールが必要です。
    3. ログプロデューサーの構成：エクスポートするログソースを選択し、フィルターを構成します。
      ログプロデューサーを構成するには、次のタスクを完了します。
      • エクスポートするログソースの構成：エクスポートするログソースごとに 1 つのソースレコードを作成します。
        注:
        この手順を完了するには、admin ロールまたは sn_logstoanalytics.admin ロールが必要です。

        新しいソースを作成するには、次に移動します: ログエクスポートサービス > ソース

        1. 右上隅にある [新規 ] を選択します
        2. ソースタイプを選択します
        3. Select a Table
        4. ログ出力の制御に使用できるログレベルを選択します
        5. ログソースのエクスポート先のトピックを選択または作成します。新しいトピックを作成する場合は、次のフィールドに入力します。
          • 名前:作成しているトピックの名前
          • アプリケーション ID:sn_logstoanalyticsを入力します
          • 名前空間:デフォルトの名前空間を入力します
          • パーティション:Hermes のトピックのパーティションフィールドは、トピックのデータが分割されるパーティションを参照します。スケーラビリティと並列処理において重要な役割を果たします。
        6. ログを選択的に転送するには、[ フィルタータイプ ] 条件を選択します。
          注:
          [フィルタータイプ] オプションは、選択したソースタイプによって異なります。
        7. [Update (更新)] を選択します
        正常に作成されると、ログソースのエクスポート先になる Hermes トピックの名前が表示されます。トピック名を書き留めてください。後でログコンシューマーシステムを構成するときに必要になります。

        [アクティブ] フィールドは、ログソースをエクスポートするかどうかを制御します。エラーが表示された場合は、「Hermes 診断の確認」タスクに戻り、Hermes ステータスを確認します。

      • ログプロデューサーの検証:ログの生成元となるソースを作成したら、次を使用してトピック内のライブログレコードを表示できます。 Hermes メッセージングサービス > Hermes トピックインスペクター.
        1. 外部トピックの選択
        2. リストトピックを選択
        3. 前のステップからトピックの行を選択 ([Sources (ソース)] にリストされているもの)
        4. 必要に応じてメッセージの開始日を調整
        5. [ 表示 ] を選択して、トピックにエクスポートされたログメッセージを表示します
    4. MID サーバーのインストール：Vancouver 以降を実行する専用の MID サーバーをインストールして構成する必要があります。
      MID サーバーをインストールするには、次のタスクを完了します。
      • 専用の MID サーバーのインストール：ログエクスポートサービスが使用する MID サーバーは、この目的専用で、他のプロセスの実行を期待されないようにする必要があります。これは、エクスポートされたログメッセージを REST エンドポイントにタイムリーに配信するうえで重要です。新しい MID サーバーをインストールするには、Use MID Server guided setup を使用するか、手動でインストールします。手動インストールの場合は、最初に Configure MID Server network connectivity ドキュメントに従い、その後で Installing the MID Server ドキュメントに従います。
      • MID サーバーの検証：MID サーバーがインストールされた後は、手動で MID サーバーを検証して、自動化タスクを実行できるようにする必要があります。LES 専用の MID サーバーを検証するには、「Validate the MID Server」を参照してください。
    5. ログ REST プッシュ先の構成：ログアナリティクスシステム (Splunk など) にログをプッシュできるように MID サーバーをセットアップします。
      ログ REST プッシュ先を構成するには、次のタスクを完了します。
      • MID プロパティの追加：Hermes に接続できるように、MID サーバープロパティを追加する必要があります。 [MID サーバー] > [プロパティ] に移動し、以下にリストされている各プロパティの適切な値を設定します。
        名前 値
        mid.les.kafka.ssl.truststore.password <パスワード>
        mid.les.kafka.ssl.keystore.password <パスワード>
        mid.les.kafka.ssl.key.password <パスワード>
        mid.les.kafka.ssl.truststore.location <パス>/<トラストストア>.p12
        mid.les.kafka.ssl.keystore.location <パス>/<キーストア>.p12
        mid.les.kafka.ssl.truststore.type PKCS12
        mid.les.kafka.ssl.keystore.type PKCS12
        mid.les.kafka.client.id <インスタンス名>
        mid.les.kafka.group.id snc.<インスタンス名>.group1
        mid.les.kafka.bootstrap.servers <instance_name>.servicenow.com:4100,<instance_name>.servicenow.com:4101,<instance_name>.servicenow.com:4102,<instance_name>.servicenow.com:4103
        mid.les.kafka.set2.bootstrap.servers <instance_name>.servicenow.com:4200,<instance_name>.servicenow.com:4201,<instance_name>.servicenow.com:4202,<instance_name>.servicenow.com:4203
        上記の値の一部を取得する方法については、次の注意事項に従ってください。
        • <パスワード> はキーストアとトラストストアに設定したパスワードです。
        • <パス> は、ダウンロードしたキーストアファイルとトラストストアファイルを保持するディレクトリへのファイルパスです。証明書は MID を実行しているサーバー上にある必要があります。
        • <インスタンス名> は ServiceNow インスタンスの名前です不明な場合は、sys_properties テーブルで見つけることができます。
        • Hermes の診断ページから mid.les.kafka.bootstrap.servers と mid.les.kafka.set2.bootstrap.servers の両方の値を取得できます。移動先 Hermes メッセージングサービス > 診断 をクリックし、[コンシューマーブートストラップ 1] と [コンシューマーブートストラップ 2] の下の文字列をそれぞれコピーします。
      • 宛先の構成：新しい宛先設定レコードを作成します。これは、この拡張機能がログを転送する REST エンドポイントを定義します。
        注:
        この手順を完了するには、admin ロールまたは sn_logstoanalytics.admin ロールが必要です。
        1. 移動先 ログエクスポートサービス (LES) > 宛先の構成 
        2. 新しい設定レコードを作成します。
        3. エクスポートされたログソースの目的のエンドポイントの URL を指定します。
        4. エンドポイントに接続するための新しい認証情報を検索または作成します。エンドポイントの認証情報を作成するときは、LES では、Basic Auth、OAuth、API キーの認証情報タイプのみが有効であることに注意してください。
        5. 変換スクリプトを検索するか新規に作成します。事前に作成されたスクリプト、Splunk 用の SplunkTransform が付属しています。
    6. ログコンシューマーの構成：次のタスクに従って、ログエクスポートサービスを目的とした MID サーバー拡張機能を構成します。
      • LES コンシューマーコンテキストの構成：この手順では、ログエクスポートサービス用にインストールした専用の MID サーバー上で実行されるように LES コンシューマーレコードを更新します。移動先 MID サーバー > 拡張 > LES コンシューマーコンテキスト をクリックし、次のフィールドを設定して LES コンシューマーレコードを更新します。
        • [LES コンシューマー] を選択して、MID サーバーコンテキストレコードを開きます
        • [Execute on (実行)] フィールドで特定の MID Server (MID サーバー) を選択します
        • [MID Server (MID サーバー)] フィールドに、前の手順で検証した MID の名前を入力します
        [更新] を選択して保存します。
        注:
        事前にビルドされたコンテキストが付属しています。2 つ目のコンテキストは作成しないでください。これにより、意図しない結果が生じる可能性があります。
      • コンシューマーの構成：ログエクスポートサービス MID サーバー拡張機能の一部であるプロセスを表す新しいコンシューマーレコードを作成します。移動先 ログエクスポートサービス (LES) > コンシューマー をクリックし、ログメッセージを取得する Hermes トピックとログメッセージのリレー先を指定する新しい設定レコードを作成します。[コンシューマー] モジュールを選択すると、コンシューマー名と宛先構成に関する情報が表示されます。
        1. 新しいコンシューマーレコードを作成します
        2. ドロップダウンからソーストピックを選択します
        3. 宛先構成を選択します
        4. コンシューマーを起動します
      • MID サーバーの統合の確認:移動先 ログエクスポートサービス (LES) > コンシューマーステータス をクリックし、定義されたレコードの [ステータス] フィールドと [ステータスの詳細] フィールドを表示します。これらのフィールドの情報は、REST エンドポイントへのメッセージの中継中に発生した可能性のあるエラーを含め、MID サーバーで実行されているプロセスの現在の状況を報告します。これはステータスビューページのみです。移動先 ログエクスポートサービス (LES) > コンシューマー 新しいコンシューマーレコードを作成する場合。 コンシューマーステータスがプロセスが開始されたことを示している場合は、エンドポイントを調べて、エンドポイントに中継されたログを表示できるはずです。さらに、MID サーバーのログを表示して、発生した可能性のあるエラーに関する追加の詳細があるかどうかを確認できます。必要に応じて、MID サーバーのデバッグログを有効にして追加情報を取得することもできます。
        注:
        コンシューマーレコードの 1 つに変更を加えると、その変更は [コンシューマーステータス] ビューページに表示されます。[コンシューマーステータス] リストでコンシューマーレコード名を選択すると、選択したレコードのコンシューマーフォームが開きます。その後、選択したレコードの [名前] と [宛先構成 (Destination Configuration)] を更新できます。