AppDynamics Application Intelligence Platform

3.9.x Documentation


Learn by Watching

Doc Maps

Skip to end of metadata
Go to start of metadata

Use these instructions to install the .NET Agent using the Agent Download Wizard in the Controller.

If you downloaded the agent from the AppDynamics download zone, see Install the .NET Agent.

Before You Begin

1. Confirm you have access to a controller, the web application where you monitor your application performance:

    • If you use a SaaS controller, AppDynamics sent you the controller host in your Welcome Email.
    • If you use the on-premise controller, you supplied the host and port at install time.

2. Verify you've enabled COM+ on your system. See To verify COM+ Services are enabled.

Instrumenting Your CLR with the .NET Agent

Quick Install: .NET Agent

Direct link:

There are four steps to instrument your CLR and begin monitoring: 

1. Download: Use the Agent Download Wizard to configure and download the agent.
2. Install: Run the MSI installer package and the AppDynamics Agent Configuration utility. 
3. Apply Load: Apply load to activate instrumentation.
4. View Your Application: Log on to the Controller to monitor application performance.

Download the .NET Agent

The Agent Download Wizard walks you through configuration steps and helps you download the agent.

1. Log on to the Controller and click the Agent Download Wizard tab.

The download wizard guides you through the download process.


2. Click .NET, then click Next.


3. Click to select 32-bit or 64-bit system, then click Next.


7. Click Click here to Download to download the App Agent for .NET.



Now you're ready to install the agent on your app server.


Install the agent on your app server

After you download the agent, install it to your app server. The final window of the Agent Download Wizard includes brief instructions for installing the agent.

  1. Run the MSI installer package and accept the default settings.
  2. When the installation completes, leave Launch AppDynamics Agent Configuration checked. Click Finish.
  3. The .NET Agent Configuration utility launches. Proceed through the configuration steps and accept the default settings.

    • If you're using a SaaS Self-Service Controller, you must include your account name and access key in the Controller Configuration window.

    • In the Application Configuration window, enter a name for your business application in the New Application field.
      For new users, it is OK to enter "MyApp". You can change it later when know more about how you want to organize your applications in AppDynamics.

    • For Pro Trial installations, AppDynamics recommends you use Automatic tier naming in the Assign IIS applications to tiers window.

    Detailed Configuration Instructions

    For step by step instructions, see Configure the .NET Agent.
    To instrument Windows services, see Enable the .NET Agent for Windows Services.
    To instrument standalone applications, see Enable the .NET Agent for Windows Services and Standalone Applications.

  4. On the Configuration Summary window, leave Restart IIS checked to start monitoring immediately. Uncheck Restart IIS if you don't want to restart IIS. Monitoring will not begin until the next time IIS restarts.

If you leave Restart IIS checked, the configuration utility restarts IIS, so now you're ready to put load on your application.

Apply load to your application

If you are instrumenting a production application, this will happen with customer interaction. Otherwise, create some test load on your application. The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring.

View your application

Log on to the Controller to see your application in action.

From here, you can install more agents or you can begin monitoring your application. The links below will help you get started:




Learn More