APM Insight - Agents Troubleshooting and Compatibility Guide
To optimize performance and simplify troubleshooting, please provide the following details for each agent and cross-verify the compatibility using the provided help pages:
Java Agent
- Application Server & Version: __________________ [e.g., Apache Tomcat, Jboss]
- Deployment Type: ___________________ [e.g., Docker / Kubernetes / GCP / Azure / On-prem app]
- JVM / JDK Version: __________________ [e.g., Java 11]
- Database backend & Database driver with Version: ________________ [e.g., MSSQL, mssql-jdbc-6.2.2]
- Web Frameworks / Components used: __________________ [e.g., Struts, Spring, Hibernate]
.NET Agent
- .Net Framework Version: ______________ [e.g., .Net Framework 4.0]
- Application Type: ________________ [e.g., .NET Web Application hosted on IIS, .NET Service, or .NET Desktop Application]
- Deployment Type: ___________________ [e.g., Windows / Linux / Docker / Kubernetes / Azure]
- Database Backend & Version: ______________ [e.g., MSSQL, MySQL, OLE DB]
- Internal Components: __________________ [e.g., ASPX, MVC]
- External Components (Web Service Calls): __________________ [e.g., ASMX , WCF, Web API]
- Memcached & NoSQL (if any): ______________ [e.g., Redis, Cassandra]
- Queue (if any): ___________________ [e.g., MSMQ]
.NET Core Agent
- .Net Core Framework Version: _________________ [e.g., .NET Core framework v2.0, v3.0, 6.0]
- Application Type: ________________ [e.g., .NET Core Web Application hosted on IIS, .NET Core Service or .NET Core Desktop Application]
- Deployment Type: ___________________ [e.g., Windows / Linux / Docker / Kubernetes / Azure]
- Web service: __________________ [e.g., MVC,WebAPI]
- Database: ____________________ [e.g., PostgreSQL, MSSQL, OLE DB]
Node.js Agent
- Node.js version: _______________ [e.g., Node.js 4]
- Deployment Type: ___________________ [e.g., Windows / Linux / Docker / Kubernetes]
- Frameworks: _________________ [e.g., Express]
- Databases supported: _______________ [e.g., MySQL, MongoDB]
PHP Agent
- PHP Version: ________________ [e.g., PHP 5.3, PHP 7.4 ]
- Deployment Type: ___________________ [e.g., Windows / Linux / Docker / Kubernetes]
- Web Server & Version: _________________ [e.g., Apache2, IIS]
- Framework Used: __________________ [e.g., Laravel, Drupal]
- Database Server & Version: _____________ [e.g., SQLite, PostgreSQL]
- Command screenshot:

php -v
- Before and after Installation: phpinfo.php output as an HTML file
Ruby Agent
- Environment Used & Version: _______________ [e.g., Ruby - 1.8.7, Rails - 3.0, Sinatra - 1.4.0]
- Application Server: _______________ [e.g., Puma]
- Database Server: ________________ [e.g., SQLite]
Python Agent
- Python Version: _______________ [e.g., Python 3.5.0]
- Deployment Type: ___________________ [e.g., Windows / Linux / Docker / Kubernetes]
- Framework Used: _______________ [e.g., Django, Flask]
- Database Server & Version: _____________ [e.g., PyMySQL v1.0.1, SQLite v2.0.0]
- External Components: _____________ [e.g., Redis]
- HTTP Libraries Used: _____________ [e.g., http.client, httplib2]
- Async Libraries Used: _____________ [e.g., aioredis, aredis]
New to ADSelfService Plus?
Related Articles
APM Insight Java Agent – Onboarding & Troubleshooting Guide
This guide helps support engineers troubleshoot cases where the APM Insight Java Agent is not onboarding (not appearing in Applications Manager) after installation. Follow the step-by-step verification checklist in Section 2 to quickly diagnose and ...
APM Insight Troubleshooting - FAQs
Monitor Addition - FAQs 1. How to add an APM Insight Monitor? After you deploy the APM Insight agent in your Application Server with suitable Applications Manager credentials in the apminsight.conf file, APM Insight monitors will automatically be ...
Real User Monitor (RUM) - Troubleshooting guide
If the monitor has not polled data for a long time, follow the below steps for troubleshooting. Step 1: Check the RUM Agent configuration Real User Monitor requires the RUM Agent to be installed and mapped to the Applications Manager. Refer this help ...
Uninstrumented Block of Code - APM Insight
In the traces tab --> Slowest Method Calls and Count we show if you find Un-instrumented block of code the reason is as follows: Basically, What is un-instrumented block of code in APM Insight? By default, APM Insight agent monitors known frameworks ...
Backward compatibility for older agents
Java Agent (v2.3 and below) : Open the apminsight.conf file present in the agent installation folder. Add an extra entry 'license.key'. The value for this would be the license key shown in the help card present in the home page of the APM Insight ...