How to run a Job in Traces Debug mode

Talend Data Management Platform Studio User Guide

EnrichVersion
6.2
EnrichProdName
Talend Data Management Platform
task
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

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:

  1. Click the Run view.

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

  3. 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.

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

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

  1. Right-click the Traces icon under the relevant flow.

  2. 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:

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

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

  3. 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.

To add breakpoints to a link:

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

  2. 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:

  1. Click the Run view, and the Debug Run tab.

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

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

  4. 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.