APM Insight .NET Core Agent


Installing APM Insight .NET Core Agent

To install APM Insight .NET Core agent in Applications Manager, follow the steps given below:

  1. Download the .NET Core Agent and unzip the agent.
  2. Run Powershell in administrator mode and navigate to the location of unzipped agent.
  3. Install the .NET Core Agent by executing the below command:

    InstallAgent.ps1 -Destination "[path]" -InstallType "[local|global]" -LicenseKey [licenseKey]

    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.
    LicenseKey [licenseKey] → The license key copied from the Application Manager APM Insight homepage.

    Example:

    InstallAgent.ps1 -Destination "G:\.NET_Core_Agent" -InstallType "local" -LicenseKey APMI_762cf0800fd41749008b5d73115a6841d8dee7e01fc2f451500d39786b593c39

  4. Open the apminsight.conf file in any text editor and include the following keys:

    apm.host=[HOST]:[PORT]

    Example:

    apm.host=app-w8-test:9007

  5. If the Applications Manager sends data through HTTP protocol, include the below line in apminsight.conf file:

    apm.protocol.https=false

  6. Save the file and restart your .NET Core application.

Note: To Change the .NET Core application name,
  1. Navigate to the application publish directory.
  2. Create or open the apmapplication.conf file, then add or modify the application name.

    application.name="[YourApplicationName]"

    Changing the application name only creates a new host whereas the previous host does not get deleted.

  3. Restart the .NET Core application.

Uninstalling APM Insight .NET Core Agent

To install APM Insight .NET Core agent in Applications Manager, follow the below given instructions:

  1. Run Powershell in administrator mode and navigate to the unzipped agent path.
  2. Execute the script UninstallAgent.ps1 (Installed Agent directory will not be removed but the agent settings will be removed.)
  3. Restart the .NET Core application for the changes to take effect.
  4. Reset IIS if the applications are hosted in IIS.