On this page:

Related pages:

After you install the AppDynamics .NET Agent, configure the agent according to the types of applications you want to monitor:

It is possible to instrument any combination of IIS Applications, Windows services, and standalone applications on a single server. Run the configuration utility to configure IIS, then follow the instructions for Windows services and Standalone applications.

Use the AppDynamics Agent Configuration Utility to configure the agent immediately after installation, or to make changes to existing agent configurations. The utility configures the agent for one machine at a time.

Prepare to Configure the .NET Agent

The configuration utility must restart IIS to apply configurations. The utility offers you the option to restart IIS or not. If you choose not to restart, configurations apply the next time IIS restarts.

File System Security Settings

The following Windows accounts require specific file system permissions:

The required permissions are as follows:

Configure the .NET Agent

  1. In the Windows menu, click AppDynamics > .NET Agent > AppDynamics Agent Configuration.
    If the "Warning: 3rd Party Profiler installed" message displays, click Yes to exit and uninstall any pre-existing profiler.

    Check the registry to make sure that the uninstall process cleaned up the registry entries. Use the warning message to identify any undeleted profiler environment variables.

  2. If the configuration utility detects legacy agent configurations from the .NET Agent version 3.7.7 or earlier, it displays the Upgrade Configuration window.

    Removing legacy configurations modifies web.config files causing IIS to restart affected applications.

    When the utility discovers no further profiler conflicts or after any configuration clean up it displays the welcome window.
  3. On the Log directory permissions window you can optionally change the location of the log directory, click Change and select a new location.
  4. If needed, type in an account to grant log directory permissions. Click Add. If you see a warning message, make sure that the account is valid on the system.
    The wizard confirms the list of accounts.
  5. On the Controller Configuration window, enter the Controller access information and credentials.
  6. Click Test Controller Connection to verify the connection.
  7. On the Application Configuration window, AppDynamics displays existing business application information from the Controller and displays it in the left column. Controller connection status displays on the right.
  8. Configure the business application for the Controller as follows:
  9. Click Next to advance to Assign IIS applications to tiers where you can use one of the options below.

Watch the Video:

<style type="text/css">.vidyard_player{width: 600px; }.vidyard_player > span{max-width: 600px !important; max-height: 360px!important;margin-left:0!important;}.innerContainer{position: relative; display: block; width: 100% !important; height: 0; }</style><script type="text/javascript" id="vidyard_embed_code_AXLDUFcgGskDm6kDowNFnj" src="//play.vidyard.com/AXLDUFcgGskDm6kDowNFnj.js?v=3.1.1&type=inline&second=90"></script> 

For full-screen viewing, click Modeling .NET Applications in AppDynamics.

Automatically name IIS tiers

  1. In the Assign IIS applications to tiers window click Automatic.
  2. If prompted, click OK to confirm Automatic configuration.
    The configuration utility summarizes the configuration settings.
  3. By default when you click Next the configuration utility restarts IIS.

    If you do not want to apply the configuration right away, uncheck the box. The Configuration Utility saves the information and applies it the next time you restart IIS.

  4. If you proceed and click Next, the configuration utility logs its activities, including stopping and restarting IIS, and reports any problems. Review the summary for any issues in red font. Green font indicates the more interesting logged events. The summary shows any Warnings (W) or Errors (E).
  5. When you're finished, click Done to close the Configuration Utility. 

Manually name IIS tiers

  1. In the Assign IIS applications to tiers window click Manual, then click Next.
  2. Assign IIS Applications to AppDynamics tiers.
    Select a tier on the right and click a business application on the left. The utility highlights the assigned tier in boldface.

    For large IIS installations, use the Max IIS tree depth pulldown to display all the projects. A large tree depth may take some time to view.

    To create new tiers, enter a name and click Add Tier.

  3. When you are done click Next. AppDynamics displays a configuration summary.
  4. On the Configuration Summary window, uncheck Restart IIS if you don't want to immediately restart IIS.
    You may restart later to apply your changes, or they will take effect after a reboot.
  5. If you proceed and click Next, the Configuration Utility logs its activities, including stopping and restarting IIS, and reports any problems.
  6. Review the configuration log summary.
    As it applies the configuration, AppDynamics generates a log of the configuration activities and displays a summary. Review the summary for any issues in red font. Green font indicates the more interesting logged events.  The summary shows any Warnings (W) or Errors (E).
  7. When you are done, click Next. The wizard completes.

Use Config Management

  1. In the Assign IIS applications to tiers window click Register Machine with No Application, then click Next.
  2. On the Configuration Summary window, uncheck Restart IIS if you don't want to immediately restart IIS.
    You may restart later to apply your changes, or they will take effect after a reboot.
  3. Follow the instructions on Manage Configuration for .NET to assign a configuration from the Controller.
    The .NET Agent and .NET Machine Agent do not report metrics to the Controller until after you assign a configuration using the Config Management tool.

For troubleshooting information see Resolve .NET Agent Installation and Configuration Issues.