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:

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

App Server 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.
Type The type of the agent such as Java, Python, Node, Webserver, and Dotnet.
Version The current version of the agent.
Smart Agent ID

The ID of the Smart Agent that manages the corresponding app 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 agent is managed by Smart Agent and No if the agent is not managed by Smart Agent.
Application The application on which the corresponding agent is running.
Tier The service running on the corresponding application.
Node The service instance of the service running on the application.
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.
All Monitoring Disabled Deactivate monitoring for the associated application.

Actions

Action Menu Description
View Node Dashboard To view the Nodes > Tier dashboard of the required node. You can click the checkbox next to the specific agent, then click View Node Dashboard.
Filters

To filter based on your requirement. Click Filters > Add Criteria.

You can use Filters to add different filter criteria based on your requirement. For example, to see all Java Agents that have outdated versions:

  1. Click Filters > Add Criteria > .
  2. Select Agent Type.
  3. Select Java Agent from the drop down.
  4. Click Done.
  5. Click Add Criteria to add another criteria for versions.
  6. Select Version Status.
  7. Click the Version Status dropdown, and then select Out of Date.
  8. If you just want to have a quick view of the list, click Apply. You can close this to not use this criteria. However, if you click Done, the criteria is used for filtering the list.
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 activate the selected agents. Select the required agents, then click Enable.

The Monitoring Status displays as Enabled.
Disable Monitoring

To deactivate the selected agents. Select the required agents, then click Disable.

The Monitoring Status displays as Disabled.
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 agents that you want to delete, 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. It provides details of all the available app agents. Click 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.
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.

Smart Agents

Inventory

Name Description
Version Status

Displays the version status of the Smart Agent on which the application is running.

  • The Latest icon represents that the corresponding Smart Agent is running the latest version.
  • The Out of Date icon represents that the corresponding Smart Agent has a version which is no longer supported.
  • The Update Available icon represents that the corresponding Smart 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.
Version The version of the Smart Agent.
Smart Agent ID

The ID of the Smart Agent that is installed on the host machine to manage the agents.
Hostname The hostname of the machine on which the corresponding Smart Agent is running.
Application The number of applications using the corresponding Smart Agent.
Deployed Agents

The number of deployed agents (app server agents or Machine Agents)
Active

The active status of Smart Agent. If the Smart Agent is running, the value is true. If Smart Agent is not active, this displays the time when it was last active. For example, if you terminate the Smart Agent, after 15 minutes the value is displayed as Active 15 min ago.

Actions

Action Menu Description
Details To view the application summary on which the selected Smart Agent is installed. The summary includes application names along with the number of deployed agents. You can click the checkbox next to a specific smart agent, then click Details.
Filters

To filter based on your requirement. Click Filters > Add Criteria.

You can use Filters to add different filter criteria based on your requirement. You can also add filters based on tags.
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. If you have enabled the tags feature, you can view and select the tags to add as column on the page, which helps you to filter the list using the custom tags. To enable tags, see Tags.
Upgrade

To upgrade the selected smart agents. Select the required smart agents, then click Upgrade. This feature is currently disabled by default. Contact your customer support to get more details.
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.

Tags

The tags feature is supported when you install supported agents using Smart Agent. You can use tags to filter the list on Machine Agents, App Server Agents, Smart Agents, andDatabase Agents.

You are required to perform the following to enable and view tags under View Options or Filters > Add Criteria for the supported agents in the Agent Management UI:

  1. Enable tags.
    To use the tags feature, you can ask your customer support to set the entity.tagging.enabled account level property to true in the Administration Console. By default, this property is disabled. For details, see Enable Custom Tagging.
  2. Update the Smart Agent config.ini.
    Add the tags under the common config section in the config.ini file.
    This is a sample configuration where we have added tags owner and location:
    CODE 
    [CommonConfig]
            ServiceName           =
            ServiceNamespace      =
            RequestTimeoutSeconds = 0
            AgentName             =
            PollingIntervalInSec  =
            Tags				  = "owner=abc;location=blr"
  3. Start Smart Agent.
    To restart the Smart Agent run the following command:
    CODE 
    sudo systemctl restart smartagent
  4. View tags.
    Navigate to View options to view the tags as a column or use the tag within the filter.

Database Agents

Inventory

Name Description
Version Status

Displays the version status of the agent on which the application is running.

  • The Latest icon 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.
Unique Host ID The unique ID of the host on which the Database Agent is running.
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 Agents

Note: You cannot install, upgrade, or rollback Analytics Agents from the Agent Management UI because Smart Agent does not support this agent.
Name Description
Name The name of the Analytics Agent that was specified during installation.
Unique Host ID The unique ID of the host machine on which Analytics Agent is installed.
Version The current version of the Analytics Agent.
Last Connected The date and time when the agent was last connected to the Controller.
Log Pipeline Health The health status of the Log Analytics pipeline.
Transaction Pipeline Health The health status of Transaction Analytics pipeline.

To view the Analytics Agent summary, you can double click the required Analytics Agent or select the agent, then click Details.

You can filter the details based on name and health of the pipelines.

Network Visibility Agents

Inventory

Name Description
Unique Host ID The unique ID of the host machine on which Network Visibility Agent is installed.
Hostname The hostname of the machine on which the Network Visibility Agent is installed.
Application(s) The application(s) on which the corresponding Network Visibility Agent is installed.
Agent Version The current version of the Network Visibility Agent.
OS Name The name of the Operating System on which the application is installed.
OS Version The version of the Operating system on which the application is installed.
Dynamic Monitoring Mode

The values can be any of the following:

  • KPI – Network KPI metrics for all monitored objects (application flows, tiers, nodes, and network links) except individual connections.
  • Diagnostic – Network KPI metrics for all monitored objects, including connections.
  • Advanced – All network metrics for all monitored objects, including connections.
Enabled The Enabled icon represents that the agent is enabled.

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 Network Visibility Agent.
Pcap Configuration

To configure the packet capture for the selected agent.
Change DMM Select the agent(s) for which you require to change the Dynamic Monitoring Mode.
Start Pcap Select the agent(s) on which you require to start the packet capture.
Enable Monitoring Select the agent(s) that you want to enable for monitoring, then select Enable.
Disable Monitoring Select the agent(s) that you want to disable for monitoring, then select Disable.
Delete Select the agent(s) that you want to delete, then select Delete.

Cluster Agents

Note: You cannot install, upgrade, or rollback Cluster Agents from the Agent Management UI because Smart Agent does not support this agent.

Inventory

Name Description
Cluster name The name of the Cluster Agent that you specified during the installation.
Version The version of the installed Cluster Agent.
Kubernetes Version The Kubernetes Version on which the Cluster Agent is running.
Status The status of the Cluster Agent.

Actions

You can select the required Cluster Agent and perform the following actions:

Action Menu Description
Details To view the summary of the selected Cluster Agent.
Delete To delete a Cluster Agent. Select the required agent that you want to delete, then click Delete.
Enable To enable a Cluster Agent. Select the required agent that you want to enable, then click Enable.
Disable To disable a Cluster Agent. Select the required agent that you want to disable, then click Disable.
Configure

To edit the Cluster Agent Namespace.

This is available for users who have administrator permissions.