SGC セントラル を使用して オブザーバビリティのサービスグラフコネクタ - Dynatraceを構成する
Dynatrace データを 構成管理データベース (CMDB) にプルするようにスケジュール済みインポートジョブを設定します。
始める前に
必要なロール:次の表は、プレイブックの各ステージに必要なロールを示しています。
| ステージ | ロール |
|---|---|
| 必須条件 | アドミン |
| セットアップ | SGC-Admin (sn_cmdb_int_util.sgc_admin) または admin |
注:
バックグラウンドスクリプトを実行し、SGC-Admin ユーザーにグローバルテーブルへのアクセス権を付与するには、admin ユーザーロールが必要です。サービスグラフコネクタのユーザーロールの詳細については、「サービスグラフコネクタ ユーザーロール」を参照してください。
このタスクについて
オンボーディングコネクタのプレイブックエクスペリエンスは、サービスグラフワークスペースまたは CMDB ワークスペースのSGC セントラルを使用してアクティブ化されます。SGC セントラルアプリケーションを構成するには、「SGC セントラル の構成」を参照してください。プレイブックの操作方法の詳細については、「プレイブックとやり取りする」を参照してください。
手順
-
SGC セントラルを開くには、次のいずれかの方法を使用します。
- 移動先 ワークスペース > サービスグラフワークスペースをクリックし、左側のナビゲーションパネルで [取り込み] アイコン
を選択して SGC セントラル ビューを開きます。
- 移動先 ワークスペース > CMDB ワークスペース > SGC セントラル.
- 移動先 ワークスペース > サービスグラフワークスペースをクリックし、左側のナビゲーションパネルで [取り込み] アイコン
-
[概要] ページで、[接続を作成] を選択します。
ヒント:または、 [すべての接続] ページで [接続を作成] を選択することもできます。
- [接続を作成] ウィンドウで、Dynatrace コネクタタイプを選択し、[接続を設定] を選択します。
-
コネクタを使用して初めて接続を設定するための最初の前提条件を満たします。
- オプション:
イベントの取り込み用に Observability Commons for CMDB アプリケーション (sn_observability) をインストールします。
注:[ Observability Commons for CMDB をインストール] アクティビティは、Observability Commons for CMDB アプリケーション (sn_observability) がまだインストールされていない場合にのみ表示されます。イベントの取り込みが必要ない場合は、[CMDB 用 Observability Commons をインストール] アクティビティで [続行] を選択することで、この手順をスキップできます。
- プレイブックの [ 前提条件 ] ステージで、[ Observability Commons for CMDB をインストール ] アクティビティを選択します。
- ServiceNow Store から Observability Commons for CMDB アプリケーション (sn_observability) をインストールします。
- アプリケーションをインストールしたら、[ 続行] を選択します。
-
接続のデータソースを作成します。
注:この手順は、コネクタを初めて構成する場合にのみ必要です。
- データソース [sys_data_source] テーブルの編集権限があることを確認します。
- プレイブックの [前提条件] ステージで、[データソースアクセスを更新] アクティビティを選択します。
- [ アクセスを更新] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択します。
- アプリケーションピッカーから、コネクタのアプリケーションスコープを選択します。
- [データソースアクセスを更新] アクティビティを完了したら、[続行] を選択します。
-
スケジュール設定済みデータインポートアクセスを更新して、接続のスケジュール済みジョブの作成を有効にします。
注:この手順は、コネクタを初めて構成する場合にのみ必要です。
- 予定されているデータインポート [scheduled_import_set] テーブルの編集権限があることを確認します。
- プレイブックの [ 前提条件 ] ステージで、[ スケジュール設定済みデータインポートアクセスを更新 ] アクティビティを選択します。
- [ アクセスを更新] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択します。
- アプリケーションピッカーから、コネクタのアプリケーションスコープを選択します。
- [ スケジュール設定済みデータインポートアクセスを更新 ] アクティビティを完了したら、[ 続行] を選択します。
-
変数値 access を更新して、接続の値の作成を有効にします。
注:この手順は、コネクタを初めて構成する場合にのみ必要です。
- 値 [sys_variable_value] テーブルの編集権限があることを確認します。
- プレイブックの [ 前提条件 ] ステージで、[ 変数値アクセスを更新 ] アクティビティを選択します。
- [ アクセスを更新] を選択します。
- レコードを編集するには、アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- 新しいタブで表示される [データソース] フォームの [アプリケーションのアクセス] 関連リストで、[作成可能]、[更新可能]、および [削除可能] チェックボックスをオンにします。
- [更新] を選択します。
- アプリケーションピッカーから、コネクタのアプリケーションスコープを選択します。
- [ 変数値アクセスを更新 ] アクティビティを完了したら、[ 続行] を選択します。
-
データソース [sys_data_source] テーブルのキャッシュをクリアします。
注:この手順は、コネクタを初めて構成する場合にのみ必要です。
- プレイブックの [前提条件 (Prerequisites)] ステージで、[キャッシュをクリア (Clear cache)] アクティビティを選択します。
- [キャッシュのクリアを実行 (Run clear cache)] を選択します。
- バックグラウンドスクリプトページの [スクリプトを実行 ] テキストボックスに、次のスクリプトを入力します。
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"); - グローバルスコープでバックグラウンドスクリプトを実行するには、[スクリプトを実行] を選択します。
スクリプトの実行には数分かかる場合があります。
- スクリプトが実行されたら、[ クローズ] を選択します。
- アプリケーションピッカーから、コネクタのアプリケーションスコープを選択します。
- [キャッシュのクリア] アクティビティが完了したら、[続行] を選択します。
-
EvtMgmtImpactManagerMediator スクリプトをグローバルアプリケーションスコープにコピーして、イベント管理 アプリケーションがDynatrace環境で正しく動作することを確認します。
注:このステップは、Observability Commons for CMDB プラグイン (sn_observability) が既にインストールされている場合にのみ表示され、コネクタを初めて構成するときにのみ必要です。
- プレイブックの [ 前提条件 ] ステージで、[ イベント管理のスクリプトアクセスを有効にする ] アクティビティを選択します。
- [ スクリプトアクセスを有効にする] を選択します。
- アプリケーションピッカーから [グローバル] アプリケーションスコープを選択します。
- コンテキストメニューから、[ 挿入と維持] を選択します。
- EvtMgmtlmpactManagerMediator スクリプトがグローバルアプリケーションスコープにコピーされ、[アクセス可能元] フィールドが
[すべてのアプリケーションスコープ] に設定されていることを確認します。 - [更新] をクリックします。
- アプリケーションピッカーから、コネクタのアプリケーションスコープを選択します。
- [ イベント管理のスクリプトアクセスを有効にする] アクティビティを完了したら、[ 続行] を選択します。
- オプション:
イベントの取り込み用に Observability Commons for CMDB アプリケーション (sn_observability) をインストールします。
-
接続の詳細を入力し、Dynatrace データをインポートするための API 接続をテストします。
- プレイブックの [セットアップ (Setup)] ステージで、[接続を作成してテスト (Create and test connection)] アクティビティを選択します。
-
フォームのフィールドに入力します。
表 : 2. [接続を作成してテスト (Create and test connection)] フォーム フィールド 説明 接続名 Dynatrace接続レコードを識別する名前です。 ホスト名 Dynatrace環境のホスト名。 API キー Dynatrace API キー 注:API キーにはプレフィックス api-token を付ける必要があります。 - [接続の作成とテスト (Create and test connection)] を選択します。
- 接続テストが完了したら、[続行] を選択します。
- オプション:
属性をマッピングし、データインポートを管理するための接続とコネクタのプロパティを設定します。
注:この手順をスキップするには、[構成プロパティを設定 (Set configuration properties)] アクティビティで [続行] を選択します。
- プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
-
フォームに入力します。
表 : 3. 構成プロパティ フィールド 説明 管理ゾーン ID Dynatrace 環境からフェッチする管理ゾーン ID のリスト。複数のエントリの場合、ゾーン ID をカンマで区切ります。 管理ゾーン名 Dynatrace 環境からフェッチする管理ゾーンのリスト。複数のエントリでは、ドメインをカンマで区切ります。 サービスタイプ 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
タグ Dynatrace環境からフェッチするタグ名のリスト。複数のエントリでは、タグをカンマで区切ります。 - インポート中にのデータソースエラーを管理するには、[ REST 応答を添付ファイルとして保存 ] チェックボックスをオンにして、各応答を添付ファイルとして一時的に保存します。
- [続行] を選択します。
- オプション:
Dynatrace通知をServiceNowインスタンスでイベントとして有効にするには、ワークフローをトリガーして、Dynatrace環境で問題通知とアラートプロファイルを作成します。
注:このステップは、Observability Commons for CMDB プラグイン (sn_observability) が既にインストールされている場合にのみ表示されます。この手順をスキップするには、[可観測性の構成] アクティビティで [スキップ] を選択します。
- プレイブックの [セットアップ ] ステージで、[ 可観測性の構成 ] アクティビティを選択します。
-
[ 問題通知を作成] を選択します。
注:作成されたレコードは、 Dynatrace アプリケーションに「
ServiceNow default Problem notification (ServiceNow のデフォルト問題通知)」という表示名で表示され、カスタマイズできます。 - 成功アラートをすべて却下し、[ 続行] を選択します。
-
定期的にデータをインポートするようにインポートスケジュールを構成します。
- プレイブックの [セットアップ] ステージで、[インポートスケジュールの構成] アクティビティを選択します。
- [スケジュール済みインポート] リスト内の [スケジュール設定済み親データインポート] を展開して、[ SGO-Dynatrace ホスト - 接続名 ] のインポートスケジュールを選択します。
-
[アクティブ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。
詳細については、「Schedule a data import」を参照してください。
-
[保存] を選択します。
あるいは、[今すぐ実行] を選択してインポートスケジュールをすぐに実行します。
- [続行] を選択します。
- プレイブックの セットアップ ステージで、[ 接続の作成の確認 (Confirm connection creation )] アクティビティを選択して、接続が作成されたかどうかを確認します。
次のタスク
[すべての接続を表示 (View all connections)] を選択して、接続の詳細を確認します。作成された接続が [インストール済み接続 (Installed connections)] リストに表示されます。