APMInsight - .NET Agent Data Collection - KB
Overview
This document provides a step-by-step guide to troubleshoot the data collection issue with the APM Insight .NET Agent. It includes environment prerequisites, connectivity validation, licensing checks, and corrective actions for common failure scenarios where the monitor shows "UP but no data" or "DOWN with no data collection."
Prerequisites
Please note that restart of your application is necessary (i.e. IISRESET cmd execution for IIS sites, restart for windows service & desktop apps) to start monitoring after agent installation
Prerequisites 1. Environment should aligns with our agent's supported components
To verify the environment, Run following cmd using windows powershell administrator mode
Get-ChildItem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP' -Recurse | Get-ItemProperty -Name Version, Release, SP -ErrorAction SilentlyContinue | Where-Object { $_.PSChildName -match '^(?!S)\p{L}'} | Select-Object PSChildName, Version, SP, Release- Confirm that .NET Framework v3.0 listed and has SP ≥ 1
- Confirm .NET Framework v4 (Full) listed and has Release ≥ 378389
If the prerequisites are met but the agent (.msi) installation still fails:
- Recheck prerequisites and try the `Installation via command line`.
- If issue still persists, locate the `apm_install.log` file in the installation directory & send the log file to appmanager-support@manageengine.com for further assistance.
Prerequisites 2. Network and Firewall
Outbound communication from the agent-installed machine to the Applications Manager (Host and Port) should be allowed — either directly or via a proxy.
To verify the connectivity,
- Get the configured the "Apm Endpoint Urls" from APM Insight .NET Agent Configuration tool
- Run following cmd using windows powershell administrator mode with above "Apm Endpoint Url" and output should shows the “Applications Manager” content as below screenshot:
add-type 'using System.Net;using System.Security.Cryptography.X509Certificates;public class TrustAllCertsPolicy : ICertificatePolicy {public bool CheckValidationResult(ServicePoint a,X509Certificate b,WebRequest c,int d){return true;}}';[System.Net.ServicePointManager]::CertificatePolicy=New-Object TrustAllCertsPolicy;(Invoke-WebRequest -Uri '<Apm_EndPoint_Urls>/index.do').Content -split "`n" | Where-Object {$_ -match 'Applications Manager'}
- If the output doesn't contains references to 'Applications Manager' and unable to reach the server, either the endpoint is incorrect or not allowed for communication. So, ensure that network and firewall configurations allow communication from this APM Insight .NET agent to the Application Manager then update the appropriate values in "Edit APM Insight .NET Agent Configuration" tool.
- If a proxy server is in use, specify the proxy server configuration in the APM Insight agent's settings to ensure proper communication between the agent and the Application Manager.
- Then, restart the application and agent service to reflect the changes.
Prerequisites 3. Application user should have full permissions over the agent directory - C:\ProgramData\DotNetAgent & C:\ProgramData\DotNetCoreAgent
To verify the application user permission,
- Open Task Manager → Details tab
- Locate your target application process: w3wp.exe for IIS app, <service_name>.exe for services, or the main executable for desktop apps.
- Note the "User name and Go to the above folder (C:\ProgramData\DotNetAgent & C:\ProgramData\DotNetCoreAgent) → Properties → Security.
- Confirm the user/group (e.g., IIS_IUSRS, SYSTEM, or service account) has Read & Write permissions.
If missing permissions, click Edit → Add → [User Name] → Allow Read & Write permissions, then restart the application and check.
Prerequisites 4. Competitor agent of other tools like (E.g Dynatrace, AppDynamics, etc..) should be removed before installing our agent.
Follow this steps to identify and resolve conflicts between other APM products and the APM Insight .NET agent.
Prerequisites 5. SharePoint/Multi-Domain environment: Specific configuration changes required due to security concerns in these environments.
Follow this steps to identify the SharePoint/Multi-Domain environment and configure the "Support Multi-Domain Applications" checkbox
Scenarios & Troubleshooting
Scenario1: Monitors shows "DOWN" & No data collection
Could not connect to the host
Configured "APM Endpoint Urls" - Application Manager Endpoint might not reachable from the agent installed machine. i.e. Sometime outbound communication for Applications Manager host might be modified or restricted from the agent installed machine — either directly or via a proxy.
To verify the connectivity,
- Get the configured the "Apm Endpoint Urls" from APM Insight .NET Agent Configuration tool
- Run following cmd using windows powershell administrator mode with above "Apm Endpoint Url" and output should shows the “Applications Manager” content as below screenshot:
add-type 'using System.Net;using System.Security.Cryptography.X509Certificates;public class TrustAllCertsPolicy : ICertificatePolicy {public bool CheckValidationResult(ServicePoint a,X509Certificate b,WebRequest c,int d){return true;}}';[System.Net.ServicePointManager]::CertificatePolicy=New-Object TrustAllCertsPolicy;(Invoke-WebRequest -Uri '<Apm_EndPoint_Urls>/index.do').Content -split "`n" | Where-Object {$_ -match 'Applications Manager'}
- If the output doesn't contains references to 'Applications Manager' and unable to reach the server, either the endpoint is incorrect or not allowed for communication. So, ensure that network and firewall configurations allow communication from this APM Insight .NET agent to the Application Manager then update the appropriate values in "Edit APM Insight .NET Agent Configuration" tool.
- If a proxy server is in use, specify the proxy server configuration in the APM Insight agent's settings to ensure proper communication between the agent and the Application Manager.
- Then, restart the application and agent service to reflect the changes.
License Expired
"APM Insight .Net Add-On" license might got expired or addon licensed not enabled on the Applications Manager.
To verify,
- Open the "APM Insight .NET Agent Health monitor" tool
- Navigate to the "IIS Applications" tab for IIS sites OR "Windows Service and Apps" for Windows Service & Desktop apps
- Check the app monitoring status appears as "LicenseExpired" state.
To re-establish the Application monitoring ,
- Apply & Ensure the "APM Insight .Net Add-On" licensing enabled to allow .NET app monitoring on the Applications Manager.
- From the "APM Insight .NET Agent Health monitor" tool, Click "Fix it" → Yes
Scenario2: Monitors shows "UP" but No data collection
No Active Traffic
- The monitored application doesn't have active traffic/transactions performed in the chosen time window.
- In such cases, make some transactions/traffic and check after some time.
Application might be renamed/moved
- If the respective application has replaced/renamed/moved in the IIS server, a new monitor instance might have been added and the old monitor would have no data to report. In such cases, kindly suspend (if historical data is required) or delete the monitor.
- Since the applications are mapped to their respective IIS paths, any change to the physical path of the application will require an update to the App Filters.
Application Crash
With agent installation, application might get crashed due to the incompatible Sharepoint/Multi-domain assembly environment apps or Unsupported DLLs methods
- Application Crash issue1: Incompatiblity for Sharepoint/Multi-domain assembly environment apps
- Follow this steps to identify the SharePoint/Multi-Domain environment and resolve this issue by enabling the "Support Multi-Domain Applications" option.
- Application Crash issue2: Unsupported DLLs methods instrumentation
- Follow this steps to identify and resolve the Unsupported DLLs methods crashing issue
Applications Marked as Unmanaged/Suspended
Application might be marked as Unmanaged/Suspended for monitoring from the Applications Manager UI.
To verify,
- Open the "APM Insight .NET Agent Health monitor" tool
- Navigate to the "IIS Applications" tab for IIS sites/"Windows Service and Apps" for Windows Service & Desktop apps
- Check the app monitoring status appears as "Suspended" state.
To Manage/Activate the Application,
- From the Applications Manager, Navigate to the APM → [Your APM Insight Application/Instance] → Monitor Actions → Click on Activate to start the data collections
Still Issues persists?
If still encounter with app data collection failure, contact appmanager-support@manageengine.com along with updated Agent diagnostics for further assistance
New to ADSelfService Plus?
Related Articles
How to Install .NET agent on AWS Elastic Beanstalk?
One of the two options listed below can be used to install APM Insight agent onto a .NET web application hosted in Elastic Beanstalk environment via ebextensions. Deployment through AWS kit for Visual Studio. Deployment via uploading packages to AWS ...Troubleshoot - Duplicate APMInsight Monitors
Introduction: Duplicate monitors might be created in APMInsight due to various reasons. This article will help you identify and resolve the issue of duplicate monitors. The common causes include: - Changes in monitor configuration. (apminsight.conf ...APM Insight monitor is UP, but monitor page doesn't show any data
Possible Causes The APM Insight monitor status corresponds to the respective agent folder pointed Java Application status i.e., as long as the Application server is running, the monitor status will be UP. 1. No Transactions Recorded: It is possible ...APMInsight - NET Agent Onboarding - KB
Overview This document provides a step-by-step guide to onboard and troubleshoot the APM Insight .NET Agent. It includes environment verification, permission checks, network connectivity validation, and solutions for common installation and ...How .NET agent collects data?
APM Insight .NET Agent is a profiling based monitoring solution. It uses the profiling APIs provided by Microsoft frameworks and hooks itself into the ASP.NET worker process. The general workflow for monitoring is as given below : The .NET agent ...