サーバ オプション

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

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

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

      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 フォルダに移動します。

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

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

      javaw -jar appdynamics-cmdb-service.jar

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

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

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

      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 ... の前のコマンドにパラメータを直接追加します。

オプション

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

  -Dserver.port=8080

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

  -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.

         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 ロールが必要です。

Already Synchronized Applications

If you are using a version >= 20.7, the synchronization will remain as-is in 21.12.1.

If you are using a version <= 3.1, existing Splunk AppDynamics monitored applications and related entities that have been synchronized to a ServiceNow^® CMDB from previous versions of the Sync Utility will remain in the CMDB. When the same application is re-synchronized using 21.12.1, a calculated service CI is created for those applications (or tiers) as configured. See Creating Calculated Application Service CIs.

Existing Manual Entry Points

If you created manual entry points for Application Service CIs using Splunk AppDynamics monitored application CIs x_apd_appdynamics_application will remain as-is. After synchronizing using Sync Utility v21.12.1, a new calculated application service CI will be added to the relationships.

Recommendation

Splunk AppDynamics recommends that you remove any previously created entry points and create a manual entry point to the new Calculated Application Service cmdb_ci_service_calculated CI. To do this:

1. To remove the existing manual entry point:
   1. Open the Application Service CI you are monitoring with Event Management
   2. Click - next to the Manually Added CI link and click Remove.
2. Add a manual entry point for the calculated application service:
   1. Open the application service CI you are monitoring in ServiceNow^®.
   2. Click Add Entry Point.
   3. Select Manually Created.
   4. For CI Type, select Calculated Application Service.
   5. For CI Name, select the name for the application you synched.

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 エンティティは残ります。