Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Viewing the log files for ETL runs


When you run the run_etl.nsh, set_etl_cutoff.nsh, or stop_etl.nsh scripts, log files are created that contain details related to the script, scenario execution, and errors. If a script fails, you can use these logs to determine the point at which the script failed and how to recover.

The log files are created in the BDSSAInstallationDirectory/logs/etl/timeStamp directory, where timeStamp represents the date and time that the log file was created and uses the format YYYMMDDHHMMSS (year, month, day, hour, minute, and second). A new timeStamp directory is created for each 

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

run.

The administrator can remove the log files from the directory when appropriate.

The following log files are created when you run the run_etl.nsh script:

  • a main log file detailing the run_etl process, with the name
    site_siteID_timeStamp_run_etl.log
  • a log file with information about each scenario as it runs, with the name
    site_siteID_timeStamp_0_BSARA_ETL.log
  • a log file with information about any errors that occurred during each scenario run, with the name
    site_siteID_timeStamp_0_BSARA_ETL.err

In the log file names, variables are defined as follows:

  • siteID represents the site ID
  • timeStamp represents the date and time that the log file was created and uses the format YYYMMDDHHMMSS (year, month, day, hour, minute, and second)

The set_etl_cutoff.nsh and stop_etl.nsh scripts create similar log files in the BDSSAInstallationDirectory/logs/etl/timeStamp directory. These files are named site_siteID_timeStamp_set_etl_cutoff.log and site_siteID_timeStamp_stop_etl.log. Additional log files, associated with the scenarios that these scripts run, are also created.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*