How to view run logs¶

Autory writes detailed messages about everything that happens in a run to .AutoryLog files. When the terminal shows a shortened error message, you can use the Autory log viewer to get the full details of what went wrong.

Open the log linked from a run¶

Keep the terminal window open after the run finishes or stops.
Look for a line starting with Log file: or See the full error details at.
Click the linked log file path.

If the run was started from the Excel ribbon, the terminal may wait for a key press before closing. Click the log link before closing that terminal.

Types of log files¶

Per-run log files are usually written to the logs folder inside the run's OutputFolder. Their names look like run--YYYYMMDD-HHMMSS--abcdefg.AutoryLog.
Each time the autory command line utility is used, it writes a CLI log file to %localappdata%\autoactuary\logs\autory. The file names look like cli_YYYYMMDDTHHMMSS.AutoryLog.

Open a log file manually¶

From Windows Explorer¶

Double-click the .AutoryLog file.

From the command line¶

autory view logs --file "path\to\run--YYYYMMDD-HHMMSS--abcdefg.AutoryLog"

See the autory view logs command reference for the full command syntax.

Using the log viewer¶

Use Filter by log level to show or hide levels such as ERROR, WARNING, INFO, and DEBUG.
Click a log entry to expand it and view its extra details.
Use the paging buttons when a log file has many entries.
To inspect another log file, drag it into the viewer, or use the file picker.