Monitor your web applications built in .NET Core 2.0 and above using the APM Insight .NET Core agent. You can monitor HTTP requests, SQL queries, errors, exceptions, web API calls, and remote calls within your ASP .NET Core applications, whether they are hosted on IIS or Kestrel web servers.
Note: The .NET Core agent supports NET Core applications built with .NET core 2.0, 2.1, 2.2, 3.0, 3.1 and .NET 5.0, 6.0 and 7.0.
The .NET monitoring tool offered by Applications Manager provides comprehensive monitoring for .NET Core applications. To install the APM Insight .NET Core agent in Applications Manager, follow the steps provided below:
Note: Run a Checksum validation to verify the authenticity of the agent. Click here to learn more.
For versions v6.5.1 and above:
Install the .NET Core Agent by executing the below command:./InstallAgent.ps1 -Destination "[path]" -InstallType "[local|global]" -LicenseKey [licenseKey] -ApmHost [APM-HOST] -ApmPort [APM-PORT] -ApmProtocolHttps true
Example:
./InstallAgent.ps1 -Destination "G:\.NET_Core_Agent" -InstallType "local" -LicenseKey
APMI_762cf0800fd41749008b5d73115a6841d8dee7e01fc2f451500d39786b593c39
-ApmHost app-w8-test -ApmPort 8443 -ApmProtocalHttps true
where,
Destination "[path]" → The location where the agent will be installed. May be an absolute or relative path. Wrapping quotes are also required.
InstallType [local|global] → Determines whether the installation will be done locally or globally. Local install is the recommended installation type.
Note: For Windows Service application monitoring, the global install type needs to be enabled.
LicenseKey [licenseKey] → The license key copied from the Application Manager APM Insight homepage.
[APM-HOST] → Host of Applications Manager
[APM-PORT] → SSL Port of Applications Manager
[APM-PROTOCAL-HTTPS] (Optional) → To set the communication protocol, enter 'true' for HTTPS or 'false' for HTTP.
For version v6.3.0:
Install the .NET Core Agent by executing the below command:./InstallAgent.ps1 -Destination "[path]" -InstallType "[local|global]" -LicenseKey [licenseKey] -ApmHost [APM-HOST] -ApmPort [APM-PORT]
Example:
./InstallAgent.ps1 -Destination "G:\.NET_Core_Agent" -InstallType "local" -LicenseKey
APMI_762cf0800fd41749008b5d73115a6841d8dee7e01fc2f451500d39786b593c39
-ApmHost app-w8-test -ApmPort 9090
where,
Destination "[path]" → The location where the agent will be installed. May be an absolute or relative path. Wrapping quotes are also required.
InstallType [local|global] → Determines whether the installation will be done locally or globally. Local install is the recommended installation type.
Note: For Windows Service application monitoring, the global install type needs to be enabled.
LicenseKey [licenseKey] → The license key copied from the Application Manager APM Insight homepage.
[APM-HOST] → Host of Applications Manager
[APM-PORT] → SSL Port of Applications Manager
For versions v6.0.2 and below:
Install the .NET Core Agent by executing the below command:./InstallAgent.ps1 -Destination "[path]" -InstallType "[local|global]" -LicenseKey [licenseKey]
Example:
./InstallAgent.ps1 -Destination "G:\.NET_Core_Agent" -InstallType "local" -LicenseKey APMI_762cf0800fd41749008b5d73115a6841d8dee7e01fc2f451500d39786b593c39
where,
Destination "[path]" → The location where the agent will be installed. May be an absolute or relative path. Wrapping quotes are also required.
InstallType [local|global] → Determines whether the installation will be done locally or globally. Local install is the recommended installation type.
Note: For Windows Service application monitoring, the global install type needs to be enabled.
LicenseKey [licenseKey] → The license key copied from the Application Manager APM Insight homepage.
Open the apminsight.conf file from the destination path in any text editor and include the following keys:
apm.host=[APM-HOST]
apm.port=[APM-PORT]
Example:
apm.host=app-w8-test
apm.port=9007
Note: The 4th step is not required for the version 6.3.0 and above.
If the Applications Manager sends data through HTTP protocol, include the below line in apminsight.conf file:
apm.protocol.https=false
Configure the application filters if the .NET Core application is hosted on an IIS server.
Start or restart the .NET Core application.
Note: If you’re using an IIS server for reverse proxy via AspNetCoreModule, you’ll need to reset the IIS server.
Perform some transactions to start monitoring.
Note: Proxy the server for agent communication and configure the .NET Core agent via the appsettings.json file.
application.name="[YourApplicationName]"
Changing the application name only creates a new host whereas the previous host does not get deleted.
To uninstall APM Insight .NET Core agent from application server, follow the below given instructions in that server:
With Applications Manager's Dot Net Core monitoring, you can optimize the performance of your .Net Core applications with unmatched visibility.