To monitor IIS applications, Windows services, or standalone applications, install the AppDynamics .NET Agent once on each machine that hosts managed .NET applications. At start up, the agent initializes an individual instance of itself for each application running in the CLR.
This topic describes a new installation for the .NET Agent.
- To install from the command line, see Unattended Installation for .NET.
- To install the AppDynamics Site Extension for Windows Azure, see Install the AppDynamics Azure Site Extension for .NET.
- To install the AppDynamics .NET Microservices Agent using one of the new AppDynamics NuGet Packages, see .NET Microservices Agent.
- To upgrade, see Upgrade the .NET Agent.
- Install the the agent.
- Configure the agent.
- Restart instrumented applications.
- For IIS, the configuration utility gives you the option to restart IIS or not.
- If you don't restart IIS, monitoring doesn't begin until the next time IIS restarts.
- You must restart Windows services and standalone applications manually.
Prepare to Install
Review the following requirements before you install the .NET Agent:
You must enable the Windows Management Instrumentation service on the machine where you're installing the .NET Agent and the service must be running.
- If you want to run the .NET Agent and the Standalone Machine Agent on the same machine, you must enable .NET Compatibility Mode on both the machine and the Controller. For more information, see .NET Compatibility Mode.
- (Note: This requirement applies to .NET Agent versions 4.4.0.x - 4.4.2.x. It does not apply to 22.214.171.124 and later.) The .NET Agent requires the Universal C Runtime. If the installer warns you that it is not installed on your Windows server you can:
Install the .NET Agent
- Download the MSI installer package from the AppDynamics Download Center.
- Run the MSI installer package.
- Read the End User Agreement and click to accept. Click Next.
On the Confirm location window, optionally change the .NET Agent installation directories:
See .NET Agent Directory Structure for the default directories.
- the destination directory for the .NET Agent executables and supporting files.
- the parent directory for local data including agent configuration files and log files.
You can also change the destination of the logs directory later using the AppDynamics Agent Configuration utility.
- Click Yes on the User Account Control window to allow the installer to make changes to the computer.
If the current account does not have administrator privileges, the installer prompts you to supply the password for an administrator account.
- Wait for the installation to complete.
- For new installs, AppDynamics recommends you launch the AppDynamics Agent Configuration utility.
If you encounter problems installing, see Resolve .NET Agent Installation and Configuration Issues.
Configure the .NET Agent
Launch the AppDynamics Agent Configuration utility to configure the .NET Agent.
- For IIS applications, see Configure the .NET Agent.
- For Windows services or standalone applications, see Configure the .NET Agent for Windows Services and Standalone Applications.