[AppDynamics Agents] ページから、コントローラに接続されているアプリケーション エージェントを管理、リセット、および無効化し、エージェントのステータスと情報を表示できます。
アクセス権
アプリケーション エージェントを管理するには、次のアカウントレベルの権限を持つロールに属している必要があります。
- 管理ユーザ、グループ、ロール、認証など。
- ライセンスの表示
- AppDynamics エージェントの表示
- エージェント ダウンロード ウィザードの使用
事前定義済みのアカウント所有者ロールには、必要な権限が含まれています。
アプリケーション エージェント管理の設定にアクセスするには、[Settings]（
）> [ AppDynamics Agents ] > [ App Server Agents] の順にクリックします。
アプリケーションエージェントとビジネスアプリケーションの関連付け
ビジネスアプリケーションを指定せず、アプリケーションエージェントを使用してアプリケーションサーバーを起動すると、エージェントは アプリケーションサーバーエージェント タブに、関連付けされていないエージェントとして表示されます。エージェントを手動でアプリケーションに関連付けることができます。
アプリケーションサーバーエージェント タブのエージェントリストから、関連付けされていないアプリケーションエージェントを選択します。
[View] メニューで、[Agents not associated with an Application ] をクリックしてアプリケーション サーバ エージェントのリストをフィルタリングします。
- [Associate with Application] をクリックします。このボタンは、コントローラに接続されていて、ビジネスアプリケーションに関連付けられていないアプリケーション エージェントでのみ有効になります。
アプリケーションエージェントのリセット
アプリケーション エージェントをリセットするには、ユーザが「Agent Advanced Operation」権限を持っている必要があります。
アプリケーション エージェントをリセットすると、エージェントは、JVM またはアプリケーションの起動時と同じ方法で自身をコントローラに登録しますが、JVM やアプリケーションは再起動しません。アプリケーション エージェントのリセットでは、エージェントのメモリ内データが消去されます。また、特定の構成変更（アプリケーション エージェント ノードのプロパティの変更など）もアプリケーション エージェントに適用します。
アプリケーションエージェントをリセットすることで、コントローラは、
- メモリ内のビジネストランザクションやメトリック、終了コール、登録情報など、エージェントのデータを消去
- 選択したエージェントのビジネストランザクション制限カウンタをゼロにリセット
エージェントをリセットしても、既存のインストゥルメンテーションは再インストゥルメント化や削除はされません。リセット後、エージェントはビジネストランザクションとバックエンドを再登録し、新しいメトリックを作成します。リセット操作と再登録操作の間の数分間については、データが失われる場合があります。
ビジネストランザクションやバックエンド検出を再構成した後、エージェントが更新されたルールを使用していない場合は、エージェントをリセットする必要があります。
- 既存のすべてのトランザクションとバックエンドを削除します。不要なビジネストランザクションの削除に関する情報については、「トランザクション検出ルール」、「データベースのモニタリング」、および「リモートサービス」を参照してください。
- リセットオプションを選択。
- ビジネスアプリケーション用のアプリケーション エージェントをすべてリセットするには、[Reset Agents] をクリックします。
- 個々のアプリケーション エージェントを無効にするには、1 つ以上のエージェントを選択し、次をクリックします。Reset Selected App Agent(s).
アプリケーションエージェントの有効化／無効化
アプリケーションエージェントを無効にすると、エージェントはコントローラに対するメトリックの報告を停止します。エージェントを無効にすると、エージェントのインストールまたはアプリケーション問題を診断することができます。また、エージェントを削除せずに、データをキャプチャする時としない時の間のオーバーヘッドの違いを比較することもできます。エージェントを無効にしても、アプリケーションサーバーをシャットダウンまたは再起動する必要はありません。
アプリケーションエージェントを無効にしても、エージェントの操作が中断されたり、エージェントが追加したバイトコードインストゥルメンテーションは削除されません。バイトコード インストゥルメンテーションの削除を含めエージェントを完全に削除するには、エージェントタイプそれぞれの「アプリケーションサーバーエージェントのインストール」ページで説明されている、アプリケーション エージェントのアンインストールまたはエージェント インストゥルメンテーションの完全無効化の手順に従います。この方法でアプリケーション エージェントをアンインストールしたり完全に無効化したりする場合、通常アプリケーションの再起動が必要になります。
コントローラに接続されているすべてのエージェントは、そのコントローラのエージェントライセンス制限に関してカウントされます。最小限のアプリケーションサーバ関連データを報告する場合でも、無効化されたアプリケーション エージェントはコントローラに接続されていて、アプリケーション エージェント ライセンスを消費します。
ビジネスアプリケーション用のアプリケーション エージェントをすべて有効化または無効化するには、[App Server Agents] タブで [Enable Agents ] または [ Disable Agents] をクリックします。
権限：
エージェントを有効および無効にするには、アプリケーションレベルの権限 Configure Agent Properties が必要です。
個々のエージェントを有効化または再有効化するには、エージェントを選択して、[Enable Selected App Agent] または [Disable Selected App Agent] をクリックします。または、ノードダッシュボードの [Agents] タブで個々のアプリケーション エージェントを有効化または無効化します。
- エージェントを無効にするには、[Agent is Off] をクリックします。
- エージェントを有効にするには、[Agent is On] をクリックします。
実施されるのに1分ほどかかります。
デフォルト設定では、エージェントを完全に Off にすると、モニタリングが無効になります。Java エージェントの場合、[Disable This App Agent] ペインの [Disable all monitoring including JVM and JMX metrics] をオフにしても、ヒープメモリ、メモリプール、ガベージコレクション、スレッド数などの JVM および JMX メトリックの収集を続行します。
アプリケーションエージェントの削除
アプリケーションエージェントを削除すると、コントローラデータベースにある関連データやエージェントが削除されます。これはアプリケーションサーバーのインストゥルメンテーションには影響しません。アプリケーションサーバーがアプリケーションエージェントを使用して稼働中の場合や、アプリケーションエージェントを使用して再起動される場合、エージェントは再登録され、コントローラに再び表示されます。
[Delete Agent from System] をクリックすると、アプリケーション エージェントを削除できます。
アプリケーションエージェントを完全に削除して再登録されないようにするには、アンインストールしてください。「アプリケーションサーバーエージェントのインストール」でエージェント プラットフォームのアンインストール手順を参照してください。
