AppDynamics と ServiceNow CMDB およびイベント管理との統合Splunk AppDynamics

サーバ オプション

appdynamics-cmdb-service-$version.zip データ同期ユーティリティファイルをダウンロードして解凍します。

1. appdynamics-cmdb-service-$version.zip ファイルを解凍します。
2. サーバを起動します。

   1. init.d サービス（システム V）

      CODECopy

      sudo ln -s /path/to/appdynamics-cmdb-service/appdynamics-cmdb-service.jar /etc/init.d/appdynamics-cmdb-service sudo /etc/init.d/appdynamics-cmdb-service start

      sudo ln -s /path/to/appdynamics-cmdb-service/appdynamics-cmdb-service.jar /etc/init.d/appdynamics-cmdb-service
      sudo /etc/init.d/appdynamics-cmdb-service start

      Java のオプションは $HOME/appdynamics-cmdb-service.conf ファイルで設定できます。

      アプリケーションログは $HOME/logs ディレクトリに作成されます。

      システム出力ログは、 /var/log/appdynamics-cmdb-service.log ファイルに作成されます。

   2. Windows （winsw）：

      ターミナルを開き、zip ファイルを解凍した appdynamics-cmdb-service フォルダに移動します。

      CODECopy

      cd C:\Path-to\appdynamics-cmdb-service

      cd C:\Path-to\appdynamics-cmdb-service

      以下のコマンドを実行します：

      CODECopy

      javaw -jar appdynamics-cmdb-service.jar

      javaw -jar appdynamics-cmdb-service.jar

      Java のオプションは %$HOME%/bin/appdynamics-cmdb-service-win.xml ファイルで設定できます。

      ログは $HOME/logs ディレクトリに作成されます。

   3. その他のプラットフォーム

      CODECopy

      java -Xms512m -jar /path/to/appdynamics-cmdb-service.jar

      java -Xms512m -jar /path/to/appdynamics-cmdb-service.jar

      アプリケーションログは $HOME/logs ディレクトリに作成されます。

アップグレード

1. Java 同期ユーティリティがインストールされているデータディレクトリ data/ をバックアップします。

2. 既存のインストールを新しいファイルで上書きします。

セットアップ

1. init.d サービス：構成ファイルは、$HOME/appdynamics-cmdb-service.conf にあります。パラメータを JAVA_OPTS プロパティに追加します。
2. Windows サービス：構成ファイルは $HOME/bin/appdynamics-cmdb-service-win.xml にあります。パラメータを <arguments> プロパティに追加します。
3. jar：-jar ... の前のコマンドにパラメータを直接追加します。

オプション

• 次のように異なるポートを使用します。

  CODECopy

  -Dserver.port=8080

  -Dserver.port=8080

• 次のように認証を有効化します。

  CODECopy

  -Dplatform.security.enabled=true # This will create a local login with the following credentials. -Dplatform.username=user -Dplatform.password="deFAultPwd4P1atfrm" -Dplatform.security.encryption-key=mykey -Dplatform.security.encryption-salt=mysalt

  -Dplatform.security.enabled=true  # This will create a local login with the following credentials.
  -Dplatform.username=user
  -Dplatform.password="deFAultPwd4P1atfrm"
  -Dplatform.security.encryption-key=mykey
  -Dplatform.security.encryption-salt=mysalt

  警告: encryption-key と encryption-salt はオプションです。

ノードからサーバ CI への調整によって ServiceNow® に入力されたフィールド

適切なサーバークラス（cmdb_ci_*_server）で、親 Splunk AppDynamicsノードに関連付けられている場合：

レポートされる各ネットワークアダプタには、ネットワークアダプタ CI（cmdb_ci_network_adapter）と関連する親サーバ CI が入力されます。

必須フィールドへの静的な値の追加

Splunk AppDynamics が入力されていない CMDB に必須フィールドがある場合は、[CMDB Additional Fields] を使用して、テーブルごとに複数の静的な値を追加できます。

