How to run a Job in Traces Debug mode - 6.2

The traces feature allows you to monitor data processing when running a Job in the
Integration perspective of Talend Studio.

It provides a row by row view of the component behavior and displays the dynamic
result next to the Row link on the design workspace.

This feature allows you to monitor all the components of a Job, without switching to
the debug mode, hence without requiring advanced Java knowledge.

The Traces function displays the content of processed
rows in a table.

Note

Exception is made for external components which cannot offer this feature if their
design does not include it.

You can activate or deactivate Traces or decide what
processed columns to display in the traces table that displays on the design workspace
when launching the current Job.You
can either choose to monitor the whole data processing or monitor the data
processing row by row or at a certain breakpoint. For more information about the row
by row execution of the Traces mode, see Row by row monitoring. For more
information about the breakpoint usage with the Traces mode, see Breakpoint monitoring.

To activate the Traces mode in a Job:

Click the Run view.

Click the Debug Run tab to access the debug
and traces execution modes.

Click the down arrow of the Java Debug button
and select the Traces Debug option. An icon
displays under every flow of your Job to indicate that process monitoring is
activated.

Click the Traces Debug to execute the Job in
Traces mode.

To deactivate the Traces on one of the flows in your
Job:

Right-click the Traces icon under the
relevant flow.

Select Disable Traces from the list. A red
minus sign replaces the green plus sign on the icon to indicate that the
Traces mode has been deactivated for this
flow.

To choose which columns of the processed data to display in the traces table, do the
following:

Right-click the Traces icon for the relevant
flow, then select Setup Traces from the list.
The [Setup Traces] dialog box appears.

In the dialog box, clear the check boxes corresponding to the columns you do
not want to display in the Traces table.

Click OK to close the dialog box.

Monitoring data processing starts when you execute the Job and stops at the
end of the execution.

To remove the displayed monitoring information, click the Clear button in the Debug
Run tab.

Row by row monitoring

Talend Studio enables you to monitor your data
process row by row.

To manually monitor the data processing of your Job row by row, simply click the
Next Row button and the processed rows will
display below its corresponding link on the design workspace.

You can go back to previous rows by clicking the Previous
Row button, within a limit of five rows back.

If, for any reason, you want to stop the Job in progress, simply click the
Kill button; if you want to execute the Job to
the end, click the Basic Run button.

To remove the displayed monitoring information from the design workspace, click
the Clear button in the Debug
Run tab.

Note

You can monitor data processing the same way from inside the tMap editor. For further information, see Previewing data.

Breakpoint monitoring

If you want to monitor your data processing at certain defined breakpoints, you
can execute your Job in Traces Debug mode and the Job will automatically be executed
until the next breakpoint.

Before monitoring your data processing at certain breakpoints, you need to add
breakpoints to the relevant Job flow(s).

This will allow you to automatically stop the Job at each defined breakpoint. This
way, components and their respective variables can be verified individually and
debugged if required.

Note

You can add breakpoints only in Jobs, but not in Routes.

To add breakpoints to a link:

Right-click it on the design workspace, and select Show Breakpoint Setup on the popup menu.

On the Breakpoint view, select the
Activate conditional breakpoint check
box and set the Conditions in the
table.

A pause icon displays below the link on which the break is added when you
access the Traces mode.

Once the breakpoints are defined, switch to the Traces mode. To do so:

Click the Run view, and the Debug Run tab.

Click the down arrow of the Java Debug
button and select the Traces Debug
option.

Click the Traces Debug to execute the Job
in Traces mode. The data will be processed until the first defined
breakpoint.

Click the Next Breakpoint button to
continue the data process until the next breakpoint.

If, for any reason, you want to stop the Job in progress, simply click the
Kill button; if you want to execute the
Job to the end, click the Basic Run
button.

To remove the displayed monitoring information from the design workspace,
click the Clear button in the Debug Run tab.