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:
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.