How does APM Insight work?


APM Insight includes a remote monitoring agent to be deployed in your Application Server. This agent performs the tasks of data collection; acquisition and transmission.

To configure APM Insight you must first download the APM Insight agent and deploy it in your Application Server. Once the agent is deployed, the agent residing in the Application Server uses byte code instrumentation to collect application performance metrics and sends it to the central Applications Manager server at fixed intervals.

APM Insight gives you the following metrics for the applications that it is set to monitor:

    • APDEX Scores
    • Response Time
    • Throughput

Based on the metrics received from the agent, the APM Insight server measures the performance of the application and generates performance charts. This information is assembled and presented in detail in the APM Insight dashboard.

How to install APM Insight?

Download and install
Configure agent

When the Application Server starts up, APM Insight Monitor will be added automatically in the Applications Manager.

Agent auto-upgrade

Supported versions - .Net version 2.0 and Java Version 1.9

When the Agent Auto-upgrade feature is enabled, Applications Manager will automatically download the new agent zip/msi file for upgrade if a new agent version available. By default, auto-upgrade is disabled. You can enable auto-upgrade by clicking on the Customize Agent Configuration icon and checking the Agent Auto-upgrade checkbox. You can also enable auto-upgrade by setting the autoupgrade.enabled property in the apminsight.conf file to true.

Note: For java agents, application restart is mandatory for the new agent to take effect. On the other hand, for .Net agents the update process can be scheduled by setting the "scheduledtime" property in apminsight.conf file.

Manual Agent Upgrade

By default, the auto-upgrade feature is disabled i.e the autoupgrade.enabled property in the apminsight.conf file is set to false. Here is how you can manually upgrade the agent:

  • The following message will be displayed at the top of the APM Insight details page "The deployed agent version at this instance is (1.9/2.0), Update Now to the latest version (2.0/2.1)".
  • On clicking the Update Now link, a confirmation dialog will appear to initiate agent update. For .Net agents the update process can be scheduled. In the pop-up Agent Update window, configure the schedule time for the update. IIS will be reset during that hour.
  • Choose the Yes, continue¬†button to start agent update. On doing so the alert message changes to "Agent update will happen shortly...".
  • After few minutes, either on page refresh or on navigating to other tabs, the alert message will be modified.
  • On successful download of the agent, the alert message changes to "Agent downloaded successfully. Please restart your application" for the Java Agent and or "Agent downloaded successfully. Update will happen at the scheduled hour" for the .Net Agent.
  • If an error occurs during the agent update, then the message changes be "Problem encountered during agent update.View details". On clicking the View Details link, the error message will be displayed with options to retry or dismiss.
Note: The Retry option will clear the upgrade status in the cache and immediately try to perform agent update, so message gets modified to "Agent update will happen shortly..." again. The Dismiss option will just clear the upgrade status in Cache and the message changes to "The deployed agent version at this instance is (1.9/2.0), Update Now to the latest version (2.0/2.1)".