Accessing the Error Recovery Management page - 6.3

Talend Administration Center User Guide

EnrichVersion
6.3
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend Real-Time Big Data Platform
task
Administration and Monitoring
Deployment
EnrichPlatform
Talend Administration Center

Talend Administration Center provides you with an Error Recovery Management page where you can recover all job executions ended in failure.

You can access this page through other different pages in Talend Administration Center, namely Job Conductor, Monitoring and Task execution monitoring.

Accessing Error recovery Management from the Job Conductor page

  1. In the Menu tree view, expand Job Conductor and click Job Conductor to display the list of scheduled tasks for deploying and executing Jobs on remote servers.

  2. On the list, select the Job of which you want to recover the execution.

  3. On the toolbar, click Recover last execution to display the Error Recovery Management page.

Accessing Error Recovery Management from the Task execution monitoring page

  1. In the Menu tree view, expand Monitoring and Task execution monitoring menu items and click Execution History to open a tabular list that displays all scheduled tasks, whether triggered or not.

  2. In the Actions column, click that corresponds to the Job you want to recover.

    The Error Recovery Management page opens.

The following figure illustrates an example of the Error Recovery Management page.

This page presents two horizontal parts: on the upper part, the Task execution monitoring list and, on the lower part: Execution Info and Recovery checkpoints tabs. See the following sections for detail description of the views associated with these tabs.

Note

The Task execution monitoring list remains on the upper half unless you expand either of the two views using the button.

For more information about the Task execution monitoring list, see Accessing the execution monitoring grid and examining collected data. For more information on how to change the display and filter the Task execution monitoring list, see Limiting the number of tasks in the execution monitoring list and Customizing the display of the execution monitoring list.

How to access the Execution info view

From the Error Recovery Management page, you can access a view that displays the execution information of any of the executions listed in the page.

To access the Execution info view, complete the following:

  1. From the Error Recovery Management page, select the Job for which you want to display the execution information.

  2. In the lower part of the page, click the Execution info tab.

    A read-only view of the execution information of the monitored Job displays.

    The following figure shows an example of the Execution Info view.

    The Execution info view shows the execution details at the task level and at the Job level.

    Note

    The Context Parameters area in the Execution info view shows only the context variables used in the father Job, if any. All context parameters used in the child Jobs linked to the father Job will not show in this view, however, it is possible to show them in the Recovery checkpoints view. For more information, see How to display context information of a father or child Job.

  3. By clicking the or button, you can respectively expand or collapse some informative fields related to the selected task, execution of the associated Job, JVM parameters, or context parameters.

  4. Click the button to display the Execution info view in full size on the web page.

    Note

    The Execution info provides, for the time being, a static display of task execution history. To refresh the display, click the Refresh button.

How to access the Recovery checkpoints view

To access the Recovery checkpoints view, do the following:

  1. From the Error Recovery Management page, select the Job for which you want to display the recovery checkpoints.

  2. In the lower part of the page, click the Recovery checkpoints tab.

    The recovery checkpoints of the monitored Job are listed, along with job execution logs if any.

    Note

    If the checkpoint list does not appear, click the Refresh button of the Recovery checkpoint view.

The following figure illustrates an example of the Recovery checkpoints view.

Note

You can click the button to the right of the view to open the information panel.

This view provides the following:

  • at the top, a list of the checkpoints initiated on the trigger connections that are set when designing the Job in Talend Studio. For more information on this list, see How to access the checkpoint list.

  • in the Job panel below the checkpoint list, a capture of the monitored Job including a icon on every trigger connection initiated as a checkpoint when designing the Job in Talend Studio,

  • in the information panel to the right, the detail of any event (check point, user defined log, the start or end of the Job) that you select in the job capture or in the checkpoint list. For more information on the information panel, see How to display the detail of a specific recovery event. For more information on the checkpoint list, see How to access the checkpoint list.

How to access the checkpoint list

To access the Recovery checkpoints list, complete the following:

  1. From the Error Recovery Management page, select the Job for which you want to display the recovery checkpoints in the Task execution monitoring list.

  2. In the lower part of the page, click the Recovery checkpoints tab.

    The recovery checkpoints of the monitored Job are listed, along with job execution logs if any.

    Note

    If the checkpoint list does not display, click the Refresh button of the Recovery checkpoint view.

  3. Click the button to display the Recovery checkpoint tab in full size on the web page.

    Note

    The events recorded by default in this list are of two types: either Checkpoint or System log. But you can list other types of events if you click on the toolbar and select Show other logs from the contextual menu.

The Recovery checkpoints list provides the following information:

Column

Description

Event date

The date and time of an event taking place during the execution of the monitored Job.

Type

Type of the recorded events: either Checkpoint or System log (tWarn messages).

Note

If you want to list logs other than the above two types, click on the toolbar and select the Show other logs check box in the contextual menu.

Status

Execution status of the event:

: fatal error.

: invalidated checkpoint.

: validated checkpoint that is set as the start for the recovery operation.

Start component

Name of the component at which job execution will be recovered.

Job

Name of the executed Job.

Label

Name of the checkpoint you entered in the Label field in Talend Studio. For more information, see Talend Studio User Guide.

Failure instructions

The information you typed in the corresponding field in Talend Studio. For more information, see Talend Studio User Guide.

Log priority

Status of the priority of the log:

: Job that has fallen in fatal error.

: Job that has fallen in error and not completed.

Message

The message corresponding to the log priority icon.

Stack trace

Detailed diagnostic message.

Error code

The error code defined in the Basic settings of the tDie component in Talend Studio.

Project

Name of the project containing the selected Job.

Version

Version of the Job as defined in your Talend Studio.

Context

Name of the context as defined for this Job in your studio.

Virtual server

Name of the virtual server, if any

How to display the detail of a specific recovery event

The event information panel associated with the Recovery checkpoints view provides detailed information of each recovery event listed in the recovery checkpoint list. These events include checkpoints, user defined log, job start or end.

Note

The events recorded by default in the Recovery checkpoints list are of two types: either Checkpoint or System log. But you can list other types of events if you click on the toolbar and select Show other logs from the contextual menu.

To display the information related to any recovery event, complete one of the following:

  1. From the Recovery checkpoints list, click the recovery event you want to display its detail, or

  2. Click the warning icon or the checkpoint icon from the job capture in the Recovery checkpoints view.

The following figure presents an example of the event information panel.

Note

The Context Parameters area shows the context variables used in the father Job or any of the child Jobs linked to it. For more information, see the following section.

How to display context information of a father or child Job

Talend Administration Center enables you to display the context parameters used in the father Job or any of the child Jobs linked to it.

To display the context parameters of a Job, complete the following:

  1. On the toolbar of the Recovery checkpoints list, click and select the Show lines with context information check box from the contextual menu.

  2. From the Recovery checkpoints list, click the Job started recovery event corresponding to the father Job or any of the child Jobs linked to it. This will display the execution detail of the selected Job including the context variables used in it.

As shown in the capture in How to display the detail of a specific recovery event, when the Job starts, it loads the existing context variables, three in this example myValue1, myValue2 and myValue3. So if you select the Job started event type in the checkpoint list, the variables display in the Context information area in the information panel.

Later, if you use the tContextLoad component to load a group of new context variables, test1 and test2 that will replace the first two context variables in the Job, and then select the Job started event in the list, the Context information field will show the new loaded context variables as follows: