Tracer settings management

The Tracer toolbar is located above the log display, in the upper-right corner. The toolbar consists of buttons that enable you to manage the events that it captures. 

In the following image, click the + icons to learn more about the Pause, Clear, and Save buttons on the Tracer toolbar:

Before you begin capturing events, refine what you need to capture by indicating the types of events and break Conditions to log by using the Settings, Breakpoints, Watch, and Remote Tracer buttons on the Tracer toolbar.

In the following image, click the + icons to learn more about the Settings, Breakpoints, Watch, and Remote Tracer buttons on the Tracer toolbar:

Use Settings to display the configuration options for your trace, to include event types and Rules, and to enter the number of lines of data to display. The Settings button is displayed in the following figure:

You can use the settings options to reduce the amount of information captured. You can filter tracer display results by event, event type, Ruleset, and break Conditions. For example, when you want to exclude local variables from your trace, or you want to view which activities run but not their Steps. Selecting break Conditions stops the tracer when the system generates an error.

The following two images provide a comparison of the number of events traced before and after activity Steps are removed from the list of events to trace. In the image on the left, the trace includes Steps for all of the activities performed during the trace. The Steps for the Finish Assignment activity are located on rows 25 through 32.

The image on the right shows the trace results for the same activity when activity Steps are removed from the events to trace. The Finish Assignment activity receives one line for the activity itself. It is located on row 7.

In the center of the following image, slide the vertical line to compare the Tracer logs:

In the following image, click the + icons to learn more about the  Events to Trace, Break Conditions, General Options, Event Types to Trace, and Rulesets to Trace:

You can configure a Breakpoint or a series of breakpoints to focus on an activity or series of activities that you want to trace. When the activity starts, the Tracer window highlights the event and tracing is paused. Tracing resumes when you click Play or when an hour elapses, whichever occurs first, providing you the ability to monitor the progress of the configured activity. The following figure shows how to access Breakpoints from the Tracer tool bar:

In the following example, a breakpoint is configured for the SendSimpleEmail activity in the Work class. The beginning of the Step event is highlighted in the following figure:

The Watch Function is similar to breakpoints, but the watch monitors a specific property value or values to determine if and when the property value changes. This option is useful to check for property values, calculation consistency, and patterns in the trace. The following figure shows how to access Watch from the Tracer tool bar:

In the following image, a watch is configured for the property .BiweeklySalary on the pyWorkPage. You can add other variables to watch or remove selected variables. Close saves the configured variables:

The following image shows the Property Inspector. It indicates that the property value changed from zero to 2083.33:

The OldValue and CurrentValue fields in the Property Inspector update whenever the property changes value.

Check your knowledge with the following interaction: