Download PDF
Download page Name .NET Tiers.
Name .NET Tiers
In AppDynamics, a tier represents a service in your application environment, such as an ASP.NET front end, WCF service, .NET web service or standalone application. Tiers appear on flow maps, so you should name your tiers in a way that is logical and easy to understand for your users.
Use the AppDynamics .NET Agent Configuration Utility to map IIS sites to tiers, as described in Configure the .NET Agent. Some manual configuration options require you to edit the config.xml
file, as described in 'Where to Configure Agent Properties' on Administer the .NET Agent.
Name IIS Tiers Automatically
Name IIS tiers automatically using the configuration utility. Choose Automatic on the Assign IIS applications to tiers window. The .NET Agent instruments all IIS sites except the Default Web Site and names the tiers using the following scheme:
IIS site/app
The agent omits app
when the application is the root application for the IIS site.
Use this option in the following cases:
- you are new to AppDynamics and the .NET Agent.
- you want to instrument all IIS applications and your team understands the form of IIS application names.
Automatic Tier Naming for the .NET Agent doesn't automatically assign a virtual application to a tier. If you want to map virtual applications to tiers, see Name IIS Tiers Manually.
Name Azure Tiers Automatically
The .NET Agent automatically names Azure tiers using the following schemes:
- Cloud Services:
Azure role name
- App Services:
Azure site name
If you want to customize tier naming for Azure, see Edit the config.xml directly under Name IIS Tiers Manually.
Name IIS Tiers Manually
The .NET Agent offers two options for naming IIS tiers manually, using the configuration utility of editing the config.xml file directly.
Use the configuration utility
On the Assign IIS applications to tiers page, choose Manual. The configuration utility lets you create new tiers and assign IIS applications to tiers.
Use this option in the following cases:
- You do not want to instrument all IIS applications on the server
- You want custom tier names
- You want to assign multiple applications to a single tier
Edit the config.xml directly
Use this option to customize Azure tier names or in cases where it is not feasible to use the configuration utility.
For each IIS tier you want to instrument, add an application element as a child element of the IIS applications element in the config.xml
file. You can specify a static IIS tier name or a regular expression which is helpful for variable Azure site names. For the full syntax and an example, see 'IIS Applications Element' on .NET Agent Configuration Properties.
For example, to add all Azure sites that begin with MvcWebRole
to a tier named My Azure Tier
using a regular expression:
<?xml version="1.0" encoding="utf-8"?>
<appdynamics-agent xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<controller host="nativedemocon1.cloudapp.net" port="8090" ssl="false">
<application name="AzureEmailService" />
<account name="customer1" password="APJC234bcd$123" />
</controller>
<machine-agent />
<app-agents azure="true" azure-role-name="" azure-role-instance-id="">
<IIS>
<applications>
<!-- Configure IIS tier names with a regular expresson. -->
<application path="/" site="MvcWebRole.*" site-regex="true">
<tier name="My Azure Tier"/>
</application>
</applications>
</IIS>
<standalone-applications>
<standalone-application executable="WaWorkerHost.exe">
<tier name="" />
</standalone-application>
</standalone-applications>
</app-agents>
</appdynamics-agent>
Name Windows Service or Standalone Application Tiers
See Configure the .NET Agent for Windows Services and Standalone Applications for information on naming tiers for each instrumented Windows service or standalone application manually in the config.xml.