Automatically Download GroundRunner Logs

By default, GroundRunners automatically create log files in the \Contents\log\ directory of their installation locations. To ease access to the log file for troubleshooting, you can automatically download a GroundRunner's output.log file to a table in Wdata with a chain using:

• The default File Utilities connection
• A Workiva connection

Step 1. Create the Table and Chain

1. If necessary, install and set up the GroundRunner.
2. From Home , create a table, and add a single text column named Log.
3. To identify the table in the chain, record its ID.

   Note: The table's ID is the alphanumeric value following tables/ in its URL.

4. From Chains , click Build  device_hub, Chains, and Create Chain.
5. Under Setup, enter a unique name and description to help identify the chain and its intent.

Step 2. Add a Copy Command

To enable the table to import the log, add a Copy command to create a CSV of the latest file:

1. Under Available BizApps, click File Utilities, and move Copy to the canvas.
2. Select the node, click Edit create, and enter a unique name and description for the command.
3. Select the GroundRunner to download the logs from.
4. For Source, enter the path to the GroundRunner's output.log file, such as c:\PROGRA~2\Wdata\Contents\log\output.log.
5. For Destination, append the same path with .$(Chain.ExecutorId).csv, such as c:\PROGRA~2\Wdata\Contents\log\output.log.$(Chain.ExecutorId).csv.
6. To ensure the chain downloads the latest log file, select Overwrite.
7. Click Save, and move the node to Start.

Step 3. Add a Command Group to Create a ZIP of the CSV

The log file may be large. To create a ZIP file from–and then delete–the CSV, add a command group:

1. Under Available BizApps, click File Utilities, and move Zip to the canvas.
2. Select the node, click Edit create, enter a unique name and description for the command, and select the same GroundRunner.
3. For Archive Name, enter the name to give the ZIP file, such as output.log.zip.
4. For Source Files, enter the same path as the Destination input of the Copy command.
5. Click Save.
6. Under Available BizApps, click File Utilities, and move Delete to the canvas.
7. Select the node, click Edit create, enter a unique name and description for the command, and select the same GroundRunner.
8. For File name, enter the same path as the Destination input of the Copy command.
9. Click Save, and move the node to the Zip node to create a command group.
10. Drag a link from Start to the command group.

Step 4. Add a Create File Command

To import the log file to the table, add a Create File command:

1. Under Available BizApps, click Workiva, and move Create File to the canvas.
2. Select the node, click Edit create, enter a unique name and description for the command, and select the same GroundRunner.
3. For Table ID, enter the ID from the URL of the table to add the log file to.
4. For File, click Variable, and select the Zipped File output of the Zip command.
5. Click Save, drag a link from the command group to the node, and click Publish.

Step 5. Download the Log File

1. To run the chain, click its Execute flight_takeoff and Run Chain.
2. In the table, verify the current log file appears on the Datasets right panel.
3. To download the log file, select Details from its dataset's menu, and then select Download , Original File , To CSV .