Starting, Stopping, and Restarting a Transaction Trace
Contents
apmsaas
Contents
2
2
To run a Transaction Trace session, you specify the agents whose transactions you want to trace, and how long to capture the data. You can specify filter options to limit tracing to transactions that:
- exceed a threshold execution time you define
- match parameter values such as User ID, request headers information, etc.
- have errors, if ErrorDetector is enabled
When the Transaction Trace Session starts, Introscope captures Transaction Trace data that is specified in the agent profile, for each transaction. The transactions that match the filter criteria appear in the Transaction Trace Viewer window, and are saved in the Transaction Events database.
Starting a Transaction Trace Session
To start a Transaction Trace session:
- Select Workstation > New Transaction Trace Session.The New Transaction Trace Session window opens.
- In the Trace transactions section of the window, specify the minimum duration for transactions to be traced. Select milliseconds or seconds from the drop-down list.Note:Sub-second durations can have a negative impact on performance.
- To specify a transaction filter, select the checkbox to the left of the dimmed drop-down menu reading "User ID" in theTrace transactionssection, and select a type from the list:
- User ID -- enter an operator and a parameter value.
- Session ID -- enter an operator and a parameter value.
- URL, or URL Query -- enter an operator and a parameter value.
- Request Header -- enter a data type name, a condition, and a value.
- Request Parameter -- enter a data type name, an operator, and a parameter value.
- Session Attribute -- enter a data type name, an operator, and a parameter value.Note:Data is only available for use in filters when the agent is configured to capture it.
The filter conditions are as follows:- equals -- Transactions in which the parameter value matches the string specified are traced.
- does not equal -- Transactions in which the parameter value does not match the specified string are traced.Note:Transactions that do not include the parameter to which the filter applies are also traced.
- contains -- Transactions in which the parameter value contains the specified string are traced.
- does not contain -- Transactions in which the parameter value does not contain the specified string are traced.Note:Transactions that do not include the parameter to which the filter applies are also traced.
- starts with -- Transactions in which the parameter value starts with the specified string are traced.
- ends with -- Transactions in which the parameter value ends with the specified string are traced.
- exists -- Transactions that include the parameter to which the filter applies are traced, regardless of the parameter value.
- does not exist -- Transactions that do not include the parameter to which the filter applies are traced.
- Enter the trace session duration in minutes.
- In the Trace Agents section, select one or more agents for which to trace transactions:
- To trace all agents that support Transaction Tracing, select Trace all supported Agents. This option traces supported agents that are currently connected, and any that connect during the Trace session.
- To trace selected agents, select Trace selected Agent(s) and select agents from the list (CTRL + click to select multiple agents).
- Select OK to start the Transaction Trace session.Transaction Trace results appear in the Transaction Trace Viewer.In Live mode, transaction trace events from the last 20 minutes are displayed. Transaction trace event older than 20 minutes are not displayed in live mode. No more than 500 transaction trace events are displayed.
Stopping a Transaction Trace session
To stop a Transaction Trace session:
- Click Stop, or
- Select Trace > Stop Tracing Session.
Restarting a Transaction Trace session
Restarting the Transaction Trace session resets the timeout to the user-defined time period and continues to trace Transactions in the targeted agents using the same threshold criteria.
You can restart a Transaction Trace session:
- after a session has timed out.
- to restart a session you have stopped.
- to restart an in-progress session.
To restart a Transaction Trace session:
- Click Restart, or
- Select Trace > Restart Tracing Session.