On this page:
You can use Microsoft Visual Studio with the AppDynamics for Windows Azure NuGet Package to add the .NET Micro Agent directly to projects you plan to deploy to Windows Azure. The AppDynamics for Windows Azure NuGet Package works for Azure App Service (formerly Azure Websites): Web Apps, Web Jobs, and API Apps.
Prepare to Install the NuGet Package
To install the AppDynamics for Windows Azure NuGet package you need the following:
- Connection information for your AppDynamics Controller version 4.4
- Visual Studio 2012 or later
- A Visual Studio solution to monitor
The user account running Visual Studio must have the following permissions to the solution:
- Read and Write permissions to each project directory
- Read and Write permissions to each Visual Studio .NET C# Project (*.csproj) file
- Read and Write permissions to the Service Definition (ServiceDefinition.csdef) file
- Windows Azure SDK
- Windows Azure account
If you have installed the Visual Studio Standalone Profiler, you must uninstall it and remove related registry entries.
These instructions assume you are familiar with NuGet package management in Visual Studio and with the Microsoft Azure Portal. You can also try the step-through tutorial on how to instrument an App Service on the community knowledgebase.
Add the .NET Micro Agent to Your Azure Solution
Use the NuGet package manager to browse the nuget.org package source and install the AppDynamics.WindowsAzure v.4.4.x package to your Azure solution in Visual Studio.
For details about managing NuGet packages, see the documentation for your version of Visual Studio.
The AppDynamics.WindowsAzure package installation prompts you as follows:
- The installer may ask you to verify your changes. If so, click OK.
- Click I accept to agree to the terms of the license.
- Enter the connection information for your AppDynamics Controller on the AppDynamics for Windows Azure window. For more information, see Agent-to-Controller Connections.
- Check Test Connection to validate your Controller connection information. When you click Apply, the package installer tests the connection and only saves valid configuration settings.
- (Optional) Change the Application Name. AppDynamics automatically populates Application Name with the name of your Windows Azure solution.
- If you are installing the package for an Azure App Service (or Website), check Azure Web App.
- When you click Apply to save your settings, the package manager installs the .NET Micro Agent into your project. All files install to the following path:
By default, the .NET Micro Agent names Azure tiers as site name. The .NET Micro Agent names Azure nodes by machine name appended with the website hostname. For web jobs, the job name is appended to the machine and website hostname.
After you finish any configuration changes, publish your solution to Windows Azure.
For App Service, see Install AppDynamics for Azure App Service (Move).
For Service Fabric, see Install AppDynamics for Azure Service Fabric (Moving).