1. Splunk AppDynamics-ServiceNow^® の同期ユーティリティに移動します。
2. [Settings] を選択します。
3. [CMDB Additional Fields] を選択します。
4. 目的の CI テーブルで、[Add Field] をクリックします。
5. ServiceNow^® の Field Name（ラベルではありません）を入力します。
6. このタイプのすべてのレコードに入力する静的な値を入力します。たとえば、hardware_status フィールド（すべての cmdb_ci_server および子クラスレコード）に入力する必要がある場合は、「hardware_status」と入力してから「Installed」を入力します。
7. [Save] をクリックします。

動的なアプリケーション環境に関する考慮事項

Splunk AppDynamics を使用してモニタしているアプリケーション環境が頻繁に変更される場合は、アプリケーショントポロジの現在の状態を反映していない ServiceNow^® CMDB 内のアーティファクトが存在する可能性があります。

これに対処するため、ServiceNow^® では、無関係の Splunk AppDynamics CI を削除できなくなるように、CMDB で「データ更新ルール」を設定する方法についてのマニュアルを提供しています。New York リリースの場合は、「Create data refresh rules」を参照してください。

Create an Action on the Splunk AppDynamics Controller Tenant

1. Log in to the web UI for the Splunk AppDynamics-ServiceNow^® Data Sync Utility.
2. Select Service Model Integration > Event Integration.
3. Select the Controller Tenant you would like to configure. If one is not configured, see Data Sync Utility Configuration.
4. Click Download Template.

Use the downloaded file to configure the HTTP Request template in Splunk AppDynamics. You will then create an Action and apply that action to a policy that specifies a health rule and action. To create the new Action:

1. Navigate to the Alert&Respond top menu in your Splunk AppDynamics Controller Tenant.
2. Click Alert & Respond > HTTP Request Templates in the left navigation.
3. Select the resource on which the action is to be created.
4. Click New and fill out the following fields:
   1. Name: Any name to uniquely identify the template
   2. Request URL
      1. Method: POST
      2. Raw URL: https://<your-instance>.service-now.com/em_event.do?JSONv2&sysparm_action=insertMultiple. Replace <your-instance> with the id of the actual instance.
   3. Authentication
      1. Type: BASIC
      2. Note:

         Ensure you have already configured the ServiceNow^® User and Roles as described in User Roles and Permissions.

   4. Payload
      1. MIME Type: application/json
      2. Copy the contents from the downloaded file, event-request-template.txt, and then paste it in the Payload text area
      3. Update the controllerName in the first line of the file. It must be the same value that you set while adding the Splunk AppDynamics Controller Name in the Sync Utility.
5. Save the HTTP Template.

Configure Health Rules on the Splunk AppDynamics Controller Tenant

1. Select the Alert & Respond tab.
2. Select Health Rules.

3. Use the Select dropdown to choose an application on which you want to alert.

4. Review the list of Health Rules configured out-of-the-box for that application. Add more Health Rules if needed.

Create a Policy on the Splunk AppDynamics Controller Tenant to Bind Health Rules to Actions

1. Select Alert & Respond > Policies.
2. Select Create a Policy Manually if there are no policies configured already.

3. Select the type of scenarios on which you want to receive alerts.

   Warning: Checking all the boxes might lead to an alert storm on your ServiceNow^® instance.

4. Click Save.

5. Select the Health Rule Scope defining which tiers and nodes the Health Rule should cover and click Save.

6. Select the Object Scope and choose the Tiers and Nodes to be covered in this policy and click Save.
7. Select Actions.
8. Click Add + sign to create a new Action.
9. Select the ServiceNow^® Action you created and click Save.

バージョン

• Splunk AppDynamics 21.10 以降。
• 同期する ServiceNow^® インスタンスは、Quebec、Rome、San Diego、または Tokyo を実行している必要があります。

新たなロール

• Splunk AppDynamics のサービスアカウントに追加のロールは必要ありません。
• ServiceNow^® のサービスアカウントにも app_service_admin ロールが必要です。

