GroundRunner logs are useful for troubleshooting chain execution issues or reviewing runner activity. These logs are stored locally on the machine where the runner is installed for 21 days in a compressed (GZip) format, and can be accessed either by going through the file system or by using a chain.
Requirements
- Access to Chain Builder
- Permissions to view Workspace Settings
- Access to the host machine where GroundRunner is installed
Locate the GroundRunner installation path
First, identify the GroundRunner instance and its install location in Workiva.
- In Chain Builder, open Workspace Settings.
- Select Runners.
- Find your GroundRunner instance.
- Note the Install Location path.
This path shows where logs are stored on the host machine.
Retrieve GroundRunner logs
After locating the install path, access the logs directly from the host machine.
- Log in to the machine where GroundRunner is installed.
- Navigate to the Install Location path.
- Open the log folder.
Log files
The log folder contains the following files:
- output.log — The current log file
- output-[date].log.gz — Archived log files
To view archived logs, unzip the .gz file.
Things to know
- GroundRunner logs are stored in the log folder of your GroundRunner machine, not in Workiva.
- Logs can be retrieved either manually or by a chain, however you need direct access to the host system to retrieve logs manually.
- Archived logs use compressed (.gz) format and must be extracted before viewing.
- The log format was updated in version 9.21.01 to use tab-separated values for each line.
The new pattern is:<timestamp> <level> <message> <json-context>
The legacylevel=pattern is no longer used.