August 17, 2023

tChronometerStop – Docs for ESB 5.x

tChronometerStop

tChronometerStop.png

tChronometerStop Properties

Component family

Logs & Errors

 

Function

Measures the time a subjob takes to be executed.

Purpose

Operates as a chronometer device that stops calculating the
processing time of one or more subjobs in the main Job, or that
stops calculating the processing time of part of your subjob.

tChronometerStop displays the
total execution time.

Basic settings

Since options

Select either check box to select measurement starting point:

Since the beginning: stops time
measurement launched at the beginning of a subjob.

Since a tChronometerStart: stops
time measurement launched at one of the tChronometerStart components used on the data flow
of the subjob.

 

Display duration in console

When selected, it displays subjob execution information on the
console.

 

Display component name

When selected, it displays the name of the component on the
console.

 

Caption

Enter desired text, to identify your subjob for example.

 

Display human readable duration

When selected, it displays subjob execution information in
readable time unites.

Global Variables

STOPTIME: the stop time to calculate the processing time
of subjob(s). This is a Flow variable and it returns a long.

DURATION: the processing time of subjob(s). This is a
Flow variable and it returns a long.

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space
to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio
User Guide.

Usage

Cannot be used as a start component.

Log4j

The activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User
Guide
.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

n/a

Scenario: Measuring the processing time of a subjob and part of a subjob

This scenario is a subjob that does the following in a sequence:

  • generates 1000 000 rows of first and last names,

  • gathers first names with their corresponding last names,

  • stores the output data in a delimited file,

  • measures the duration of the subjob as a whole,

  • measures the duration of the name replacement operation,

  • displays the gathered information about the processing time on the Run log console.

To measure the processing time of the subjob:

  • Drop the following components from the Palette onto the design workspace: tRowGenerator, tMap, tFileOutputDelimited, and tChronometerStop.

  • Connect the first three components using Main
    Row
    links.

Note

When connecting tMap to tFileOutputDelimited, you will be prompted to name the output table.
The name used in this example is “new_order”.

Use_Case_Chronometer1.png
  • Connect tFileOutputDelimited to tChronometerStop using an OnComponentOk link.

  • Select tRowGenerator and click the Component tab to display the component view.

  • In the component view, click Basic settings. The Component tab opens on the Basic settings
    view by default.

Use_Case_Chronometer_BasicSettings.png
  • Click Edit schema to define the schema of the
    tRowGenerator. For this Job, the schema is
    composed of two columns: First_Name and
    Last_Name, so click twice the [+] button to add two columns and rename them.

  • Click the RowGenerator Editor three-dot
    button to open the editor and define the data to be generated.

Use_Case_Chronometer_RowGenerator.png
  • In the RowGenerator Editor, specify the
    number of rows to be generated in the Number of Rows for
    RowGenerator
    field and click OK.
    The RowGenerator Editor closes.

  • You will be prompted to propagate changes. Click Yes in the popup message.

  • Double-click on the tMap component to open
    the Map editor. The Map editor opens displaying the input metadata of
    the tRowGenerator component.

Use_Case_Chronometer_Mapper.png
  • In the Schema editor panel of the Map editor,
    click the plus button of the output table to add two rows and define
    them.

  • In the Map editor, drag the First_Name row from the input
    table to the Last_Name row in the output table and drag the
    Last_Name row from the input table to the
    First_Name row in the output table.

  • Click Apply to save changes.

  • You will be prompted to propagate changes. Click Yes in the popup message.

  • Click OK to close the editor.

Use_Case_Chronometer_Mapper1.png
  • Select tFileOutputDelimited and click the
    Component tab to display the component
    view.

  • In the Basic settings view, set tFileOutputDelimited properties as needed.

Use_Case_ChronometerStop_BasicSettings3.png
  • Select tChronometerStop and click the
    Component tab to display the component
    view.

  • In the Since options panel of the Basic settings view,
    select Since the beginning option to
    measure the duration of the subjob as a whole.

t

Use_Case_ChronometerStop_BasicSettings4.png
  • Select/clear the other check boxes as needed. In this scenario, we want to
    display the subjob duration on the console preceded by the component
    name.

  • If needed, enter a text in the Caption
    field.

  • Save your Job and press F6 to execute
    it.

Use_Case_ChronometerStop_Result1.png

Note

You can measure the duration of the subjob the same way by placing tChronometerStop below tRowGenerator, and connecting the latter to tChronometerStop using an OnSubjobOk link.


Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x