View and Manage Agent Details

When you click Manage Agents, you can view the following Agent details:

App Server Agents
Machine Agents
Smart Agents
Database Agents
Analytics Agents
Network Visibility Agents
Cluster Agents
Note: You cannot manage Analytics Agents, Network Visibility Agents, and Cluster Agents using Smart Agent or Smart Agent CLI. Therefore, you cannot install, upgrade, or rollback these agents from the Agent Management UI.

Agent Management UI with collapsible right pane On the right pane you can view details of the agents that require an upgrade.

The Agent Management page provides the following details:

Agents
Tasks in Progress
History
Config Management
Processes
Deployment Groups

Agents

This displays all agents with the inventory details. The following sections include the agent details and actions that you can perform on the respective agents:

アプリサーバーエージェント
Machine Agents
スマートエージェント
Database Agents
Analytics エージェント
ネットワークの可視性エージェント
クラスタエージェント

Note: If you have not installed Smart Agent, the Smart Agent ID and Managed columns will not display any value.

アプリサーバーエージェント

インベントリ


Name	説明
Version Status	アプリケーションが実行されているエージェントのバージョンステータスを表示します。 [Latest] アイコンは、対応するデータベースエージェントが最新バージョンを実行していることを示しています。 [Out of Date] アイコンは、対応するデータベースエージェントのバージョンがサポートされていないことを示しています。 [Update Available] アイコンは、対応するスマートエージェントのバージョンが最新ではないため、更新する必要があることを示しています。 [Unknown] アイコンは、バージョンが不明であることを示しています。マシンがネットワークに接続されていないか、マシンがダウンしている可能性があります。
タイプ	Java、Python、Node、Webserver、Dotnet などのエージェントのタイプ。
Version	エージェントの現在のバージョン。
スマートエージェント ID	対応するアプリケーションエージェントを管理するスマートエージェントの ID。値が表示されない場合、スマートエージェントはインストールされていません。
一意のホスト ID	エージェントが実行されているホストの一意の ID。
管理対象	エージェントがスマートエージェントによって管理されている場合、値は [Yes] になり、エージェントがスマートエージェントによって管理されていない場合は [No] になります。
アプリケーション	対応するエージェントが実行されているアプリケーション。
階層	対応するアプリケーションで実行されているサービス。
ノード	アプリケーションで実行されているサービスのサービスインスタンス。
モニタリングステータス	対応するエージェントのモニタリングが有効になっている場合、値は有効になります。対応するエージェントのモニタリングが無効になっている場合、値は無効になります。
すべてのモニタリングが無効	関連付けられているアプリケーションのモニタリングを非アクティブ化します。

アクション


[アクション]メニュー	説明
ノードダッシュボードの表示	必要なノードの [NodesTier]ダッシュボードを表示します。特定のエージェントの横にあるチェックボックスをクリックし、[View Node Dashboard] をクリックします。
フィルター	要件に基づいてフィルタリングします。[FiltersAdd Criteria] をクリックします。 [Filters] を使用し、要件に基づいてさまざまなフィルタ条件を追加します。たとえば、古いバージョンのすべての Java エージェントを表示するには、次の手順を実行します。をクリックします。 Filters > Add Criteria > . [Agent Type] を選択します。ドロップダウンから、[Java Agent] を選択します。 [Done] をクリックします。バージョンの別の条件を追加するには、[Add Criteria] をクリックします。 Version Status を選択します。 [Version Status] ドロップダウンをクリックし、[Out of Date] を選択します。リストを簡単に表示する場合は、[Apply] をクリックします。これを閉じて、この条件を使用しないようにできます。ただし、[Done] をクリックすると、リストのフィルタリングに基準が使用されます。
オプションの表示	ページに表示する列を設定します。要件に応じて、[View options] メニューから任意の数の列を選択または選択解除できます。
モニタリングの有効化	選択したエージェントをアクティブにします。必要なエージェントを選択し、[Enable] をクリックします。 [Monitoring Status] は [Enabled] として表示されます。
モニタリングの無効化	選択したエージェントを非アクティブにします。必要なエージェントを選択し、[Disable] をクリックします。 [Monitoring Status] は [Disabled] として表示されます。
設定	選択したエージェントのノードプロパティを設定します。エージェントを選択し、[Configure] をクリックします。
アップグレード	選択したエージェントをアップグレードします。必要なエージェントを選択し、[Upgrade] をクリックします。
削除	選択したエージェントを削除します。削除するエージェントを選択し、[Delete] をクリックします。
Reset	エージェントのリセットは、JVM/CLRのスタートアップ時と同じ方法でエージェントをコントローラに登録するように強制する方法ですが、JVM/CLRを再起動することはありません。VM の場合で、エージェントが自動リーク検出またはカスタムメモリ構造機能を使用してコレクションをモニターしている場合、リセットすると、これらのモニター対象のコレクションがクリアされます。モニタリングを再開するには、JVMを再起動する必要があります。
アクション	次のアクションを実行します。一括で有効にするアプリケーションを選択一括で無効にするアプリケーションを選択一括でリセットするアプリケーションを選択以前のバージョンへのロールバックグリッドデータのエクスポート
表データのエクスポート	表データを CSV 形式でエクスポートします。使用可能なすべてのアプリケーションエージェントの詳細が表示されます。Export Grid Data をクリックします。

