Java エージェントによる Azure Spring Cloud のモニタ

Splunk AppDynamics Java エージェントは、Azure Spring Cloud で実行されているワークロードをモニターするために役立ちます。サービス間のデータフローとアプリケーションのトポロジを可視化するには、Azure Spring Cloud アプリケーションを構成するサービスで Splunk AppDynamics Java エージェントをアクティブにします。

Splunk AppDynamics Java エージェントでは、Azure Spring Cloud アプリケーション内の遅いトランザクションまたはエラートランザクションの根本原因分析も行われます。

Splunk AppDynamics Java エージェントにより、ガベージコレクション情報と、Azure Spring Cloud アプリケーション内のサービスの JVM メモリ使用率が提供されます。

前提条件

Splunk AppDynamics を使用して Spring Cloud のワークロードをモニターするために、Azure Spring Cloud アプリケーションでエージェントを使用できます。これを行うには、次の手順を実行します。

• Splunk AppDynamics アカウントの作成
• Azure CLI をインストールします。手順については、「Azure CLI のインストール方法」を参照してください。

制限

Splunk AppDynamics Java エージェントは、Azure Spring Cloud 環境内の読み取り専用アーティファクトとして展開されます。これにより、Java エージェントを介して使用できる機能が制限されます。制限事項は次のとおりです。

• ファイル（controller-info.xml、 agent. properties）によるエージェント構成は使用できません。
• ファイル（log4j2.xml）によるエージェントのログレベルの構成は使用できません。
  
• XML ファイルによるカスタム相関構成は使用できません。
  

Azure Spring Cloud での Java エージェントの使用

次の 2 つの方法で、Azure Spring Cloud アプリケーションで Java エージェントをアクティブにできます。

• Azure CLI を使用した Cisco AppDynamics Java インプロセスエージェントのアクティブ化
• Azure ポータルを使用した Cisco AppDynamics Java インプロセスエージェントのアクティブ化

Azure CLI を使用した Splunk AppDynamics Java インプロセスエージェントのアクティブ化

1. Azure Spring Cloud のインスタンスを作成します。

2. アプリケーションを作成します。

   ```shell
   az spring-cloud app create --name "appName" --is-public true \
   -s "resourceName" -g "resourceGroupName"```

   CODE
3. Splunk AppDynamics エージェントと環境変数を使用して展開を作成します。

Splunk AppDynamics に接続し、要件に応じて他の変数をカスタマイズするには、APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY、APPDYNAMICS_AGENT_ACCOUNT_NAME、および APPDYNAMICS_CONTROLLER_HOST_NAME にアクセスする必要があります。

```shell
az spring-cloud app deploy --name "appName" --jar-path app.jar \
-s "resourceName" -g "resourceGroupName" \
--jvm-options="-javaagent:/opt/agents/appdynamics/java/javaagent.jar" \
--env APPDYNAMICS_AGENT_APPLICATION_NAME=<YOUR_APPLICATION_NAME> \
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=<YOUR_AGENT_ACCESS_KEY> \
APPDYNAMICS_AGENT_ACCOUNT_NAME=<YOUR_AGENT_ACCOUNT_NAME> \
APPDYNAMICS_AGENT_NODE_NAME=<YOUR_AGENT_NODE_NAME> \
APPDYNAMICS_AGENT_TIER_NAME=<YOUR_AGENT_TIER_NAME> \
APPDYNAMICS_CONTROLLER_HOST_NAME=<YOUR_APPDYNAMICS_CONTROLLER_HOST_NAME> \
APPDYNAMICS_CONTROLLER_SSL_ENABLED=true \
APPDYNAMICS_CONTROLLER_PORT=443

Azure Spring Cloud は、次のパスに Splunk AppDynamics Java エージェントをプリインストールします。/opt/agents/appdynamics/agent/javaagent.jar.

Azure ポータルを使用した Splunk AppDynamics Java インプロセスエージェントのアクティブ化

1. Azure ポータルで、左側のナビゲーションウィンドウの [Settings > Apps] をクリックして、モニタするアプリケーションを見つけます。
2. アプリケーションをクリックして、[Configuration] ページに移動します。
3. 左側のナビゲーションウィンドウの「Configuration」をクリックして、「Environment variables」タブのアプリケーションの環境変数を追加、更新、または削除します。

4. [General settings] をクリックして、[General settings] タブでアプリケーションの JVM オプションを追加、更新、または削除します。

   -javaagent:/opt/agents/appdynamics/java/javaagent.jar

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

6. [Restart] をクリックして構成が完了したことを確認します。

環境変数またはシステムプロパティを使用した構成

次の環境変数を使用して、Azure Spring Cloud アプリケーションでエージェントを使用するようにセットアップを構成できます。

次のシステムプロパティも使用できます。

これらのシステムプロパティの詳細については、「Javaエージェント構成プロパティ」を参照してください。アカウントとアカウントアクセスキーを見つけるには、「エージェントとコントローラの接続」を参照してください。

Splunk AppDynamics エージェントのログ

デフォルトでは、Azure Spring Cloud は Splunk AppDynamics エージェントの情報レベルのログを STDOUT に出力します。このログはアプリケーションログと混合されます。アプリケーションログから明示的なエージェントのバージョンを確認できます。

You cannot configure the controller-info.xml. したがって、,デバッグログを取得するには、ASC 内のアプリケーションでのログレベルの環境変数を設定してから、アプリケーションを再起動する必要があります。

ASC ログをキャプチャするためのコマンドを実行するには、「az spring-cloud app log」を参照してください。