ADC

Configure a stream identifier

You configure a stream identifier to specify parameters for collecting statistical data from requests identified by a given selector. An identifier specifies the selector to be used, the statistics collection interval, the sample count, and the field on which the records are to be sorted.

The Citrix ADC appliance includes the following built-in stream identifiers for common use cases. All the built-in identifiers specify a sample count of 1 and an interval of 1 minute. Additionally, they sort the data on the REQUESTS attribute. They differ only in being associated with different built-in selectors. Each built-in identifier is associated with a built-in selector of the same name (for example, the built-in identifier Top_URL is associated with the built-in selector Top_URL). Following are the built-in identifiers:

  • Top_URL
  • Top_CLIENTS
  • Top_URL_CLIENTS_LBVSERVER
  • Top_URL_CLIENTS_CSVSERVER
  • Top_MSSQL_QUERY_DB_LBVSERVER
  • Top_MYSQL_QUERY_DB_LBVSERVER

For more information about the built-in selectors, see Configuring a Selector.

Note: The maximum length for storing string results of selectors (for example, HTTP.REQ.URL) is 60 characters. If the string (for example, URL) is 1000 characters long, of which 50 characters are enough to uniquely identify a string, use an expression to extract only the required 50 characters.

You cannot modify a built-in identifier’s configuration. However, you can create an identifier with a configuration of your choice.

To configure a stream identifier by using the command line interface

At the command prompt, type the following commands to configure a stream identifier and verify the configuration:

  • add stream identifier <name> <selectorName> [-interval <positive_integer>] [-SampleCount <positive_integer>] [-sort <sort>]
  • show stream identifier <name>

Example

> add stream identifier myidentifier Top_URL -interval 10 -sampleCount 100
 Done
<!--NeedCopy-->

To configure a stream identifier by using the GUI

  1. Navigate to AppExpert > Action Analytics > Stream Identifiers.
  2. In the details pane, do one of the following:
    • To create a stream identifier, click Add.
    • To modify a stream identifier, select the identifier, and then click Edit.
  3. In the Configure Stream Identifier page, set the following parameters:
    • Name
    • Selector
    • Interval
    • Sample Count
    • Sort
  4. Click Create, and then click Close.
Configure a stream identifier