Skip to content

Log levels

Autory uses log levels to decide which messages are shown in the terminal during a run. The LogLevel run control option and the --log-level command line option set the minimum level shown.

Info is the default log level for terminal output. Choose Debug when you need more detail. Choose Warning or Error when you want less terminal output.

What each setting shows

Selected log level Messages shown in the terminal
Debug Debug, Info, Warning, Error, and Critical
Info Info, Warning, Error, and Critical
Warning Warning, Error, and Critical
Error Error and Critical
Critical Critical only

Debug

Debug is used for information that is useful when diagnosing a problem, but too noisy for ordinary runs. This is the log level used for detailed .AutoryLog files.

Examples:

  • DEBUG: Autory CLI invoked as: ["autory", "run", "direct", "My Model.xlsm"]
  • DEBUG: Python executable: C:\Program Files\Autory\bin\python\python\python.exe
  • DEBUG: Starting profiler. Statistics will be written to C:\Models\Output\run.AutoryProf

Info

Info is used for normal progress messages that are useful during a successful run. This is the default log level for terminal output.

Examples:

  • INFO: Reading model file ...
  • INFO: Building model ...
  • INFO: Starting ...
  • INFO: Duration: 0:01:23.456789

Warning

Warning is used for something unusual that the user should know about, but that does not necessarily stop the run.

Examples:

  • WARNING: There are no projection nodes in this run.
  • WARNING: Data table overrides are not supported by the VBA engine.
  • WARNING: The VBA engine is deprecated in Autory 3, and will be removed in Autory 4.

Error

Use Error when an operation failed, a user action is invalid, or Autory had to recover from a problem. Errors are more serious than warnings, but they are still usually presented in a user-friendly way.

Examples:

  • ERROR: Invalid scheme `https`. Expected `autory`.
  • ERROR: Output file already exists: C:\Models\Output\results.xlsx
  • ERROR: Failed to backup user settings to `C:\Users\Me\AppData\Local\Temp\autory\user_variables_backup`: Access is denied.

Critical

Autory rarely uses the Critical log level.