Downloading run logs

Introduction

If required, you can download run logs for a completed process flow run in CSV format, for use outside of Patchworks.

Need to know

Run log exports are completed in CSV format. The exported file includes two columns with level and message headers. For example:

level,message
info,"Flow initialised by Manual trigger."
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
error,"Flow step connector failed: attempt (1/2)"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
error,"Flow step connector failed: attempt (2/2)"
error,"Flow run #01hsdkz31xzfe6jpvcpz7fgtf5 failed."
error,"Error: Internal error, please contact support if this issue persists."

The steps

To download run logs for a specific process flow run, follow the steps below.

Step 1 Log into the Patchworks dashboard and access your run logs & queue.

Step 2 Click the ellipses icon to access additional options for the log entry, then select the download logs option - for example:

Step 3 The download job is added to a queue and a confirmation message is displayed:

Step 4 When your download is ready, you'll receive an email which includes a link to retrieve the file from the file downloads page. If you can't/don't want to use this link, you can access this page manually by selecting the settings option:

...followed by the file downloads option:

Step 5 On the file downloads page, you'll find any exports that have been completed for your company profile in the last hour. Click the download button for your job:

This list may include exports from different parts of the dashboard, not just run logs (for example, de-dupe and cross-reference lookup data exports are added here).

Step 6 The associated CSV file is saved to the default downloads folder for your browser.

Download files are cleared after one hour. If you don't manage to download your file within this time, don't worry - just download the logs again to create a new one.