On this page:

Related pages:

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>
CODE

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.