Modern web pages often include a large number of Ajax requests. Not all of these Ajax requests may be equally important to monitor, but they all equally affect license entitlements and restrictions. Thus, you may want to configure which Ajax requests are sent to the Events Service to manage the impact on your overall Events Service usage. 

To do this, you can create rules to specify the requests to be sent to the Events Service, either by excluding a request entirely, including a particular request or a sample of that request types by percentage or by just allowing the request to be sent. In general, the behavior follows this pattern:

  • If no rules are specified, no data on Ajax requests is sent.
  • If exclude rules are specified, and an Ajax request satisfies a rule, that data is not sent.
  • If include rules are specified, any Ajax request that satisfies a rule is sent, based on sampling defined by the percentage indicated in the rule.
  • If both include and exclude rules are specified, an Ajax request that satisfies an include rule but does not satisfy an exclude rule is sent.
  • If you only configure exclude rules and the sample percentage, the non-excluded calls would be sampled at the specified rate.

See Configure Page Identification and Naming for more information about default naming rules and how rules are evaluated.

Access Ajax Requests Rules

  1. Open the browser application in which you are interested.
  2. On the left navigation bar, select Configuration.
  3. Click Instrumentation >.
  4. Select the Ajax > Events Service tab.

Configure Exclude Rules

  1. Click Add to create a new rule. The Exclude Rule popup appears. 
  2. Specify a display name for the rule.
  3. Check Enabled to enable the rule.
  4. Enter a string and select one of the options in the dropdown to match the URLs that you want to exclude from the Ajax requests.
  5. Click OK to save the rule.

Configure Include Rules

  1. From the Events Service Include Rules section, click Add to create a new rule. The Include Rule popup appears.
  2. Give your rule a display name.
  3. Check Enabled to enable the rule. 
  4. For Criteria, enter a string and select one of the options in the dropdown to match URLs for including Ajax requests.
  5. Configure how to name pages:
    • Select one of the options from the dropdown to determine the part of the URL.
    • Select the path segment.
    • Enter the query string to use in the page name.
    • Select the part of the anchor (or none) to use in the page name.
  6. Click Save.