Observability:Dynatrace のサービスグラフコネクタ の構成

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む19読むのに数分
  • REST API を使用して Dynatrace から 構成管理データベース (CMDB) データを取り込むには、 Observability:Dynatrace のサービスグラフコネクタ を使用します。このコネクタは、ServiceNow によって開発された Observability:Dynatrace のサービスグラフコネクタ アプリケーションの第 2 世代です。

    始める前に

    この サービスグラフコネクタを使用するには、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)。
    • CMDB 用 Observability Commons (sn_observability)。これはイベントの取り込みにのみ必要であり、Event Management が機能するように、コネクタをインストールする前にインストールする必要があります。詳細については、ServiceNow Store にある「CMDB 用 Observability Commons」を参照してください。
    注:
    API にアクセスするには Dynatrace 、エンティティの読み取り (entities.read) スコープを持つアクセス トークンが必要です。

    必要なロール:管理者

    手順

    1. 移動先 すべて > サービスグラフコネクタ > Dynatrace 観測可能性 > セットアップ.
    2. [はじめに] ページで、[開始するには] を選択します。
    3. クラスターの影響度の値を設定し、コネクタが SNC にアクセスできるようにします。ImpactManager API
      注:
      このステップは、Observability Commons がインストールされている場合に表示されます。
      1. [セットアップ] ページの [SNC へのアクセスを有効にする] で、[影響マネージャー] セクションで、[ グローバルスコープにスクリプトをコピー] タスクを選択します。
      2. [グローバルスコープにスクリプトをコピー] セクションで、スクリプトをコピーします。
        1. [構成] をクリックします。
        2. グローバルスコープに切り替えます。
        3. [他のアクション] アイコン (他のアクションアイコン) を選択します。
        4. [挿入と維持] を選択します。
        5. [完了としてマーク] をクリックします。
      3. [スクリプトが適切にコピーされていることを確認] セクションで、スクリプトを確認します。
        1. [構成] をクリックします。
        2. EvtMgmtImpactManagerMediator スクリプトを選択し、グローバルスコープにコピーされていることを確認します。
        3. [アクセス可能] フィールドで、[すべてのアプリケーションスコープ]に設定されていることを確認します。
        4. [完了としてマーク] をクリックします。
    4. 基本セットアップを構成します。
      1. [セットアップ] ページの [基本] セクションで、[Dynatrace の認証トークンを構成] タスクを選択します。
      2. 次のページの [Dynatrace の認証トークンを構成] セクションで、認証トークンを構成します。
        1. [構成] をクリックします。
        2. [API キー] フィールドに「api-token <API トークン>」と入力します。

          例:api-token mytokenid

        3. [完了としてマーク] をクリックします。
      3. [Dynatrace の HTTP 接続を構成]セクションで、HTTP 接続を構成します。
        1. [構成] をクリックします。
        2. [ホスト] フィールドを Dynatrace インスタンスの完全修飾ホスト名に更新します。

          例:abc123.live.dynatrace.com

          ホスト名は [接続 URL] フィールドに自動的に入力されます。

        3. MID サーバー の使用を有効にして、[MID Server を使用] チェックボックスを選択します。
          注:
          HTTP 接続は、前のセットアップタスクで構成された API キーを使用するように事前構成されます。
        4. [完了としてマーク] をクリックします。
      4. [テスト接続] セクションで、接続をテストして、[構成] を選択します。
        1. [テスト接続] セクションで、[構成] を選択します。
        2. 接続構成をテストするために、[テスト接続] を選択します。
          注:
          テスト接続が失敗した場合は、接続にエラーがあるので、修正する必要があります。
        3. 終了したら、[完了としてマーク] をクリックします。
      5. [デフォルト通知ペイロードテンプレートを作成] セクションで、[構成] を選択します。
        注:
        次のスコープを持つアクセストークンが必要です。
        • 構成の読み取り (ReadConfig)
        • 構成の書き込み (WriteConfig)
        • ログの読み取り (LogExport)
        • 測定基準の読み取り (metrics.read)
        1. 必要に応じて、ペイロードテンプレートの名前を更新します。
        2. [問題通知のセットアップ] をクリックします。
        3. 終了したら、[完了としてマーク] をクリックします。
      6. オプション: マルチインスタンスをサポートする場合は、[ソースネイティブキーのアップグレード] セクションで、[構成] をクリックします。
        1. グローバルスコープに切り替えます。
        2. 次のスクリプトを入力します。
          var gr = new GlideRecord("sys_object_source");
          gr.addQuery("name", "SGO-Dynatrace");
          var grOR = gr.addQuery("id", "STARTSWITH", "HOST-");
          grOR.addOrCondition("id", "STARTSWITH", "PROCESS_GROUP_INSTANCE-");
          grOR.addOrCondition("id", "STARTSWITH", "PROCESS_GROUP-");
          grOR.addOrCondition("id", "STARTSWITH", "SERVICE-");
          grOR.addOrCondition("id", "STARTSWITH", "APPLICATION-");
          gr.query();
          while (gr.next()) {
              gr.setValue("id", "f379137e075820107add6a77c4a93538|||" + gr.getValue("id"));
              gr.update();
          }
        3. [スクリプトの実行] を選択します。
        4. [スコープ] メニューから、[Service Graph Connector for Observability Dynatrace] を選択し、[完了としてマーク] を選択します。
    5. 追加の構成を設定します。
      1. [Guided Setup] ページの [詳細] セクションで、[詳細設定] タスクを選択します。
      2. [詳細設定] セクションで、[構成] を選択し、カスタム構成の既存の設定を確認または変更します。
        次の設定を構成できます。
        • Dynatrace エンティティをフェッチするために REST API 要求で使用されるページサイズのレビュー。
        • 構成アイテム (CI) が非アクティブ状態になってから無視されるまでの日数の定義。
        • サービスマップで、あるステータスが親に反映されるために、そのステータスとなる必要があるアプリケーションクラスターのノードの割合の入力。

          たとえば、クラスターの親のステータスが「重大」になるために、「重大」になることが必要なノードの割合を定義できます。クラスター内に 10 個のノードがある場合、プロパティ値を 70 に設定すると、クラスターの親サービスに反映されるには、クラスター内の 10 個のノードのうち少なくとも 7 個が重大な状態になる必要があります。

        • CMDB に一致する CI がないイベントの取り込みを有効にします。
        • インポートスケジュール中に、Dynatrace からのアプリケーション (cmdb_ci_appl) CI の入力を有効にします (Dynatrace プロセス)。
      3. [保存] をクリックします。
      4. [詳細設定] タスクで [完了としてマーク ] を選択します。
      5. Dynatrace 接続の接続プロパティを構成します。
        1. [インスタンスの設定構成] セクションで、[構成] を選択します。
        2. [Service Graph 接続のプロパティ (Service Graph Connection Properties)] 関連リストで、接続レコードのプロパティを構成します。
          表 : 1. Dynatrace 接続のプロパティ
          プロパティ 説明
          managementZoneName Dynatrace 環境からフェッチする管理ゾーンの名前を入力します。複数のエントリでは、ドメインをカンマで区切ります。
          タグ Dynatrace 環境からフェッチするタグの名前を入力します。複数のエントリでは、ドメインをカンマで区切ります。
          serviceTypes Dynatrace 環境からフェッチする管理ゾーンの名前を入力します。複数のエントリでは、ドメインをカンマで区切ります。
          managementZoneId Dynatrace 環境からフェッチする管理ゾーンの名前を入力します。複数のエントリでは、ドメインをカンマで区切ります。
        3. [更新] をクリックします。
        4. [完了としてマーク] をクリックして、[インスタンス設定の構成] タスクを完了します。
      6. 通知設定を構成します。

        セットアップにより、ITOM イベントを Dynatrace から ServiceNow インスタンスにプルできます。

        1. [問題通知を構成] セクションで、[構成] を選択します。
        2. 構成を Dynatrace にプッシュするには、[問題通知のセットアップ] を選択します。
        3. Dynatraceから構成を受け取るには、[フェッチ通知のセットアップ (Fetch Notification Setup)] を選択します。
        4. [完了としてマーク] をクリックして、[問題通知を構成] タスクを完了します。
    6. 前のインスタンスのレコードをクリーンアップします。
      注:
      以前のバージョンの Dynatrace から移行していない場合は、このステップをスキップできます。
      1. [セットアップ] ページの [以前の統合からのレコードをクリーンアップ] セクションで、[新規統合を実行] タスクを選択します。
      2. 次のページの [新規統合を実行] セクションで、[構成] を選択し、[今すぐ実行] を選択します。
      3. [完了としてマーク] を選択します。
      4. [統合の実行が完了したことを確認] セクションで、統合の実行を確認します。
        1. [構成] をクリックします。
        2. [状態] フィールドで、フィールドが [完了] または [完了 (エラーあり)] に変わるのを待ちます。

          通常、古いバージョンからの移行中にエラーが発生します。

        3. リストを更新する必要がある場合は、ヘッダーを右クリックし、[リストを更新] を選択します。
        4. [完了としてマーク] をクリックします。
      5. [以前のバージョンから残っているアプリケーションサービスを削除] セクションで、[構成] を選択し、以前の統合から不要になったアプリケーションサービスを削除します。
      6. [完了としてマーク] をクリックします。
      7. [識別の残りをクリーンアップ:スクリプトをコピー] セクションで、スクリプトをコピーします。
        1. [構成] をクリックします。
        2. 現在のスコープを [グローバル] に変更します。
        3. メニューアイコン (メニューアイコン) をクリックします。
        4. [挿入と維持] をクリックします。
        5. [完了としてマーク] をクリックします。
      8. [識別の残りをクリーンアップ:スクリプトを実行] セクションで、スクリプトを実行します。
        1. [構成] をクリックします。
        2. コピーしたスクリプトのレコードを選択します。
        3. [今すぐ実行] をクリックします。
    7. オプション: 複数のインスタンスを追加します。
      注:
      複数のインスタンスを追加する必要がない場合は、この手順をスキップできます。
      1. 左側のサイドバーで、[複数のインスタンスを追加] アイコン (複数のインスタンスを追加アイコン) を選択します。
      2. [Service Graph Connector for Observability Dynatrace のセットアップ] ページの [複数のインスタンスを追加] セクションで、[データソースアクセスを更新] タスクを選択します。
      3. 次のページの [データソースアクセスを更新] セクションで、[構成] を選択します。
      4. データソース [sys_data_source] テーブルを選択します。
      5. レコードを編集するには、[スコープ] メニューから [グローバル] を選択します。
      6. [アプリケーションのアクセス] タブで、[他のアプリケーションスコープからの作成アクセスを許可][他のアプリケーションスコープからの書き込みアクセスを許可]、および [他のアプリケーションスコープからの削除アクセスを許可] チェックボックスをオンにします。
      7. レコードを保存します。
      8. [スコープ] メニューから、[Service Graph Connector for Observability Dynatrace] を選択します。
      9. ヘルプタスクバーで、[完了としてマーク] をクリックします。
      10. スケジュール設定済みデータインポート [scheduled_data_set] テーブルのある [スケジュール設定済みデータインポートアクセスを更新] セクション、および値 [sys_variable_table] テーブルのある [値アクセスを更新] セクションで、これらのステップを繰り返します。
    8. 新しい接続のキャッシュをクリアします。
      1. [データソースとインポートセットのキャッシュをクリア] タスクを選択してから、[構成] を選択します。
      2. キャッシュをクリアするには、[スコープ] メニューから [グローバル] を選択します。
      3. 次のスクリプトを入力します。
        
              GlideTableManager.invalidateTable("sys_data_source");
              GlideCacheManager.flushTable("sys_data_source");
        
              GlideTableManager.invalidateTable("scheduled_import_set");
              GlideCacheManager.flushTable("scheduled_import_set");
        
              GlideTableManager.invalidateTable("sys_variable_value");
              GlideCacheManager.flushTable("sys_variable_value");
        
              GlideTableManager.invalidateTable("sys_db_object");
              GlideCacheManager.flushTable("sys_db_object");
      4. [スクリプトの実行] を選択します。
      5. [スコープ] メニューから、[Service Graph Connector for Observability Dynatrace] を選択します。
      6. [完了としてマーク] をクリックします。
    9. 別の接続を追加します。
      注:
      スコープを [Service Graph Connector for Observability] に変更します。そうしないと、追加の接続をロードできません。
      1. [別の接続を追加] セクションで、[構成] をクリックします。
      2. Flow Designer で、[接続を追加] を選択します。
      3. フォームのフィールドに入力します。
        表 : 2. 接続フォーム
        フィールド 説明
        接続名 接続の表示名。
        接続ホスト名 Dynatrace インスタンスのホスト名。
        API キー Dynatrace API キー
        注:
        API キーにはプレフィックス api-token を付ける必要があります。
      4. [接続を作成] をクリックします。
      5. ガイド付き設定に戻り、[完了としてマーク] をクリックします。
      6. 必要に応じて、作成した接続の MID Server を設定します。
        1. [MID Server を構成] セクションで、[構成] をクリックします。
        2. 作成した接続の名前を選択します。
        3. [MID Server を使用] チェックボックスをオンにします。
        4. [更新] をクリックします。
        5. タスクが完了したら、[完了としてマーク] をクリックします。
      7. インスタンス設定を構成します。
        1. [インスタンスの構成 (Configure Instance)] セクションで、[構成] をクリックします。
        2. 構成する接続の名前を選択します。
        3. 終了したら、[更新]をクリックし、次に [完了としてマーク] をクリックします。
      8. 新しい接続をテストします。
        1. [テスト接続] セクションで、[構成] を選択します。
        2. テストする接続の名前を選択します。
        3. データソース構成を検証するには、[20 件のレコードのテストロード] ボタンをクリックします。
          注:
          テスト接続が失敗した場合は、接続にエラーがあるので、修正する必要があります。
        4. 終了したら、[完了としてマーク] をクリックします。
      9. [デフォルト通知ペイロードテンプレートを作成] セクションで、[構成] を選択します。
        注:
        次のスコープを持つアクセストークンが必要です。
        • 構成の読み取り (ReadConfig)
        • 構成の書き込み (WriteConfig)
        • ログの読み取り (LogExport)
        • 測定基準の読み取り (metrics.read)
        1. デフォルト通知ペイロードテンプレートを作成する接続を選択します。
        2. 必要に応じて、ペイロードテンプレートの名前を更新します。
        3. [問題通知のセットアップ] をクリックします。
          通知は、次の表に示すように、ペイロードパラメーターを使用して作成されます。
          表 : 3. 通知ペイロードパラメーター
          パラメーター 説明
          name 通知の名前。名前には 、ServiceNow デフォルトの問題通知 というプリフィックスが自動的に付き、インスタンス名が追加されます。
          alertingProfile のアラートプロファイルの DynatraceID。
          type Webhook に自動的に設定されるペイロードのタイプ。
          URL https://https://&lt;instance name>.service-now.com//api/sn_em_connector/em/inbound_event?source=SGO-Dynatrace 形式の Webhook URL。
          payload 次の形式で通知用に作成されたカスタムペイロード:
          {  
          
            "ImpactedEntities": {ImpactedEntities},  
          
            "ImpactedEntity": "{ImpactedEntity}",  
          
            "PID": "{PID}",  
          
            "ProblemDetailsHTML": "{ProblemDetailsHTML}",  
          
            "ProblemDetailsJSON": {ProblemDetailsJSON},  
          
            "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}",  
          
            "ProblemDetailsText": "{ProblemDetailsText}",  
          
            "ProblemID": "{ProblemID}",  
          
            "ProblemImpact": "{ProblemImpact}",  
          
            "ProblemSeverity": "{ProblemSeverity}",  
          
            "ProblemTitle": "{ProblemTitle}",  
          
            "ProblemURL": "{ProblemURL}",  
          
            "State": "{State}",  
          
            "Tags": "{Tags}"  
          
          } 
        4. 接続ごとにこの手順を繰り返します。
        5. 終了したら、[完了としてマーク] をクリックします。
    10. スケジュール設定済みインポートジョブをセットアップします。
      1. [セットアップ] ページの [スケジュール設定済みインポートジョブを設定 (Set up scheduled import jobs)] セクションで、[スケジュール設定済みインポートジョブを構成 (Configure the scheduled import jobs)] タスクを選択します。
      2. 次のページで、[構成] を選択します。
      3. 必要に応じて、フォームのフィールドを確認します。
        表 : 4. [スケジュール設定済みデータインポート] フォーム
        フィールド 説明
        名前 ジョブスケジュールの名前。
        データソース インポートするデータを定義するデータソースレコード。
        実行方法 指定したユーザーの資格情報を使用してジョブスケジュールを実行するオプション。
        アクティブ ジョブスケジュールをアクティブ化するためのオプション。このオプションを選択します。
        同時インポート 複数のインポートセットからデータをロードする関数。この関数は、データの処理と変換を同時に行います。
        パーティションメソッド 同時インポートセットのパーティションメソッド。
        パーティションサイズ 初期スケジューリングのインポートセットサイズ。
        インポート前処理スクリプトの実行 インポートが実行される前に実行するスクリプトを指定するオプション。
        インポート後処理スクリプトの実行 インポートが実行された後に実行するスクリプトを指定するオプション。
        アプリケーション このジョブスケジュールを含むアプリケーション。
        実行 インポートを実行する頻度。この値を、データをプルする頻度に設定します。
        条件付き このジョブの実行条件。
      4. 実行するインポートを選択し、[今すぐ実行] をクリックしてから [完了としてマーク] をクリックします。