Detailed ETL Logging in Elixir Repertoire/Ambience 202x

Overview

This guide explains how to configure your Repertoire 202x or Ambience 202x to capture more detailed logs for ETL operations.


Step 1: Locate the Configuration File

Navigate to the /etc folder within your Repertoire 202x or Ambience 202x installation directory and locate the application.conf file.


Step 2: Enable the Protocol

Within the application.conf file, locate the ambience section and add the following block:

ambience {
  ...
  etl {
    logging {
      write-to-server-log: true
      write-to-job-log: true
    }
  }
}

Parameter Breakdown:

  • write-to-server-log: true
    Enables ETL logs to be written to the main server log.

  • write-to-job-log: true
    Enables ETL logs to be written to individual job logs.

Important Note: Enabling write-to-server-log may significantly increase the size of your server logs, especially in high-volume environments.


Step 3: Save and Restart

  1. Save your changes to the configuration file.
  2. Restart the Repertoire server to apply the new setting.

Step 4: Verify Configuration

After restarting:

  • Run an ETL job to generate log entries.
  • Check the ambience log (ambience.log) for ETL-related messages.
  • Review the job log for detailed step-by-step ETL execution traces.
  • Confirm that both logs reflect the expected ETL activity.