Machine Agents

Inventory


Name	Description
Version Status	Displays the version status of the agents on which the application is running. The Latest icon represents that the corresponding agent type is running the latest version. The Out of Date icon represents that the corresponding agent type has a version which is no longer supported. The Update Available icon represents that the corresponding agent type has a version that is not the latest, hence requires to be updated. The Unknown icon represents that the version is unknown. It can be because the machine is not connected to the network or the machine is down.
Version	The current version of the Machine agent.
Smart Agent ID	The ID of the Smart Agent that manages the corresponding Machine agent. If the value is not displayed, then Smart Agent is not installed.
Unique Host ID	The unique ID of the host on which the agent is running.
Managed	The value can be Yes if the Smart Agent is installed and No if the Smart Agent is not installed.
Extensions	The number of monitoring extensions that are installed. To view the status and details, select the required agent and view its details. The extension version is extracted from the `monitor.xml` file, if the <version> xml tag is available. If the <version> tag is unavailable, the version is set to: the same version as the Machine Agent version for the default extensions (those packaged by default with the Machine Agent artifact. Therefore, the version is always the same as the Machine Agent version. These versions are upgraded when you upgrade the Machine Agent). unknown for the custom extensions (created or available in the community and added into the Machine Agent monitors directory so the version can be variable and will depend on what is provided in the extension itself.
Application	The application on which the corresponding agent is running.
Monitoring Status	The value is enabled if monitoring is enabled for the corresponding agent. The value is disabled if the monitoring is disabled for the corresponding agent.

Actions

You can select the required Network Visibility Agent and perform the following actions:


Action Menu	Description
Details	To view the summary of the selected Machine Agent. You can click the checkbox next to a specific agent, then click Details.
Filters	To filter based on your requirement, click Filters. You can use Filters to add different filter criteria based on your requirement.
View Options	To configure the columns that you want to view on the page. Based on your requirement, you can select or deselect any number of columns from the View options menu.
Enable Monitoring	To enable monitoring for the selected agents, select the required agents, then click Enable.
Disable Monitoring	To deactivate monitoring for the selected agents, select the required agents, then click Disable.
Configure	To configure the node properties of the selected agent., select the agent, then click Configure.
Upgrade	To upgrade the selected agents, select the required agents, then click Upgrade.
Delete	To delete the selected agents, select the required agents, then click Delete.
Reset	Resetting the Agent is a way to force the agent to register itself with the Controller in the same way it does at JVM/CLR startup, but without restarting the JVM/CLR. In the case of JVMs, if the agent is monitoring Collections using the Automatic Leak Detection or Custom Memory Structure feature, then resetting it will clear out these monitored Collections. The JVM will need to be restarted in order to start monitoring them again.
Actions	To perform the following actions: Select applications to bulk enable Select applications to bulk disable Select applications to bulk reset Rollback to previous version Export grid data
Export Grid Data	To export the grid data in CSV format, click Export Grid Data. It provides the details of all the available machine agents.

スマートエージェント

インベントリ


Name	説明
Version Status	アプリケーションが実行されているスマートエージェントのバージョンステータスを表示します。 [Latest] アイコンは、対応するスマートエージェントが最新バージョンを実行していることを示しています。 [Out of Date] アイコンは、対応するスマートエージェントのバージョンがサポートされていないことを示しています。 [Update Available] アイコンは、対応するスマートエージェントのバージョンが最新ではないため、更新する必要があることを示しています。 [Unknown] アイコンは、バージョンが不明であることを示しています。マシンがネットワークに接続されていないか、マシンがダウンしている可能性があります。
Version	スマートエージェントのバージョン。
スマートエージェント ID	エージェントを管理するためにホストマシンにインストールされているスマートエージェントの ID。
Hostname	対応するスマートエージェントが実行されているマシンのホスト名。
アプリケーション	対応するスマートエージェントを使用しているアプリケーションの数。
Deployed Agents	展開されたエージェントの数（アプリケーションサーバーエージェントまたはマシンエージェント）
アクティブ	スマートエージェントのアクティブステータス。スマートエージェントが実行されている場合、値は [true] です。スマートエージェントがアクティブになっていない場合、最後にアクティブだった時刻が表示されます。たとえば、スマートエージェントを終了した場合、`15` 分後の値には `15` 分前にアクティブだったと表示されます。

アクション


[アクション]メニュー	説明
詳細	選択したスマートエージェントがインストールされているアプリケーションの概要を表示します。概要には、アプリケーション名と展開されたエージェントの数が含まれます。特定のスマートエージェントの横にあるチェックボックスをクリックし、[Details] をクリックします。
フィルター	要件に基づいてフィルタリングします。[FiltersAdd Criteria] をクリックします。 [Filters] を使用し、要件に基づいてさまざまなフィルタ条件を追加します。タグに基づいてエンティティをフィルタリングできます。
オプションの表示	ページに表示する列を設定します。要件に応じて、[View options] メニューから任意の数の列を選択または選択解除できます。タグ機能を有効にすると、ページに列として追加するタグを表示して選択でき、カスタムタグを使用してリストをフィルタリングするのに役立ちます。タグを有効にするには、タグを参照してください。
アップグレード	選択したスマートエージェントをアップグレードします。必要なスマートエージェントを選択し、[Upgrade] をクリックします。この機能は現在デフォルトで無効に設定されています。詳細については、カスタマーサポートにお問い合わせください。
表データのエクスポート	表データを CSV 形式でエクスポートするには、[Export Grid Data] をクリックします。使用可能なすべてのマシンエージェントの詳細が表示されます。

タグ機能は、スマートエージェントを使用してサポートされているエージェントをインストールするとサポートされます。タグを使用して、[Machine Agents]、[App Server Agents]、[Smart Agents]、および [Database Agents] でリストをフィルタ処理できます。

エージェント管理 UI で、サポートされているエージェントの [View Options] または [FiltersAdd Criteria] でタグを有効にして表示するには、以下の手順を実行する必要があります。

タグの有効化
この機能を使用するには、カスタマーサポートに連絡して、管理コンソールで entity.tagging.enabled アカウントレベルプロパティを true に設定してもらいます。デフォルトでは、このプロパティは無効になっています。詳細については、「カスタムタグ付けの有効化」を参照してください。

スマートエージェント config.ini を更新します。

config.ini ファイルの共通設定セクションの下にタグを追加します。

こちらは所有者と場所のタグを追加した構成例です。

[CommonConfig]
            ServiceName           =
            ServiceNamespace      =
            RequestTimeoutSeconds = 0
            AgentName             =
            PollingIntervalInSec  =
            Tags				  = "owner=abc;location=blr"

スマートエージェントを起動します。
スマートエージェントを再起動するには、次のコマンドを実行します。
```
sudo systemctl restart smartagent
```
タグを表示します。
[View options] に移動してタグを列として表示するか、またはタグをフィルタ内で使用します。

Database Agents

Inventory


Name	Description
Version Status	Displays the version status of the agent on which the application is running. The Latest icon represents that the corresponding Database Agent is running the latest version. The Out of Date icon represents that the corresponding Database Agent has a version that is no longer supported. The Update Available icon represents that the corresponding Database Agent has a version that is not the latest, hence requires to be updated. The Unknown icon represents that the version is unknown. It can be because the machine is not connected to the network or the machine is down.
Agent Name	The name of the Database Agent.
Agent Version	The current version of the Database Agent.
Availability	Indicates if the Database Agent is active or inactive.
Up Time	Amount of time that the Database Agent is running without any issues.
Smart Agent ID	The ID of the Smart Agent that manages the corresponding Database Agent. If the value is not displayed, then Smart Agent is not installed.
Architecture	Displays the architecture of the operating system.
Unique Host ID	The unique ID of the host on which the Database Agent is running.
As Service	Displays one of the following options: Yes: indicates that the Database Agent is running as a service. No: indicates that the Database Agent is running as a non-service NA: this option is displayed when the Database Agent is running on Linux. Upgrade: this option is displayed if the Database Agent version is lower than 25.9.0. You must upgrade to Database Agent 25.9.0 or greater to view the content of this column.
Managed	The value is Yes if the Smart Agent is installed and No if the Smart Agent is not installed.

Actions


Action Menu	Description
Filters	To filter based on your requirement. Click Filters > Add Criteria. You can use Filters to add different filter criteria based on your requirement.
View Options	To configure the columns that you want to view on the page. Based on your requirement, you can select or deselect any number of columns from the View options menu.
Upgrade	To upgrade the selected Database Agents. Select the required agents, then click Upgrade.
Add Collector	Select the Database Agent for which you want to create a database collector, then click Add Collector.
Restart	Select the agent(s) that you want to restart, then click Restart.
Actions	Rollback to the previous version.

Analytics エージェント

注: スマートエージェントはこのエージェントをサポートしていないため、エージェント管理 UI から分析エージェントをインストール、アップグレード、またはロールバックすることはできません。


Name	説明
Name	インストール時に指定された分析エージェントの名前。
一意のホスト ID	分析エージェントがインストールされているホストマシンの一意の ID。
Version	分析エージェントの現在のバージョン。
最後の接続	エージェントがコントローラに最後に接続された日時。
ログパイプラインの正常性	ログ分析パイプラインの正常性ステータス。
トランザクションパイプラインの正常性	トランザクション分析パイプラインの正常性ステータス。

分析エージェントの概要を表示するには、必要な分析エージェントをダブルクリックするか、エージェントを選択して [Details] をクリックします。

パイプラインの名前と正常性に基づいて詳細をフィルタリングできます。

ネットワークの可視性エージェント

インベントリ


Name	説明
一意のホスト ID	ネットワークの可視性エージェントがインストールされているホストマシンの一意の ID。
Hostname	ネットワークの可視性エージェントがインストールされているマシンのホスト名。
アプリケーション	対応するネットワークの可視性エージェントがインストールされているアプリケーション。
エージェントバージョン	ネットワークの可視性エージェントの現在のバージョン。
OS 名（OS Name）	アプリケーションがインストールされているオペレーティングシステムの名前。
OS Version	アプリケーションがインストールされているオペレーティングシステムのバージョン。
動的モニタリングモード	値は次のいずれかになります。 KPI：個々の接続を除く、すべてのモニター対象オブジェクト（アプリケーションフロー、階層、ノード、およびネットワークリンク）のネットワーク KPI メトリック。診断：接続を含むすべてのモニター対象オブジェクトのネットワーク KPI メトリック。詳細：接続を含むすべてのモニター対象オブジェクトのすべてのネットワークメトリック。
有効	[Enabled] アイコンは、エージェントが有効になっていることを示します。

アクション

必要なネットワークの可視性エージェントを選択し、次のアクションを実行できます。


[アクション]メニュー	説明
詳細	選択したネットワークの可視性エージェントの概要を表示します。
Pcap の設定	選択したエージェントのパケットキャプチャを設定します。
DMM の変更	動的モニタリングモードを変更する必要があるエージェントを選択します。
Pcap の開始	パケットキャプチャを開始する必要があるエージェントを選択します。
モニタリングの有効化	モニタリングを有効にするエージェントを選択し、[Enable] を選択します。
モニタリングの無効化	モニタリングを無効にするエージェントを選択し、[Disable] を選択します。
削除	削除するエージェントを選択し、[Delete] を選択します。

クラスタエージェント

注: スマートエージェントはこのエージェントをサポートしていないため、エージェント管理 UI からクラスタエージェントをインストール、アップグレード、またはロールバックすることはできません。

インベントリ


Name	説明
クラスタ名	インストール時に指定したクラスタエージェントの名前。
Version	インストールされているクラスタエージェントのバージョン。
Kubernetes のバージョン	クラスタエージェントが実行されている Kubernetes のバージョン。
ステータス	クラスタエージェントのステータス。

アクション

必要なクラスタエージェントを選択し、次のアクションを実行できます。


[アクション]メニュー	説明
詳細	選択したクラスタエージェントの概要を表示します。
削除	クラスタエージェントを削除します。削除する必要なエージェントを選択し、[Delete] をクリックします。
Enable	クラスタエージェントを有効にします。有効にする必要なエージェントを選択し、[Enable] をクリックします。
無効	クラスタエージェントを無効にします。無効にする必要なエージェントを選択し、[Disable] をクリックします。
設定	クラスタエージェントの名前空間を編集します。これは、管理者権限を持つユーザーが使用できます。