サーバ オプション

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」を参照してください。

Splunk AppDynamics コントローラテナントでのアクションの作成

1. Splunk AppDynamics-ServiceNow^® のデータ同期ユーティリティに関する Web UI にログインします。
2. Service Model Integration > Event Integration を選択します。
3. 設定するコントローラテナントを選択します。設定されていない場合は、「データ同期ユーティリティの設定」を参照してください。
4. [Download Template] をクリックします。

ダウンロードしたファイルを使用して、Splunk AppDynamics で HTTP 要求テンプレートを設定します。次に、アクションを作成し、そのアクションを、正常性ルールとアクションを指定するポリシーに適用します。新しいアクションを作成するには、次の手順を実行します。

1. Splunk AppDynamics コントローラテナントの [Alert&Respond] トップメニューに移動します。
2. 左のナビゲーションで、[Alert & RespondHTTP Request Templates] をクリックします。
3. アクションが作成されるリソースを選択します。
4. [New] をクリックして、次のフィールドに入力します。
   1. Name：テンプレートを一意に識別する任意の名前
   2. Request URL
      1. Method： POST
      2. Raw URL：https://<your-instance>.service-now.com/em_event.do?JSONv2&sysparm_action=insertMultiple.<your-instance> を実際のインスタンスの ID に置き換えます。
   3. Authentication
      1. Type：BASIC
      2. 注:

         「ユーザロールと権限」の説明に従って、ServiceNow^® のユーザとロールがすでに設定されていることを確認します。

         「ユーザーロールと権限」の説明に従って、ServiceNow^® のユーザーとロールがすでに設定されていることを確認します。

   4. Payload
      1. MIME Type：application/json
      2. ダウンロードしたファイル event-request-template.txt の内容をコピーし、[Payload] テキスト領域に貼り付けます。
      3. ファイルの最初の行で controllerName を更新します。これは、同期ユーティリティで Splunk AppDynamics コントローラ名を追加するときに設定した値と同じにする必要があります。
5. HTTP テンプレートを保存します。

Splunk AppDynamics コントローラテナントでの正常性ルールの設定

1. [アラートと応答（Alert＆Respond）] タブを選択します。
2. Health Rules を選択します。

3. [選択（Select）] ドロップダウンを使用して、アラートを送信するアプリケーションを選択します。

4. そのアプリケーションに設定済み Health Rules のリストを確認します。必要に応じて、さらに 正常性ルールを追加します。

Splunk AppDynamics コントローラテナントでポリシーを作成して正常性ルールをアクションにバインド

1. Alert & Respond > Policies を選択します。
2. すでに設定済みのポリシーがない場合は、[Create a Policy Manually] を選択します。

3. アラートを受信するシナリオのタイプを選択します。

   警告: すべてのボックスをオンにすると、ServiceNow^® インスタンスのアラートストームが発生する可能性があります。

4. [Save] をクリックします。

5. 正常性ルールでカバーする必要がある階層とノードを定義する正常性ルールを選択し、[Save] をクリックします。

6. [オブジェクトの範囲（Object Scope）] を選択し、このポリシーでカバーされる階層とノードを選択して、[保存（Save）] をクリックします。
7. Actions を選択します。
8. [Add +] 記号をクリックして新しいアクションを作成します。
9. 作成された ServiceNow^® アクションを選択し、[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 エンティティは残ります。