オブザーバビリティのサービスグラフコネクタ - Dynatraceの構成
REST API を使用して Dynatrace から 構成管理データベース (CMDB) データを取り込むには、 オブザーバビリティのサービスグラフコネクタ - Dynatrace を使用します。このコネクタは、ServiceNow によって開発された オブザーバビリティのサービスグラフコネクタ - Dynatrace アプリケーションの第 2 世代です。
始める前に
この サービスグラフコネクタを使用するには、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)。
- CMDB 用 Observability Commons (sn_observability)。これはイベントの取り込みにのみ必要であり、イベント管理が機能するように、コネクタをインストールする前にインストールする必要があります。詳細については、ServiceNow Store にある「CMDB 用 Observability Commons」を参照してください。
必要なロール:admin
手順
- 次のように移動する。 All (すべて) > Service Graph Connector > Dynatrace 観測可能性 > セットアップ.
- [はじめに] ページで、[開始] を選択します。
-
クラスターの影響度の値を設定し、コネクタが SNC.ImpactManager API にアクセスできるようにします。
注:このステップは、Observability Commons がインストールされている場合に表示されます。
- [セットアップ] ページの [SNC.Impact Manager へのアクセスを有効にする (Enable Access To SNC.Impact Manager)] で、[グローバルスコープにスクリプトをコピー] タスクを選択します。
-
[グローバルスコープにスクリプトをコピー] セクションで、スクリプトをコピーします。
- [設定] を選択します。
- グローバルスコープに切り替えます。
- [他のアクション] アイコン (
) を選択します。
- [挿入と維持] を選択します。
- [完了としてマーク] を選択します。
-
[スクリプトが適切にコピーされていることを確認] セクションで、スクリプトを確認します。
- [設定] を選択します。
- EvtMgmtImpactManagerMediator スクリプトを選択し、グローバルスコープにコピーされていることを確認します。
- [アクセス可能] フィールドで、[すべてのアプリケーションスコープ]に設定されていることを確認します。
- [完了としてマーク] を選択します。
-
基本セットアップを構成します。
- [セットアップ] ページの [基本] セクションで、[Dynatrace の認証トークンを構成] タスクを選択します。
-
次のページの [Dynatrace の認証トークンを構成] セクションで、認証トークンを構成します。
- [設定] を選択します。
- [API キー] フィールドに「api-token <API トークン>」と入力します。
例:api-token mytokenid。
- [完了としてマーク] を選択します。
-
[Dynatrace の HTTP 接続を構成]セクションで、HTTP 接続を構成します。
- [設定] を選択します。
- [ホスト] フィールドを Dynatrace インスタンスの完全修飾ホスト名に更新します。
例:abc123.live.dynatrace.com。
ホスト名は [接続 URL] フィールドに自動的に入力されます。
- MID サーバー の使用を有効にして、[MID サーバーを使用] チェックボックスを選択します。注:HTTP 接続は、前のセットアップタスクで構成された API キーを使用するように事前構成されます。
- [完了としてマーク] を選択します。
-
HTTP 接続をテストします。
- [テスト接続] セクションで、[構成] を選択します。
- 接続構成をテストするために、[テスト接続] を選択します。注:いずれかのテストでエラーが発生した場合は、修正の提案に従ってください。
- [完了としてマーク] を選択して、[テスト接続] タスクを完了に設定します。
-
[デフォルト通知ペイロードテンプレートを作成] セクションで、[構成] を選択します。
注:次のスコープを持つアクセストークンが必要です。
- 構成の読み取り (ReadConfig)
- 構成の書き込み (WriteConfig)
- ログの読み取り (LogExport)
- メトリクスの読み取り (metrics.read)
- 設定の読み取り (settings.read)
- 設定の書き込み (settings.write)
- ログの読み取り (logs.read)
- 必要に応じて、ペイロードテンプレートの名前を更新します。
- [問題通知をセットアップ] を選択します。
- [完了としてマーク] を選択して、[デフォルト通知ペイロードテンプレートを作成] タスクを完了に設定します。
- オプション:
複数のインスタンスをサポートする場合は、[ソースネイティブキーのアップグレード] セクションで、[構成] を選択します。
- グローバルスコープに切り替えます。
- 次のスクリプトを入力します。
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(); } - [スクリプトの実行] を選択します。
- [スコープ] メニューから、[Observability:Dynatrace のサービスグラフコネクタ] を選択し、[完了としてマーク] を選択します。
-
Grail 対応テナントの場合は、OAuth 2.0 クライアント認証情報を設定し、接続をテストします。
Dynatrace OAuth 認証情報の詳細については、Dynatrace ドキュメントサイトの「Authentication for the Account Management API (アカウント管理 API の認証)」を 参照してください。
-
Dynatrace Grail ステータスを設定して、Grail 対応テナントを使用するかどうかを示します。
注:
Dynatrace アドミニストレーターに連絡して、Grail が有効かどうかを確認できます。
- [Observability:Dynatrace のサービスグラフコネクタのセットアップ] ページの [Dynatrace Grail OAuth を構成 (Configure Dynatrace Grail OAuth)] セクションで、[開始] を選択します。
- [Dynatrace Grail ステータスを設定 (Set Dynatrace Grail status)] タスクで、[構成] を選択し、Grail 対応テナントのプロパティ設定を確認または変更します。
- Grail 対応テナントがある場合は、 grailEnabled プロパティの [値 ] フィールドを true に設定します。
そうでない場合は、値の設定を false のままにします。
- [完了としてマーク] を選択して [Dynatrace Grail OAuth を構成 (Configure Dynatrace Grail OAuth)] タスクを完了に設定します。
-
新規 OAuth 接続を追加します。
注:Grail には、次のスコープ権限を持つ OAuth トークンが必要です。
- storage:logs:read
- storage:buckets:read
- [OAuth 認証情報の構成 (Configure OAuth credentials)] セクションで、[構成] をクリックします。
- 新しいブラウザタブで開くワークフロースタジオページで、[接続を追加] を選択します。
- 名前、接続 URL、OAuth クライアント ID、および OAuth クライアントシークレットの詳細を入力します。
- [OAuth トークンを作成して取得] を選択します。
- ガイド付きセットアップページに戻ります。
- [完了としてマーク] を選択して、[OAuth 認証情報の構成 (Configure OAuth credentials)] タスクを完了に設定します。
-
新規 OAuth 接続をテストします。
- [テスト接続] セクションで、[構成] を選択します。
- 接続構成をテストするために、[テスト接続] を選択します。
- [ステータス] フィールドが [成功] に設定されている場合は、[更新] を選択して [接続のテスト] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。
いずれかのテストでエラーが発生した場合は、修正の提案に従ってください。
- [完了としてマーク] を選択して、[テスト接続] タスクを完了に設定します。
-
Dynatrace Grail ステータスを設定して、Grail 対応テナントを使用するかどうかを示します。
-
追加の構成を設定します。
- [ガイド付きセットアップ] ページの [詳細] セクションで、[詳細設定] タスクを選択します。
-
[詳細設定] セクションで、[構成] を選択し、カスタム構成の既存の設定を確認または変更します。
次の設定を構成できます。
- Dynatrace エンティティをフェッチするために REST API 要求で使用されるページサイズのレビュー。
- 構成アイテム (CI) が非アクティブ状態になってから無視されるまでの日数の定義。
- サービスマップで、あるステータスが親に反映されるために、そのステータスとなる必要があるアプリケーションクラスターのノードの割合の入力。
たとえば、クラスターの親のステータスが「重大」になるために、「重大」になることが必要なノードの割合を定義できます。クラスター内に 10 個のノードがある場合、プロパティ値を
70に設定すると、クラスターの親サービスに反映されるには、クラスター内の 10 個のノードのうち少なくとも 7 個が重大な状態になる必要があります。 - CMDB に一致する CI がないイベントの取り込みを有効にします。
- スケジュール済みインポート中に、Dynatrace からのアプリケーション (cmdb_ci_appl) CI の入力を有効にします (Dynatrace プロセス)。
- [保存] を選択します。
- [詳細設定] タスクで [完了としてマーク ] を選択します。
-
Dynatrace 接続の接続プロパティを構成します。
- [インスタンスの設定構成] セクションで、[構成] を選択します。
- [サービスグラフ接続のプロパティ (Service Graph Connection Properties)] 関連リストで、接続レコードのプロパティを構成します。
表 : 1. Dynatrace 接続のプロパティ プロパティ 説明 managementZoneName Dynatrace 環境からフェッチする管理ゾーンの名前を入力します。複数のエントリでは、ドメインをカンマで区切ります。 タグ Dynatrace 環境からフェッチするタグの名前を入力します。複数のエントリでは、タグをカンマで区切ります。 serviceTypes CMDBにデータを取り込むDynatraceサービスタイプのリストを入力します。複数のエントリでは、サービスタイプをカンマで区切ります。 注:DATABASE_SERVICE を除くすべてのサービスタイプは、計算されたアプリケーションサービス [cmdb_ci_service_calculated] CMDB テーブルにマッピングされます。DATABASE_SERVICE サービスタイプは、データベースインスタンス [cmdb_ci_db_instance] CMDB テーブルにマッピングされます。有効な値は次のとおりです。
- BACKGROUND_ACTIVITY
- CICS_SERVICE
- CUSTOM_SERVICE
- DATABASE_SERVICE
- ENTERPRISE_SERVICE_BUS_SERVICE
- 外部
- IBM_INTEGRATION_BUS_SERVICE
- IMS_SERVICE
- MESSAGING_SERVICE
- QUEUE_LISTENER_SERVICE
- RMI_SERVICE
- RPC_SERVICE
- WEB_REQUEST_SERVICE
- WEB_SERVICE
managementZoneId Dynatrace環境からフェッチする管理ゾーン ID の名前を入力します。複数のエントリの場合、ゾーン ID をカンマで区切ります。 - [更新] を選択します。
- [完了としてマーク] を選択して、[インスタンス設定の構成] タスクを完了します。
-
Fix Older Ids 修正スクリプトを実行して、インポートされたデータの ID を以前の形式から最新の形式のオブジェクト ID に移行します。
注:オブザーバビリティのサービスグラフコネクタ - Dynatrace のバージョン 1.9.0 以降では、オブジェクト ID の最新形式である Base64 エンコーディングがデータのインポートに使用されます。Fix Older Ids 修正スクリプトは、以前のオブジェクト ID を持つ既存のデータを最新の形式に移行します。
-
通知設定を構成します。
セットアップにより、ITOM イベントを Dynatrace から ServiceNow インスタンスにプルできます。
- [問題通知を構成] セクションで、[構成] を選択します。
- 構成を Dynatrace にプッシュするには、[問題通知のセットアップ] を選択します。
- Dynatraceから構成を受け取るには、[フェッチ通知のセットアップ (Fetch Notification Setup)] を選択します。
- [完了としてマーク] を選択して、[問題通知を構成] タスクを完了します。
-
前のインスタンスのレコードをクリーンアップします。
注:以前のバージョンの Dynatrace から移行していない場合は、このステップをスキップできます。
- [セットアップ] ページの [以前の統合からのレコードをクリーンアップ] セクションで、[新規統合を実行] タスクを選択します。
- 次のページの [新規統合を実行] セクションで、[構成] を選択し、[更新] を選択します。
- [完了としてマーク] を選択します。
-
[統合の実行が完了したことを確認] セクションで、統合の実行を確認します。
- [設定] を選択します。
- [状態] フィールドで、フィールドが [完了] または [完了 (エラーあり)] に変わるのを待ちます。
通常、古いバージョンからの移行中にエラーが発生します。
- リストを更新するには、ヘッダーを選択してホールド (または右クリック) し、[リストを更新] を選択します。
- [完了としてマーク] を選択します。
- [以前のバージョンから残っているアプリケーションサービスを削除] セクションで、[構成] を選択し、以前の統合から不要になったアプリケーションサービスを削除します。
- [完了としてマーク] を選択します。
-
[識別の残りをクリーンアップ:スクリプトをコピー] セクションで、スクリプトをコピーします。
- [設定] を選択します。
- 現在のスコープを [グローバル] に変更します。
- [メニュー] アイコン (
) を選択します。
- [挿入と維持] を選択します。
- [完了としてマーク] を選択します。
-
[識別の残りをクリーンアップ:スクリプトを実行] セクションで、スクリプトを実行します。
- [設定] を選択します。
- コピーしたスクリプトのレコードを選択します。
- [更新] を選択します。
- オプション:
複数のインスタンスを追加します。
注:複数のインスタンスを追加する必要がない場合は、この手順をスキップできます。
- [Microsoft Defender のサービスグラフコネクタ] ページの [複数のインスタンスを追加] セクションで、[開始] を選択します。
-
データソースアクセスを更新して、新規接続のデータソースを作成します。
- データソース [sys_data_source] テーブルの編集権限があることを確認してください。
- [データソースアクセスを更新] タスクの、[構成] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択して、ガイド付きセットアップページに戻ります。
- アプリケーションピッカーを使用して、[Observability:Dynatrace のサービスグラフコネクタ] アプリケーションスコープを選択します。
- [完了としてマーク] を選択して、[データソースアクセスを更新] タスクを完了に設定します。
-
スケジュール設定済みデータインポートアクセスを更新して、新規接続のスケジュール済みインポートを作成します。
- 予定されているデータインポート [scheduled_import_set] テーブルの編集権限があることを確認してください。
- [スケジュール設定済みデータインポートアクセスを更新 (Update Scheduled Data Import Acces)] タスクで、[構成] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択して、ガイド付きセットアップページに戻ります。
- アプリケーションピッカーを使用して、[Observability:Dynatrace のサービスグラフコネクタ] アプリケーションスコープを選択します。
- [完了としてマーク] を選択して、[予定されているデータインポートアクセスを更新] タスクを完了に設定します。
-
値アクセスを更新して、新規接続のデータソースを作成します。
- 値 [sys_variable_value] テーブルの編集権限があることを確認してください。
- [値アクセスを更新] タスクの、[構成] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択して、ガイド付きセットアップページに戻ります。
- アプリケーションピッカーを使用して、[Observability:Dynatrace のサービスグラフコネクタ] アプリケーションスコープを選択します。
- [完了としてマーク] を選択して、[値アクセスを更新] タスクを完了に設定します。
-
新規接続のデータソースとインポートセットのキャッシュをクリアします。
- [データソースとインポートセットのキャッシュをクリア] タスクで、[構成] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- [スクリプトを実行 (サーバー上で実行される JavaScript)] フィールドで、次のスクリプトを入力します。
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"); - [スクリプトの実行] を選択します。
- アプリケーションピッカーを使用して、[Observability:Dynatrace のサービスグラフコネクタ] アプリケーションスコープを選択します。
- [完了としてマーク] を選択して、[データソースとインポートセットのキャッシュをクリア] タスクを完了に設定します。
-
別の接続を追加します。
- アプリケーションピッカーで、アプリケーションスコープが [Observability のサービスグラフコネクタ (Service Graph Connector for Observability)] に設定されていることを確認します。
- [別の接続を追加] タスクで、[構成] を選択します。
- 新しいブラウザタブで開くワークフロースタジオページで、[接続を追加] を選択します。
- フォームのフィールドに入力します。
表 : 2. 接続フォーム フィールド 説明 接続名 接続の表示名。 接続ホスト名 Dynatrace インスタンスのホスト名。 API キー Dynatrace API キー 注:API キーにはプレフィックス api-token を付ける必要があります。 - [接続を作成] を選択します。
- ガイド付きセットアップページに戻ります。
- [完了としてマーク] を選択して、[別の接続を追加] タスクを完了に設定します。
-
Grail 対応テナントを使用している場合は、追加の OAuth 2.0 接続を構成します。
- [別の OAuth 接続を追加 (Add another OAuth connection)] タスクで、[構成] を選択します。
- 新しいブラウザタブで開くワークフロースタジオページで、[接続を追加] を選択します。
- 名前、接続 URL、OAuth クライアント ID、および OAuth クライアントシークレットの詳細を入力します。
- [OAuth トークンを作成して取得] を選択します。
- ガイド付きセットアップページに戻ります。
- [完了としてマーク] を選択して、[別の OAuth 接続を追加 (Add another OAuth connection)] タスクを完了に設定します。
-
Grail 対応テナントを使用している場合は、以前に [別の OAuth 接続を追加 (Add another OAuth connection)] タスクで作成した OAuth 2.0 クライアント認証情報エイリアスを選択します。
- [OAuth クライアント認証情報で接続レコードをリンク (Link connection record with OAuth client credentials)] タスクで、[構成] を選択します。
- [OAuth 2.0 接続および資格情報エイリアス (OAuth 2.0 Connection and Credentials Alias)] フィールドで、ステップ 8.gで作成した OAuth 接続エイリアスを検索して選択します。
- [サービスグラフ接続レコード (Service Graph connection record)]で、ステップ 8.f で作成した接続レコードを検索して選択します。
- [送信] を選択します。
- ガイド付きセットアップページに戻ります。
- [完了としてマーク] を選択して、[OAuth クライアント認証情報で接続レコードをリンク (Link connection record with OAuth client credentials)] タスクを完了に設定します。
- オプション:
作成した接続の MID サーバーを設定します。
- [MID サーバーを構成] タスクで、[構成] を選択します。
- 作成した接続の名前を選択します。
- [MID サーバーを使用] チェックボックスをオンにします。
- [更新] を選択します。
- [完了としてマーク] を選択して、[MID サーバーを構成] タスクを完了に設定します。
-
インスタンス設定を構成します。
- [インスタンスの構成 (Configure Instance)] セクションで、[構成] を選択します。
- 構成する接続の名前を選択し、[更新] を選択します。
- [完了としてマーク] を選択して、[インスタンスの構成 (Configure Instance)] タスクを完了に設定します。
-
新しい接続をテストします。
- [接続のテスト] タスクで、[構成] を選択します。
- テストする接続の名前を選択します。
- データソース構成を検証するには、[20 件のレコードのテストロード] を選択します。
- [ステータス] フィールドが [成功] に設定されている場合は、[更新] を選択して [接続のテスト] ダイアログボックスを閉じ、ガイド付きセットアップページに戻ります。
いずれかのテストでエラーが発生した場合は、修正の提案に従ってください。
- [完了としてマーク] を選択して、[接続のテスト] タスクを完了に設定します。
-
デフォルト通知ペイロードテンプレートを作成します。
- 次のスコープのアクセストークンがあることを確認します。
- 構成の読み取り (ReadConfig)
- 構成の書き込み (WriteConfig)
- ログの読み取り (LogExport)
- メトリクスの読み取り (metrics.read)
- [デフォルト通知ペイロードテンプレートを作成] タスクで、[構成] を選択します。
- デフォルト通知ペイロードテンプレートを作成する接続を選択します。
- 必要に応じて、ペイロードテンプレートの名前を更新します。
- [問題通知をセットアップ] を選択します。通知は、次の表で示すように、ペイロードパラメーターを使用して作成されます。
表 : 3. 通知のペイロードパラメーター パラメーター 説明 name 通知の名前。名前には「 ServiceNow Default Problem Notification」というプリフィックスが自動的に付き、そこにインスタンス名が追加されます。alertingProfile Dynatrace でのアラートプロファイルの ID。 type Webhookに自動的に設定されるペイロードのタイプ。URL https://https://<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}" } - 接続ごとにこの手順を繰り返します。
- [完了としてマーク] を選択して、[デフォルト通知ペイロードテンプレートを作成] タスクを完了に設定します。
- 次のスコープのアクセストークンがあることを確認します。
-
スケジュール済みインポートジョブをセットアップします。
- [Microsoft Defender のサービスグラフコネクタ (Service Graph Connector for Microsoft Defender)] ページの [スケジュール済みインポートジョブを設定します] セクションで、[開始するには] を選択します。
- [スケジュール済みインポートジョブを構成] タスクの [構成] を選択します。
- 実行するスケジュール済みインポートの名前を選択します。
-
[予定されているデータインポート] フォームで、スケジュール済みジョブのフィールド値を確認し、[アクティブ] チェックボックスをオンにします。
詳細については、「Schedule a data import」を参照してください。
- [更新] を選択します。
- [完了としてマーク] を選択して、[スケジュール済みインポートジョブを設定] タスクを完了に設定します。