logging

Configures where the engine writes its logs and how chatty it is.

Example

logging {
  log level: "INFO"
  log directory: "/var/log/etl-engine/"
}

log level

Five levels are available, from most verbose to least:

Level	What it covers
TRACE	Reading the Rabbit-in-a-Hat file, building the internal mapping representation, optimisation choices.
DEBUG	Less detail than TRACE but still enough to pinpoint where an error originates.
INFO	Per-stage messages: loading the Rabbit-in-a-Hat file, cleaning, analysing tables, mapping.
WARN	Unexpected behaviour the engine recovered from — e.g. a rule chain that failed to parse.
ERROR	Fatal errors only. The engine prints a single line stating the cause and exits.

The log level setting only applies to etl-engine.log. Per-table log files always log at INFO level (this is not configurable).

log directory

Directory where the engine writes its log files. When running inside the shipped Docker container, leave this at the default path so the engine's volume mounts work correctly.

See Troubleshooting → Log Files for what each log file contains.