By default, the first 1000 records going through debugged edges are saved to debug files. The exception are graphs running on the Server via automated process (e.g. scheduling, listening) where debugging on edges is disabled by default.
You can restrict the data records that will be saved to debug files. You can set it up in the Properties tab of any debug edge, or you can right-click the debugged edge and set it up in Debug properties accessible from the context menu.
To avoid saving all data records, you can set any of the following four edge attributes either in the Properties tab or in the Debug properties dialog: Debug filter expression, Debug last records, Debug max. records and Debug sample data.
If you specify a filter expression for an edge, data records that satisfy the specified filter expression will be saved to the debug file. Those that do not satisfy the expression will be ignored.
If a filter expression is defined,
either all records that satisfy the expression (Debug sample data set to
or only a sample of them (Debug sample data set to
true) will be saved.
The filter expression is defined with the help of Filter Editor.
Figure 31.3. Filter Editor
The Filter Editor consists of three panes.
The left pane displays a list of record fields, their names and data types.
You can select any record field by double-clicking or dragging and dropping.
Then a field name appears in the bottom area.
The field name consists of a dollar sign, followed by a type of the port (in or out),
port number and the name itself.
The right pane displays a list of available CTL functions. Below this pane, there are both comparison signs and logical connections. You can select any of the names, functions, signs and connections by double-clicking. After that, they appear in the bottom area.
You can work with functions, operators and fields in the bottom area and complete the creation of the filter expression. The filter expression is validated on the fly.
Example 31.1. Debug filter expression
The old version of CTL (CTL1) is deprecated and should not be used.
The Filter Editor is described in the documentation on Filter.
If you set the Debug last records property to
data records from the beginning will be saved to the debug file.
By default, the records from the end are saved to debug files.
The default value of Debug last records is
Remember that if you set the Debug last records attribute to
data records will be selected from the beginning with a greater frequency than from the end.
Alternatively, if you set the Debug last records attribute to
or leave it unchanged, they will be selected more frequently from the end than from the beginning.
You can also set up a limit on the number of data records that will be saved into a debug file.
These data records will be taken either from the beginning
(Debug last records is set to
or from the end (Debug last records has the default value
or it is set to
If the Debug max. records is set up in the Properties tab, all edges of the graph are affected.
If the Debug max. records is set up on an edge, only the debugging on the edge is affected.
If the property is set up in the Properties tab and on the edge, the value set up on the edge level has a higher priority.
If you set the Debug sample data attribute to
the Debug max. records attribute value is only the threshold
that limits how many data records could be saved to a debug file.
Data records will be saved at random, some of them will be omitted, others will be saved to the debug file.
In this case, the number of data records saved to a debug file will be less than or equal to this limit.
If you do not set any value of Debug sample data,
or if you set it to
the number of records saved to the debug file will be equal to the Debug max. records attribute value
(if more records than Debug max. records go through the debug edge).
The same properties can also be defined using the context menu by selecting the Debug properties option. After that, the following dialog will open:
Figure 31.4. Debug Properties Dialog