cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Not a customer? Start a free trial

Click the Start a free trial link to start a 15-day SaaS trial of our product and join our community as a trial user. If you are an existing customer do not start a free trial.

AppDynamics customers and established members should click the sign in button to authenticate.

Knowledge Base

How do I install .NET Agent for .NET Core application?

How do I install .NET Agent for .NET Core Application (without Dockerfile), hosted on Apache on Linux?

 

This article is intended for users who want to implement .NET Agent for .NET Core applications hosted via Apache HTTP Server on Linux environments.

 

Assumption: The application is not running as a Docker container, so no Dockerfile setup is required.

 

Table of Contents


 

What should I do before starting to install .NET Agent?

These steps are intended for customers who are running .NET Core 2.0+ based applications running on a Linux environment, and hosted via Apache HTTP Server. 

 

Before you instrument the application, make sure you have access to the AppDynamics Controller in which your application metrics will appear. Refer to the Agent and Controller Compatibility document to ensure your Controller version is compatible with your agent version.

 

How do I install .NET Agent for .NET Core application (without Docker)?

 

NOTE: Since the application is not running as a Docker Container, no Dockerfile setup is required.

 

  1. On Linux server, create directory structure /opt/appdynamics/dotnet

  2. Download the agent binaries from the http://download.appdynamics.com/ and then extract them from the zip file into /opt/appdynamics/dotnet directory (created in step 1).

    The archive contains these files:
    • AppDynamics.Agent.netstandard.dll
    • AppDynamicsConfig.json.template
    • libappdprofiler.so
    • README.md

  3. Make a copy of AppDynamicsConfig.json.template and rename it to AppDynamicsConfig.json

  4. Update AppDynamicsConfig.json file:

    {
    "controller": {
    "host": "<controller_host>",
    "port": <port>,
    "ssl": <true/false>,
    "account": "<account_name>",
    "password": "<account_key>"
    },
    "application": {
    "name": "<app_name>",
    "tier": "<tier_name>",
    "node": ""<node_name>"
    },
    "analytics" : {
    "host": "localhost",
    "port": 9090
    },
    "feature": [
    "FULL_AGENT"
    ]
    }

     

  5. Configure below environment variables in the applications service (start-up) file
    • Environment=CORECLR_ENABLE_PROFILING=1
    • Environment=CORECLR_PROFILER={57e1aa68-2229-41aa-9931-a6e93bbc64d8}
    • Environment=CORECLR_PROFILER_PATH=/opt/appdynamics/dotnet/libappdprofiler.so
    • Environment=APPDYNAMICS_CONTROLLER_SSL_CERTDIR=<path_to_ssl_certificate_directory>
    • Environment=APPDYNAMICS_CONTROLLER_SSL_CERTFILE=<path_to_ssl_certificate_directory>/<certificate_filename>

  6. Restart Application Service
    sudo systemctl restart <service_name>
  7. Verify whether agent is started successfully
    sudo lsof -p <app_pid> | grep -i appd

 

When the application starts, we should see:

  • output showing the agent start-up sequence
  • the Agent is talking to the Controller
  • the process is using the AppDynamics Agent library

 

Additional Resources

For more information on .NET Agent for Linux, see the .NET Agent for Linux documentation.

Version history
Last update:
‎05-20-2021 11:31 AM
Updated by:
Labels (1)
By replying you agree to the Terms and Conditions of the AppDynamics Community.
0 Kudos