Viewing logs

Introduction

Having accessed run logs and selected the view logs option for a given flow run, you can view:

• An insights summary with performance-related information for the process flow

• Detailed logs for each step in the flow

Insights summary

The insights summary is divided into three functional areas:

At the top of the page, you'll find the unique flow run id (A), followed by an ellipses option (B) providing access to additional options - these options will vary, depending on whether the run succeeded or failed.

You'll notice a copy link with current company id icon to the right of the unique flow run id. This can be used to copy a link to this log, including your company profile id:

This is useful if:

• You manage multiple Patchworks profiles. Sharing this link with other team members (who have sufficient permissions) means they can access the log directly, seamlessly switching to the relevant company profile.

• You need to raise a support query regarding a process flow run. Including this link in your support ticket means that a member of our Support team can access the log more efficiently, seamlessly switching to the relevant company profile.

Below the flow run id, you can see basic details for the process flow (C) - this includes name, id, and version, together with triggered by, status, start time, duration, CPU time, and data.

If this log relates to an inactive process flow version that's been deleted, you'll see a message to this effect against flow version - for example:

The lower panel (D) shows every step (i.e. every shape) in the flow. These are listed in processing sequence, with the following information:

Detailed logs

In the lower panel of the insights summary, you can click any entry to access detailed logs:

In the top section, you can see a full history of what happened during this step - this will often display over multiple pages.

In the lower section, you can view and download any payloads associated with this step. Click the 'view' icon associated with any payload to see the contents:

...the payload is displayed:

Longer payloads are trimmed but you can use the download option to retrieve the full content:

Payloads are available for 72 hours after the process flow has run.

If a failed payload was removed so that the flow run could continue (either because connector settings are set to do this OR a try/catch shape has found exceptions), it's displayed with a failed payload status - for example:

Additional options

The ellipses icon in the top, right-hand corner provides access to additional options. These options vary, depending on whether the run failed or succeeded.

When a run is successful or partially successful, you can download run logs. If the run failed, you can download logs and also retry the run.