Dimensions

A dimension is a list of values that are associated with an event. When an event is triggered, the detected value is reported into a dimension.

Dimension values and report groups

The values to detect are configured in the Values tab in the Discover Event Manager. The report groups into which the values are reported are specified in the Report tab of the Discover Event Manager. A dimension can belong to multiple report groups, which can be associated with multiple events.

Unbounded Lists

An unbounded list dimension type is generated by extracting values in the transaction stream for the dimension and building a list for each hourly time interval. If the limit for the dimension is configured to be 1000, the first 1000 values for a dimension that are detected in an hour become the available dimension values for that dimension during that period. Subsequent values that had not been previously detected during the hour are mapped to a single fixed value, TLT$LIMIT.

Value Lists

A value list dimension type contains a pre-defined set of values that are the only accepted values for the dimension. The list of the states of the United States of America is an example of this type of dimension. When an event fires, the values that are assigned to the event must come from one of these listed values.

Value lists can be one of these types:

Values to Record
Description
Whitelist + Observed Values
Record values that are on the whitelist for the dimension, and also as non-blacklisted values detected in the capture stream.
Whitelist Only
Record only values that are displayed on the specified whitelist for the dimension.
Group Lists - Text
Populate the dimension from a group list of text values that are configured for the dimension.
Group Lists - Numeric
Populate the dimension from a group list of numeric values that are configured for the dimension.

Changes to Dimensions

In Release 7.1 and Release 7.2, Discover supported the creation and reporting of four sets of references: TLT_Application, TLT_URL, TLT_Server, and TLT_Host. Essentially, these reference sets were data dimensions. In earlier releases, these reference dimensions were common to all events.

When the Discover Reference session agent was enabled in the pipeline, you can map detected values for the following dimensions to a predefined list of values. The mapped value was inserted into the corresponding name-value pair in the [TltRef] section of the request.

The reference dimensions from earlier releases are available in the following dimensions, which can be added to reports:

Table 1. Changes to Dimensions

REQTEXT

Dimension Old Version New Version
Application TLT_Application Application
Path TLT_URL URL
Server TLT_Server Server
Host TLT_Host Host

These predefined lists can be generated from values that are detected in session data and logged. Various reports and multiple Discover products used these reference dimensions.

The new reporting model provides much greater flexibility in the dimensions that you can use.