To monitor IIS applications, Windows services, or standalone applications, install the .NET Agent once on each machine that hosts managed .NET applications. At startup, the agent initializes an individual instance of itself for each application running in the CLR.
This page describes a new installation for the .NET Agent using the MSI package.
- To install from the command line, see Unattended Installation for .NET.
- To install the Splunk AppDynamics Site Extension for Windows Azure, see Install the Splunk AppDynamics Azure Site Extension for .NET.
- To install the Splunk AppDynamics .NET Microservices Agent using one of the new Splunk AppDynamics NuGet Packages, see .NET Microservices Agent.
- To upgrade, see Upgrade the .NET Agent.
Installation Overview
Restart instrumented applications.
For Microsoft IIS, the configuration utility provides an option to restart IIS or not.
If you do not restart IIS, monitoring does not begin until the next time IIS restarts.
You must restart Windows services and standalone applications manually.
Prepare to Install
Review these requirements before you install the .NET Agent:
- You must enable Windows Management Instrumentation service on the machine where you are installing the .NET Agent, and the service must be running.
To run the .NET Agent and the Machine Agent on the same machine, you must enable .NET Compatibility Mode on the Machine Agent. See .NET Compatibility Mode.
Install the .NET Agent
- Download the MSI installer package from the Cisco AppDynamics Download Center.
- Run the MSI installer package.
- Read the End User Agreement and click to accept. Then, click Next.
(Optional) On the Confirm location panel, change the .NET Agent installation directories, including:
- Destination directory for the .NET Agent executables and supporting files.
- 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 Cisco AppDynamics Agent Configuration utility.
- On the User Account Control panel, click Yes 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, Splunk AppDynamics recommends you launch the Cisco AppDynamics Agent Configuration utility.
If you encounter problems installing, see Troubleshoot .NET Agent Issues
Configure the .NET Agent
Launch the Splunk AppDynamics Agent Configuration utility to configure the .NET Agent.
- For Microsoft IIS applications, see Configure the .NET Agent.
- For Windows services or standalone applications, see Configure the .NET Agent for Windows Services and Standalone Applications.
