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

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

    • OpenTelemetry のサービスグラフコネクタ (旧 Lightstep) から 構成管理データベース (CMDB) にデータをプルするようにインポートジョブスケジュールを設定します。

    始める前に

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

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

    必要なロール：admin

    手順

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

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

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

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

        1. [ルックバック時間の設定 (Set up lookback time)] タスクで、[構成] を選択します。
        2. [Service Graph 接続のプロパティ] フォームの [値] フィールドに、ルックバック時間を時間単位で入力します。
        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)] ダイアログボックスを閉じ、Guided Setup ページに戻ります。
        7. [完了としてマーク] を選択して、[除外したプロジェクトを追加 (Add excluded projects)] タスクを完了に設定します。
      4. プロジェクト診断を実行してリソース API 応答をテストし、API にクラスター名、名前空間、KubernetesおよびKubernetesノードが含まれているKubernetesことを確認します。
        1. [プロジェクト診断を実行 (Run project diagnostics)] タスクで、[構成] を選択します。
        2. [プロジェクト] 列からプロジェクトを選択します。
        3. [診断の実行] を選択します。
        4. [診断のステータス (Diagnostics status)] フィールドが [成功] に設定されている場合は、[X] を選択して [プロジェクト診断を実行 (Run project diagnostics)] ダイアログボックスを閉じ、Guided Setup ページに戻ります。

          いずれかの診断テストにエラーがある場合は、[診断メッセージ (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. [Service Graph Connector for OpenTelemetry] ページの [スケジュール設定済みインポートジョブを構成] セクションで、[続行] を選択します。
      2. [ジョブスケジュールの構成] タスクの [構成] をクリックします。
      3. アクティブ化するジョブスケジュールを選択します。
      4. [予定されているデータインポート] フォームで、ジョブスケジュールのフィールド値を確認します。
        詳細については、「Schedule a data import」を参照してください。
      5. [今すぐ実行] を選択します。
      6. データインポートのジョブスケジュールそれぞれについて、ステップ 6.c 〜 6.e を繰り返します。
      7. 戻るアイコン (<) を選択して、Guided Setup ページに戻ります。
      8. Guided Setup で [完了としてマーク] を選択して、[ジョブスケジュールの構成] タスクを完了に設定します。
    7. クラウド可観測性 アプリケーションから ServiceNow イベント管理 アプリケーションにイベントを送信して、アラートとイベントを管理します。
      Observability Commons for CMDB アプリケーションがインストールされている場合にのみ、アラートとイベントを管理できます。
      注:
      この機能を有効にするには、有料の クラウド可観測性 ライセンスが必要ですが、この機能は、非本番環境で製品を評価する目的で無料のアカウントでも利用できます。詳細については、ServiceNow アカウント担当者にお問い合わせください。
      1. [Service Graph Connector for OpenTelemetry] ページの [アラートとイベントの管理 (Manage alerts and events)] セクションで、[続行] を選択します。
      2. プロジェクトの Webhook 宛先を作成します。
        1. [Webhook を作成] タスクで、[構成] を選択します。
        2. [プロジェクト] 列から除外されていないプロジェクトを選択します。
        3. [Webhook を作成] を選択して、クラウド可観測性 アプリケーションで Webhook 宛先を作成します。
        4. 成功メッセージが表示されたら、[X] を選択して [Webhook を作成] ダイアログボックスを閉じ、Guided Setup ページに戻ります。

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

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