Tracer tool
Tracing services
|
|
You can use the Tracer to monitor any active requestor session. However, a service usually runs in a new requestor session with a requestor ID that is not created until the service begins processing. At that point, the processing that the service performs in that requestor session occurs so quickly (in less than one second), it can be hard to catch the event to trace it.
In this situation, it is recommended to use the Trace Open Rule feature to trace the service rule. This feature can be used to trace a service request that is invoked from an external client application.
To use the Trace Open Rule feature to trace and debug a service rule:
- Open the service rule. Note which RuleSet it belongs to.
- Select > Trace Open Rule. The Tracer tool window opens.
- Click Settings () to open the Trace Options panel.
- Select Services in the Rule Types area.
- In the RuleSets to Trace section, select the RuleSets that contain the service rule and service activity.
- Click OK to close the Trace Options panel.
- Run the rule.
- Watch the Tracer display as the rule runs. The window includes lines for the start and end of each service rule execution, lines for the start and end of request mapping, lines for the start and end of response mapping, and (if these options are selected in the Trace Options panel) lines for the start and end of parse rules, XML Stream rules, and HTML rules.
The Tracer offers the following trace options for services:
- Services — The Tracer adds steps for when the service invocation begins and ends. Nested within those steps are entries that show when the inbound data mapping begins and ends, and when the outbound data mapping begins and ends.
- Parse Rules — The Tracer adds steps when a parse rule (delimited, structured, or XML) begins and ends processing.
- Stream Rules — The Tracer adds steps when an HTML rule or XML Stream rule begins and ends processing.
For more information about tracing and testing services, see Testing Services and Connectors, a document posted on the PDN.
Setting Tracer options
Unit testing a rule with the Run Rule feature
Debugging with the Tracer