Session attributes are statistical information about the captured session that is stored as part of each session. By default, Tealeaf provides a set of pre-configured session attributes to monitor data transfer size and rate, application errors, event information, and page information.
- Session attributes are automatically indexed and therefore searchable without searching for the triggering event.
- In addition to the provided session attributes, you can configure up to 64 additional session attributes to be populated by event actions and inserted into the session summary. These user-defined attributes can be used to extend the monitoring capabilities of your Tealeaf solution by capturing session-level information about the visitor experience. Session attributes are populated by event actions.
How session attributes are stored
As the Canister evaluates individual hits from a session, it maintains a set of system and user-defined session attributes. While the session is active, the Canister continues to update these attributes as needed.
- When the session is marked as completed in the Canister, the session attributes are written to the STS file in the
[canisterSummary]section of the file and stored with the session while it exists in Tealeaf. - For active sessions, these values are stored in the Canister's in-memory database.
- RTV presents them as part of the
[CanisterSummary]section, even though their data source has not yet been recorded permanently.
Session attribute reference
Tealeaf accumulates attributes of a session as pages are passed to it for evaluation. These attributes contain useful information about the session, data size, network travel time, and event statistics.
- In the completed session, these attributes are written to the
.STSsection that is part of the session. The primary ones of interest are in the[canisterSummary]section. - To view these attributes in RTV, select View > Session Attributes.
Example
The following example shows a set of session attributes that are displayed in RTV.
[canisterSummary]
TltStsCanisterID=CANISTER.dbs\LSSN_20100930_SIERRA4.dat
TltStsSesnIdx=4603208
TltStsFirstUse=1285847631
TltStsLastUse=1285847720
TltStsNumHits=591
TltStsServerHits=223
TltStsLicensedPage=147
TltStsTxtPages=147
TltStsSynthHits=0
TltStsReqCancelledHits=0
TltStsCUIPages=368
TltStsOtherPages=76
TltStsSesnID=DF2A0DEE773C018CA814B855CEA20AFE
TltStsReqBytes=260409
TltStsRspBytes=4963483
TltStsFactCount=1234
TltStsEventCount=33
TltStsIPaddr=63.194.158.158
TltStsDomain=www.straussandplesser.com
TltStsTLTVID=
TltStsSesnDuration=89
TltStsUserID=8FB06E8D6227D183BA830489FA2484AE
TltStsBrowser=Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.13) Gecko/20101203 Firefox/3.6.13 ( .NET CLR 3.5.30729)
TltStsBrowserOS=WinXP
TltStsBrowserVersion=Firefox3.0
TltStsBrowserType=Firefox
TltStsIsBot=0
TltStsReferer=
TltStsInteresting=Yes
TltStsSessionTimeout=300
TltStsSessionVersion=8.0
TltStsCloseSessionEvent=No
TltStsSessionCloseReason=SessionExpired
TltStsEventUniqueId=6
TltStsEventUniqueId=7
TltStsTrafficType=BROWSER
Definitions
The following table defines the session attributes and provides example values.
| Attribute Name | Example Value | Definition | Auto-Indexed |
|---|---|---|---|
| TltStsCanisterID | CANISTER.dbs\ LSSN_20100930_SIERRA4.dat | The cxImpact canister identifier | Y |
| TltStsSesnIdx | 4603208 | The cxImpact session index identifier | Y |
| TltStsFirstUse | 1285847631 | Timestamp of the first hit in UNIX™ time format | Y |
| TltStsLastUse | 1285847720 | Timestamp of the last hit in UNIX time format | Y |
| TltStsNumHits | 591 | The total number of hits in the session | Y |
| TltStsServerHits | 223 | The total number of hits that are listed on the server | |
| TltStsLicensedPage | 147 | The total number of licensed pages in the session
Note: This attribute applies only if the Licensed Page model of licensing is applied to your Tealeaf solution.
|
|
| TltStsTxtPages | 147 | The total number of text pages in the session | Y |
| TltStsSynthHits | 0 | The total number of synthetic hits in the session.
Synthetic hits are generated by cxConnect for Data Analysis integrations for integrating data from third-party services. |
|
| TltStsReqCancelledHits | 0 | The total number of Req Cancelled hits in the session | Y |
| TltStsCUIPages | 368 | The total number of client user interface hits for the session.
Client user interface hits can be captured if you have deployed CX UI Capture for AJAX to your web application. |
|
| TltStsOtherPages | 76 | The total number of pages that do not fit into the other page categories | |
| TltStsSesnID | DF2A0DEE773C018CA814B 855CEA20AFE | The TLTSID of the session | Y |
| TltStsReqBytes | 260409 | Total request size for all pages | |
| TltStsRspBytes | 4963483 | Total response size for all pages | |
| TltStsFactCount | 1234 | Total count of facts in the session. | |
| TltStsEventCount | 33 | Total count of events that fired in the session. | |
| TltStsIPaddr | 63.194.158.158 | IP of the client, which is taken from the REMOTE_ADDR request value | Y |
| TltStsDomain | www.straussandplesser.com | Domain in which the session was experienced. | Y |
| TltStsTLTVID | N/A | The Tealeaf visitor identifier can be populated if the Tealeaf Cookie Injector is installed and deployed. | Y |
| TltStsSesnDuration | 89 | The session duration, in seconds | Y |
| TltStsUserID | 8FB06E8D6227D183BA83048 9FA2484AE | The unique user identifier that is generated by Tealeaf for the session. | Y |
| TltStsBrowser | Firefox | The browser from which session came (from HTTP_USER_AGENT) | Y |
| TltStsBrowserOS | WinXP | The operating system on which the browser was installed | |
| TltStsBrowserVersion | Firefox3.0 | The version of the browser in use | |
| TltStsBrowserType | Firefox | The type of browser: Firefox, IE, Chrome, or similar |
|
| TltStsIsBot | 0 | If the user agent is a bot, this value is set to 1. Otherwise, it is set to 0. | |
| TltStsReferer | N/A | The referrer IP for the session. | |
| TltStsInteresting | Yes | The session was marked as interesting by at least one event.
Note: This attribute is deprecated and is always set to Yes.
|
|
| TltStsSessionTimeout | 300 | The session timeout setting for the session. The default value is configured through TMS. | |
| TltStsSessionVersion | 10.0 | The version of Tealeaf for which this session was captured. | |
| TltStsCloseSessionEvent | No | Indicates whether the session was forcibly closed by a session close event | Y |
| TltStsSessionCloseReason | SessionExpired | Indicates the reason why the session was closed | |
| TltStsEventUniqueId | 6 | The ID of each event that fired in the session. Event #6 in this case. The Event ID can be found in the tooltip for events that are displayed in the Event Manager. | Y |
| TltStSTrafficType | BROWSER | The type of traffic that is detected in the hit
|
Index-based merge reference
Also known as RTV merge, this form of merging fragments attempts to find matching fragments that are based on a specified request variable that uniquely ties the session fragments together. Typically, this variable is the unique session identifier.
In the Session Attributes window, the index-based reference information is similar to:
[MergeSummary]
NumSessions=3
TotalNumPages=448
[Session0]
SessionIndex=360308
CanisterName=CANISTER.dbs\LSSN_20120213_TYNDALL.dat
[Session1]
SessionIndex=360564
CanisterName=CANISTER.dbs\LSSN_20120213_TYNDALL.dat
[Session2]
SessionIndex=361131
CanisterName=CANISTER.dbs\LSSN_20120213_TYNDALL.dat
| Field | Description |
|---|---|
SessionIndex |
The internal session ID for the specified CanisterName to locate the session |
CanisterName |
The Canister file that contains the listed fragment |
Auto-merge reference
When enabled, auto-merging allows Search Server to attempt to match session fragments 24 hours before or after the main fragment. Auto-merge requires no additional configuration.
In the Session Attributes window, the auto-merge reference information is similar to:
[MergeSummary]
NumSessions=3
TotalNumPages=363
TotalDurationSeconds=22729
TotalDuration=06:18:49
PartialMerge=YES
PartialMergeReason=Merge data size limit exceeded: 16777216
PartialMergeRange=16-25
PartialMergeTotal=29
[Session0]
SessionIndex=361562
CanisterName=CANISTER.dbs\LSSN_20120213_TYNDALL.dat
SearchServer=tyndall:19000
NumPages=86
TimeStamp=2012-02-14 05:40:48
DurationSeconds=915
RawPageStart=0
RawPageEnd=85
[Session1]
SessionIndex=363160
CanisterName=CANISTER.dbs\LSSN_20120213_TYNDALL.dat
SearchServer=tyndall:19000
NumPages=4
TimeStamp=2012-02-14 07:07:14
DurationSeconds=5
RawPageStart=86
RawPageEnd=89
[Session2]
SessionIndex=364296
CanisterName=CANISTER.dbs\LSSN_20120214_TYNDALL.dat
SearchServer=tyndall:19000
NumPages=19
TimeStamp=2012-02-14 08:16:58
DurationSeconds=87
RawPageStart=90
RawPageEnd=108
| Field | Description |
|---|---|
SessionIndex |
The internal session ID for the specified CanisterName to locate the session |
CanisterName |
The Canister file that contains the listed fragment |
SearchServer |
The host name and port number for the Search Server from which the session fragment was retrieved |
NumPages |
The number of pages in the fragment |
TimeStamp |
The timestamp that is associated with the fragment |
DurationSeconds |
The replay length in seconds of the fragment |
RawPageStart |
In the merged session, the starting page number of the content in this fragment |
RawPageEnd |
In the merged session, the ending page number of the content in this fragment |