This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

You can configure the display names by which various pages and iframes are referred to and sorted in controller lists and dashboards.

You can:

  • Use the AppDynamics default naming rule, which you can leave as is or modify.
  • Create custom include rules to override the default convention.
  • Create custom exclude rules to exclude from monitoring pages that meet certain criteria.
  • Disable the default naming configuration and use only your custom include rule(s).

In this topic, the term "pages" includes iframes and base pages.

No matter how the page is named, AppDynamics always reports the page name in lowercase.

Access Exclude/Include Rules

  1. Open the browser application in which you are interested.

  2. On the left navigation bar, click Configuration.

  3. Click Instrumentation >.

  4. From the Base Page and iFrames tab, you can define include/exclude rules or modify the Default Naming Configuration.

To save any configuration changes, click Save.

Logic of Exclude/Include Rules Evaluation

This is the order in which AppDynamics evaluates the page naming rules.

Default Page Naming Rules

If you enable the default naming configuration and do not modify it, AppDynamics identifies and names your pages using the first two segments of the page URL.

You can modify the default configuration by double-clicking Default Naming Configuration in the Include Rules section. This opens the Include Rule popup, where you can select the dropdown using parts of the URL to include the protocol or domain in the name, use different segments of the URL, or include query parameters or anchors in the name.  

You can also choose the dropdown using a Regex match on the URL to match page names by running a regular expression.

If you do not want to use the default convention at all, disable it by clearing the Enabled check box. In this case, you must configure at least one custom page naming rule so that AppDynamics can identify and name pages.

Custom Include Rules

You can create custom include rules for identifying and naming pages. 

To create a custom include naming rule, from the Include Rules section, click Add. Then you use the same Include Rule popup to configure the custom include rule to identify and name the page.

The order of the include rules in the list determine their priority: The rules at the top are evaluated first, and the rules at the bottom are evaluated last. You cannot change the priority of Default Naming Configuration, but you can modify or disable it.

Example Include Rule

You might have multiple pages that include search/r/region in their URLs, so search/r/region01, search/r/region23, and so forth. You want to name all the pages from that set as a single page named search/r/region. By selecting the dropdown using a Regex match on the URL, you can enter a regular expression to remove the domain name and the number at the end of the URL, grouping all your /search/r/region URLs into one set.  Because all the URLs contain search/r/region, AppDynamics now collects information for them all under the single page name search/r/region. Otherwise, it would use the default page naming rule, or, a rule with higher priority.

  •  URL strings are case-sensitive.
  • If Don't use the anchor and Don't use the URL are checked, and Show Domain is unchecked, the page is named with the Name of the custom rule.
  • Beacons for older browsers (primarily Internet Explorer 6-8) are sent using image requests, and therefore, have an inherent length limitation. To manage this limitation, Browser RUM does not support URLs longer than 180 characters, page names longer than 50 characters, and user data longer than 128 characters for these browsers.

Custom Page Exclude Rules

You can configure custom exclude rules for pages in the same way you configure include rules. Any page with a URL matching the configuration is excluded from monitoring.