Skip to main content
Pentaho Documentation

Logging Transformations

Follow the instructions below to create a log table for transformation-related processes:

  1. Right-click in the workspace (canvas) where you have an open transformation. Alternatively, press <CTRL +T>.  The Transformation Properties dialog box appears.
  2. In the Transformation Properties dialog box, click the Logging tab. Make sure Transformation is selected in the navigation pane on the left. 
  3. Under Logging enter the following information:
    Option Description
    Log Connection Specifies the database connection you are using for logging; you can configure a new connection by clicking New.
    Log Table Schema Specifies the schema name, if supported by your database
    Log Table Name Specifies the name of the log table (for example L_ETL)
    Logging interval (seconds) Specifies the interval in which logs are written to the table
    Log record timeout (in days) Specifies the number of days old log entries in the table will be kept before they are deleted
    Log size limit in lines Limits the number of lines that are stored in the LOG_FIELD (when selected under Fields to Log); when the LOG_FIELD is enabled Pentaho Data Integration will store logging associated with the transformation in a long text field (CLOB)
  4. Enable the fields you want to log or keep the defaults.
  5. Click SQL to create your log table. The Simple SQL Editor appears.
  6. Click Execute to execute the SQL code for your log table, then click OK to exit the Results dialog box.
    Note: You must execute the SQL code to create the log table.
  7. Click Close to exit the Simple SQL Editor.
  8. Click OK to exit the Transformation Properties dialog box.

The next time you run your transformation, logging information will be displayed under the Execution History tab.