OpenTelemetry のサービスグラフコネクタ の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：13分

    • ServiceNow クラウドオブザーバビリティ (旧 Lightstep) から 構成管理データベース (CMDB) にデータをプルするようにスケジュール済みインポート済みジョブを設定します。

    始める前に

    重要:
    Australia リリース以降、OpenTelemetry のサービスグラフコネクタ は将来の廃止に備えて準備されます。これは非表示になり、新しいインスタンスにはインストールされなくなりますが、引き続きサポートされます。詳細については、Now Support ナレッジベース記事の「Deprecation Process (廃止プロセス) [KB0867184]」を参照してください。

    この サービスグラフコネクタを使用するには、IT Operations Management (ITOM) (ITOM) 可視化アプリケーションまたは ITOM ディスカバリーアプリケーションをベースにしたサブスクリプションユニットへのサブスクリプションが必要です。ご利用のサブスクリプションの「ServiceNow サブスクリプションユニットの概要」の「管理対象の IT リソースタイプ」というタイトルのセクションで定義されているとおり、CMDB でこの サービスグラフコネクタ によって作成または変更されていても、ITOM ヴィジビリティまたは ITOM ディスカバリーによってまだ管理されていない管理対象の IT リソースの場合、これらのリソースにより、そのアプリケーションからのサブスクリプションユニットの消費量が増加します。ITOM ヴィジビリティまたは ITOM ディスカバリー内の現在のサブスクリプションユニットの消費量を確認し、利用可能なキャパシティを確認してください。

    依存関係と要件：
    • 自動的にインストールされる CMDB 共通統合ストアアプリ。
    • 自動的にインストールされる CMDB CI クラスモデルストアアプリ。「CMDB CI クラスモデル アプリ」を参照してください。
    • ITOM ディスカバリーライセンスプラグイン (com.snc.itom.discovery.license)。このプラグインを有効にする必要があります。
    • ITOM Licensing プラグイン (com.snc.itom.license)。詳細については、「ディスカバリーの要求」を参照してください。
    • 自動的にインストールされる Datastream Action プラグイン (com.glide.hub.action_type.datastream)。
    • Observability Commons for CMDB (sn_observability)。これはイベントの取り込みにのみ必要です。イベント管理を機能させるには、コネクタをインストールする前に、Observability Commons for CMDB アプリをインストールする必要があります。詳細については、ServiceNow Store の「Observability Commons for CMDB」を参照してください。
    注:
    OpenTelemetry のサービスグラフコネクタ の以前のバージョンを使用している場合は、古いコネクタからデータを移行しないでください。以前のバージョンをアンインストールし、新しい統合を実行する必要があります。

    必要なロール：admin

    手順

    1. アプリケーションピッカーを使用して、アプリケーションスコープを OpenTelemetry のサービスグラフコネクタ に設定します。
      詳細については、「アプリケーションピッカー」を参照してください。
    2. 移動先 すべて > サービスグラフコネクタ > OpenTelemetry > セットアップ.
    3. [はじめに] ページで、[開始] を選択します。
    4. アプリケーションプロパティを構成して、ServiceNow クラウドオブザーバビリティ API に要求を送信するための組織および認証情報を設定します。
      1. [OpenTelemetry のサービスグラフコネクタ] ページの [接続の構成] セクションで、[開始するには] を選択します。
      2. [OpenTelemetry を使用]タスクについて、Now Support ナレッジベースの記事「ServiceNow Cloud Observability setup (ServiceNow クラウドオブザーバビリティのセットアップ) [KB1527588]」で説明されている条件をクラウドオブザーバビリティアプリケーションが満たしていることを確認します。
        重要:
        後でコネクタのインストール中に使用するために、プロジェクト、組織、および クラウドオブザーバビリティ アプリケーションの API キーの詳細をメモしておきます。
        クラウドオブザーバビリティアプリケーションで OpenTelemetry 環境を設定したら、ガイド付きセットアップに戻り、[完了としてマーク] を選択して [OpenTelemetry を使用] タスクを完了としてマークします。
      3. プロジェクト、リソース、および依存関係マッピング情報を取得する クラウドオブザーバビリティ 組織の詳細を入力します。
        1. [組織を設定 (Set up your organization)] タスクで、[構成] を選択します。
        2. [サービスグラフ接続のプロパティ] フォームの [値] フィールドに、クラウドオブザーバビリティ 組織の名前を入力します。
        3. [更新] を選択します。
        4. [完了としてマーク] を選択して、[組織を設定 (Set up your organization)] タスクを完了としてマークします。
      4. クラウドオブザーバビリティ アプリケーションに関連付けられた API キーの詳細を入力します。
        1. [API キーの設定 (Set up the API key)] タスクで、[構成] を選択します。
        2. [API キー認証情報] フォームの [API キー] フィールドに、ステップ 4.bでメモした クラウドオブザーバビリティ アプリケーションに関連付けられた API キーを入力します。
        3. [更新] を選択します。
        4. [完了としてマーク] を選択して、[API キーの設定 (Set up the API key)] タスクを完了に設定します。
      5. クラウドオブザーバビリティ アプリケーションからデータをインポートする クラウドオブザーバビリティ API 接続をテストします。
        1. [接続のテスト] タスクで、[構成] を選択します。
        2. [テスト接続] 関連リンクを選択します。
        3. [ステータス] フィールドが [成功] に設定されている場合は、[X] を選択して [接続のテスト] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。

          いずれかのテストでエラーが発生した場合は、修正の提案に従ってください。

        4. [完了としてマーク] を選択して、[テスト接続] タスクを完了に設定します。
      6. クラウドオブザーバビリティ 組織に含まれるすべてのプロジェクトを取得します。
        1. [プロジェクトを取得 (Get projects)] タスクで、[構成] を選択します。
        2. [プロジェクトを取得 (Get projects)] を選択します。
        3. ステップ 4.c.iiで指定した組織に含まれるすべてのプロジェクトが [プロジェクトプロパティ] 関連リストに入力されたら、[X] を選択して [プロジェクトを取得 (Get projects)] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。
        4. [完了としてマーク] を選択して、[プロジェクトを取得 (Get projects)] タスクを完了に設定します。
    5. オプション: 追加の構成を行って、ルックバック時間を設定し、除外されたプロジェクトを追加し、プロジェクト診断を実行し、サービスマップと古い構成アイテム (CI) の統合設定を構成します。
      1. [OpenTelemetry のサービスグラフコネクタ] ページの [詳細設定] セクションで、[続行] を選択します。
      2. プロジェクトからリソースを取得するときからのルックバック時間を設定します。

        ルックバック時間は、組織のプロジェクトからリソースを取得するための開始時間と終了時間を計算するために使用され、スケジュール済みジョブの頻度設定と一致している必要があります。たとえば、ルックバック時間が 12 時間に設定されている場合、リソースは、現在の時間から 12 時間を引いて計算された開始時間から、現在の時間である終了時間まで取得されます。

        1. [ルックバック時間の設定 (Set up lookback time)] タスクで、[構成] を選択します。
        2. [サービスグラフ接続のプロパティ] フォームの [値] フィールドに、ルックバック時間を時間単位で入力します。
        3. [更新] を選択します。
        4. [完了としてマーク] を選択して、[ルックバック時間の設定 (Set up lookback time)] タスクを完了に設定します。
      3. リソースを取得しないプロジェクトを選択します。
        1. [除外したプロジェクトを追加 (Add excluded projects)] タスクで、[構成] を選択します。
        2. [プロジェクト] 列からプロジェクトを選択します。
        3. [プロジェクトを除外 (Exclude project)] チェックボックスをオンにします。
        4. [更新] を選択します。
        5. 除外するプロジェクトごとに、手順 5.c.ii ～ 5.c.iv を繰り返します。
        6. [X] を選択して [除外したプロジェクトを追加 (Add excluded projects)] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。
        7. [完了としてマーク] を選択して、[除外したプロジェクトを追加 (Add excluded projects)] タスクを完了に設定します。
      4. プロジェクト診断を実行してリソース API 応答をテストし、API に Kubernetes クラスター名、Kubernetes 名前空間、および Kubernetes ノードが含まれていることを確認します。
        1. [プロジェクト診断を実行 (Run project diagnostics)] タスクで、[構成] を選択します。
        2. [プロジェクト] 列からプロジェクトを選択します。
        3. [診断の実行] を選択します。
        4. [診断のステータス (Diagnostics status)] フィールドが [成功] に設定されている場合は、[X] を選択して [プロジェクト診断を実行 (Run project diagnostics)] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。

          いずれかの診断テストにエラーがある場合は、[診断メッセージ (Diagnostics message)] フィールドの指示に従ってエラーを解決します。

        5. 診断を実行するプロジェクトごとに、手順 5.d.ii ～ 5.d.iv を繰り返します。
        6. [完了としてマーク] を選択して、[プロジェクト診断を実行 (Run project diagnostics)] タスクを完了に設定します。
      5. サービスマップと古い CI のシステムプロパティを設定します。
        1. [コネクタのシステムプロパティを構成 (Configure system properties for the connector)] タスクで、[構成] を選択します。
        2. プロパティのデフォルト値を検証するか、カスタム構成の値を入力します。
        3. [保存] を選択します。
        4. [完了としてマーク] を選択して、[コネクタのシステムプロパティを構成 (Configure system properties for the connector)] タスクを完了に設定します。
    6. クラウドオブザーバビリティアプリケーションから完全なデータまたは増分データをインポートするようにスケジュール済みジョブを構成します。
      1. [OpenTelemetry のサービスグラフコネクタ] ページの [スケジュール設定済みインポートジョブを構成します] セクションで、[続行] を選択します。
      2. 完全なデータインポートのスケジュール設定済みジョブをアクティブ化します。

        デフォルトでは、OpenTelemetry Resources スケジュール済みジョブは完全なデータインポートに使用できます。ただし、ジョブをアクティブ化する必要があります。

        1. [完全インポートのスケジュール済みインポートジョブを構成] タスクで [構成] を選択します。
        2. OpenTelemetry Resources スケジュール済みジョブの [予定されているデータインポート] フォームで、スケジュール済みジョブのフィールド値を確認し、[アクティブ] チェックボックスをオンにします。

          詳細については、「Schedule a data import」を参照してください。

        3. [更新] を選択します。
        4. ガイド付きセットアップで [完了としてマーク] を選択して、[完全インポートのスケジュール済みインポートジョブを構成 ] タスクを完了に設定します。
      3. オプション: デルタデータインポートのスケジュール済みジョブをアクティブ化します。

        デフォルトでは、 OpenTelemetry Delta Resources スケジュール済みジョブはデルタデータインポートに使用できます。ただし、ジョブをアクティブ化する必要があります。

        注:
        デルタデータプルは、次のシナリオでは発生しません。
        • 完全なデータインポートが同時にスケジュールされます。
        • データソースの [前回実行日時] フィールドが空です。
        • 前回のデルタデータプル期間が 3 日を超えています。
        1. [デルタインポートのスケジュール済みインポートジョブを構成] タスクで [構成] を選択します。
        2. OpenTelemetry Delta Resources スケジュール済みジョブの [予定されているデータインポート] フォームで、スケジュール済みジョブのフィールド値を確認し、[アクティブ] チェックボックスをオンにします。

          詳細については、「Schedule a data import」を参照してください。

        3. [更新] を選択します。
        4. ガイド付きセットアップで [完了としてマーク] を選択して、[デルタインポートのスケジュール済みインポートジョブを構成 ] タスクを完了に設定します。
      注:
      リソースを取得するために新しいプロジェクトを追加する場合は、部分的なデータを回避し、CMDB を正確に設定するために、デルタインポートを実行する前に必ず完全インポートを実行してください。
    7. クラウドオブザーバビリティ アプリケーションから ServiceNow イベント管理 アプリケーションにイベントを送信して、アラートとイベントを管理します。
      Observability Commons for CMDB アプリケーションがインストールされている場合にのみ、アラートとイベントを管理できます。
      注:
      この機能を有効にするには、有料の クラウドオブザーバビリティ ライセンスが必要ですが、この機能は、非本番環境で製品を評価する目的で無料のアカウントでも利用できます。詳細については、ServiceNow アカウント担当者にお問い合わせください。
      1. [OpenTelemetry のサービスグラフコネクタ] ページの [アラートとイベントの管理 (Manage alerts and events)] セクションで、[続行] を選択します。
      2. プロジェクトの Webhook 宛先を作成します。
        1. [Webhook を作成] タスクで、[構成] を選択します。
        2. [プロジェクト] 列から除外されていないプロジェクトを選択します。
        3. [Webhook を作成] を選択して、クラウドオブザーバビリティ アプリケーションで Webhook 宛先を作成します。
        4. 成功メッセージが表示されたら、[X] を選択して [Webhook を作成] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。

          Webhook が正常に作成された場合：

          • ServiceNow インスタンスの各 Webhook 宛先のユーザーレコードが自動的に作成されます。
          • ユーザーレコードのユーザー名は ls_api_<project_name> で始まり、 ユーザーには evt_mgmt_integration ロールが割り当てられます。
        5. Webhook を作成するプロジェクトごとに、手順 7.b.ii 〜 7.b.iv を繰り返します。
        6. ガイド付きセットアップで [完了としてマーク] を選択して、[Webhook を作成] タスクを完了に設定します。
      3. CMDB に一致する CI がないイベントを取り込むためのシステムプロパティを構成します。
        1. [一致しない CI のプロパティを構成 (Configure the property for unmatched CIs)] タスクで、[構成] を選択します。
        2. [値] フィールドに「true」と入力します。
        3. [更新] を選択します。
        4. ガイド付きセットアップで [完了としてマーク] を選択して、[一致しない CI のプロパティを構成 (Configure the property for unmatched CIs)] タスクを完了に設定します。