This article explains how to locate and retrieve GroundRunner logs. These logs are useful for troubleshooting chain execution issues or reviewing runner activity.
GroundRunner logs are stored locally on the machine where the runner is installed. You can access them either manually 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.
Note: Logs are retained for 21 days.
Things to know
- Logs are stored locally on the runner machine, not in Workiva
- You need direct access to the host system to retrieve logs manually
- Archived logs use compressed (.gz) format and must be extracted before viewing
GroundRunner logs are located in the log folder of your GroundRunner installation. They can be retrieved either manually or by a chain.