How To Use AppDynamics for Windows Azure
This topic describes how to get started with AppDynamics for Windows Azure.
Table of Contents
What is AppDynamics?
AppDynamics is an application performance monitoring solution that helps you:
Identify problems, such as slow and stalled user requests and errors, in a production environment
Troubleshoot and isolate the root cause of such problems
There are two components in AppDynamics:
Application Server Agent: The Application Server .NET Agent collects data from your servers. You run a separate Agent on every role instance that you want to monitor. You can download the Agent from the AppDynamics portal.
AppDynamics Controller: The Agent sends its information to an AppDynamics Controller hosted service on Windows Azure. Using a web browser-based console, you log into the Controller to monitor, analyze and troubleshoot your application.
- Visual Studio 2010 or later
- A Visual Studio solution to be monitored
- Windows Azure SDK
- Windows Azure account
Register for an AppDynamics Account
To register for an AppDynamics for Windows Azure account:
Click Try Free or Sign Up for AppDynamics on the Windows Azure Marketplace at https://datamarket.azure.com/browse/Applications.
If you choose Sign Up, you receive a free version of AppDynamics Pro for Windows Azure with full functionality, which downgrades after 30 days to a free version of AppDynamics Lite for Azure with limited functionality. You do not need to provide a credit card for this option. You can upgrade to AppDynamics Pro for Windows Azure at any time.
If you choose Try Free, you receive a free version of AppDynamics Pro for Windows Azure with full functionality. You need to provide a credit card for this option. After 30 days your credit account will be charged for continued use of AppDynamics Pro for Windows Azure, unless you cancel your subscription.
You need one agent license for each role instance that you wish to monitor. For example, a site running 2 Web role instances and 2 Worker role instances requires 4 agent licenses.
On the registration page, provide your user information, a password, email address, company name, and the name of the application you are monitoring as you will publish it with Windows Azure.
Click Register Now.
You will receive your AppDynamics credentials and the AppDynamics Controller URL (host and port) assigned to your account in an email sent to the address you provide on the sign-up page. Save this information.
If you already have AppDynamics credentials from another product, you can sign in using them.
You will also be given an AppDynamics account home page.
You will land on your AppDynamics account home page.
Your AppDynamics account home page includes:
- Controller URL: from which to log into your account on the AppDynamics controller hosted service
- AppDynamics credentials: Account Name and Access Key
- Link to the AppDynamics download site: from which to download the AppDynamics .NET Agent
- Number of days left in your Pro trial
- Links to the AppDynamics on-boarding videos and documentation
You can access your AppDynamics account home page at any time by entering its URL in a web browser and signing in with your AppDynamics credentials.
Download the .NET Agent from AppDynamics
Navigate to the AppDynamics download site. The URL is in your welcome email and on your AppDynamics account home page.
Log in with your AppDynamics account name and access key.
Download the file named AppDynamicsdotNetAgentSetup64.msi. Do not run the file.
Add the .NET Agent to Windows Azure Roles and Modify Startup
This step instruments the roles in your Visual Studio solution for monitoring by AppDynamics. There is no traditional Windows wizard-style installation procedure required to use AppDynamics for Windows Azure.
Either create a new Windows Azure project in Visual Studio or open an existing Windows Azure project.
If you created a new project, add the Web role and/or Worker role projects to the solution.
To each Web and Worker role project that you want to monitor add the downloaded .NET Agent .msi file.
Note that while each role project has a single attached .NET Agent .msi, each role instance in the project requires a separate .NET Agent license.
To each Web and Worker role project that you want to monitor add a text file named startup.cmd and paste the following lines in it:
if defined COR_PROFILER GOTO END
REM Run the agent installer
AppDynamicsdotNetAgentSetup64.msi AD_Agent_Environment=Azure AD_Agent_ControllerHost=%1 AD_Agent_ControllerPort=%2 AD_Agent_AccountName=%3 AD_Agent_AccessKey=%4 AD_Agent_ControllerApplication=%5 /quiet /log d:\adInstall.log
SHUTDOWN /r /c "Rebooting the instance after the installation of AppDynamics Monitoring Agent" /t 0
For each Web and Worker role that you want to monitor, set the Copy to Output Directory property for the AppDynamics agent .msi file and for the startup.cmd file to Copy Always.
In the ServiceDefinition.csdef file for the Windows Azure project, add a Startup Task element that invokes startup.cmd with parameters for each WorkerRole and WebRole element.
Add the following lines:
<Task commandLine="startup.cmd [your_controller_host] [your_controller_port] [your_account_name] [your_access_key] [your_application_name]" executionContext="elevated" taskType="simple"/>
- your controller host and your controller port are the Controller host and port assigned to your account, and your account name and your access key are the credentials assigned to you by AppDynamics. This information is provided in the email sent when you registered with AppDynamics and also on your AppDynamic home page. See Register for an AppDynamics Account.
- your application name is the name you choose for the application. This name will identify the application in the AppDynamics Controller interface.
Your ServiceDefinition.csdef file will look something like this:
Publish the AppDynamics-Instrumented Application to Windows Azure
For each AppDynamics-instrumented role project:
In Visual Studio, select the role project.
Select Publish to Windows Azure.
Monitor Your Application
Log into the AppDynamics Controller at the URL given in your welcome email and on your AppDynamics account home page.
Send some requests to your application so there is some traffic to monitor and wait a few minutes.
In the AppDynamics Controller, select your application.
Monitor your application.
See your AppDynamics account home page for links to documentation and videos.
The latest updates to this document are in the wiki version at http://docs.appdynamics.com/display/ADAZ/How+To+Use+AppDynamics+for+Windows+Azure.