すでに同期されているアプリケーション

20.7 以降のバージョンを使用している場合、同期はそのまま 21.12.1 に残ります。

バージョン 3.1 以前のバージョンを使用している場合、以前のバージョンの同期ユーティリティから ServiceNow^® CMDB に同期された既存の Splunk AppDynamics モニター対象アプリケーションと関連エンティティは、CMDB に残ります。同じアプリケーションが 21.12.1 を使用して再同期されると、設定されたアプリケーション（または階層）に対して計算されたサービス CI が作成されます。「計算済みアプリケーションサービス CI の作成」を参照してください。

既存の手動エントリポイント

Splunk AppDynamics モニター対象アプリケーション CI を使用してアプリケーションサービス CI の手動エントリポイントを作成した場合、x_apd_appdynamics_application はそのまま残ります。同期ユーティリティ v21.12.1 を使用して同期した後、新しい計算済みアプリケーションサービス CI が関係に追加されます。

推奨

Splunk AppDynamics では、以前に作成したエントリポイントをすべて削除し、新しい計算済みアプリケーションサービス cmdb_ci_service_calculated CI に手動エントリポイントを作成することを推奨しています。手順

1. 既存の手動エントリポイントを削除するには、次の手順を実行します。
   1. イベント管理でモニタリングしている Application Service CI を開きます。
   2. Manually Added CI リンクの横にある - をクリックし、Remove をクリックします。
2. 計算済みアプリケーションサービスに対して手動エントリポイントを追加します。
   1. ServiceNow^® でモニタリングしているアプリケーションサービス CI を開きます。
   2. Add Entry Point をクリックします。
   3. Manually Created を選択します。
   4. CI Type の場合は、Calculated Application Service を選択します。
   5. [CI Name] で、同期したアプリケーションの名前を選択します。

ServiceNow^® でアプリケーションサービスとしてモニターする階層の選択

デフォルトでは、Splunk AppDynamics コントローラテナントによってモニターされるすべてのアプリケーションは、Used By::Depends On 関係を使用して 21.12.1 と初めて同期するときに、新しく計算されたアプリケーションサービスに関連付けられます。

モニター対象階層を ServiceNow^® で計算済みアプリケーションサービス CI に同期するには、次の手順を実行します。

1. Application Mappings にアクセスします。

2. コントローラテナントが存在しない場合は追加します。または、ドロップダウンからコントローラテナントを選択します。選択したコントローラテナント UI のすべての Splunk AppDynamics モニター対象アプリケーションのリスト。

3. モニター対象アプリケーションの各階層を計算済みアプリケーションサービス CI にマッピングするには、そのアプリケーションをアプリケーショングループとして適切なバケットに移動します。

ServiceNow® でのアプリケーションサービスの同期

ServiceNow^® では、各計算済みアプリケーションサービス CI（cmdb_ci_service_calculated）に一意の名前が必要です。バージョン 20.7 以降を使用して初めて同期すると、次の命名規則で新しい計算済みアプリケーションサービス CI が作成されます。

• デフォルトでは、各モニター対象アプリケーションには、次の名前の計算済みアプリケーションサービス CI があります。

  • AppD：AppNameGoesHere（controllerName）

• アプリケーションがアプリケーショングループとして指定されている場合、各モニタ対象階層には次の名前の計算済みアプリケーションサービス CI があります。

  • AppD：AppnameGoesHere:TierNameGoesHere（controllerName）

Splunk AppDynamics アプリケーションと ServiceNow® 計算済みアプリケーション CI のダッシュボード

[View Mapped Applications] ダッシュボードを使用して、Splunk AppDynamics アプリケーション（および階層）と ServiceNow^® 計算済みアプリケーション CI との間のマッピングを表示します。

ServiceNow^® からマッピングを削除するには、赤い [X] をクリックしてこのパネルからマッピングを削除します。これにより、計算済みアプリケーション CI と表示される関係の両方が削除されます。CMDB 内の Splunk AppDynamics エンティティは残ります。