Viewing Workflow Logs

When a workflow is run it will produce a log of the input and output of each step in that workflow. This makes it easier to investigate issues and helps with building more complex workflows.  To view the logs for a workflow click on the DEBUG tab button in the header of the builder. 

Workflow Runs

The first panel that you see after clicking the DEBUG tab is a view of all the runs for the current workflow.  Each row corresponds to a single workflow run along with the current state or how long the total run took.  New workflow runs appear at the bottom of the list.  Red rows are workflow runs that failed at some point, green are successful runs and yellow are runs that are still currently running.

Steps

Clicking on any of the workflow run rows will open a view of all the steps that were part of that specific run. Again, red rows are steps that failed at some point, green are successful steps and yellow are steps that are still currently running.  During a run, new steps appear at the bottom. 

Pro tip: You can skip to a connector in your workflow by holding shift and clicking on a step.

Step Data

Clicking on any of the steps in the step run view will display the step details.  This allows you to inspect the input and output data for the particular step as well as some other details like begin/end and total run time.  Clicking the view button opens the input and output in a larger window. 

Resizing Panels

The panels are adjustable so you can customize your Tray workspace. There is also a compact mode for the run and step panels which you will see if you make those panels smaller. The interface remembers how you configure the different panels so you won't have to adjust them every time you open a workflow.

Pausing Logs

You can pause the logs at any time using the PAUSE buttons at the bottom of each panel.  When the logs are not paused this button displays the word LIVE.   This will stop the logs from updating and give you a chance to inspect what is going on.  Note that this doesn't pause the execution of the workflow, just the logs. The logs are automatically paused when searching.

Searching Logs

There is a search box above the list of workflow runs and above the list of steps. You can use these search boxes to search your logs history. You can also search for text in the step data panel and occurrences of your input terms will be highlighted in the input/output boxes.

On most plans we retain logs for 30 days.

The syntax for searching your logs is quite powerful. Your search query is constructed from two parts separated by a colon. Each type of search is slightly different and explained here:

Before

Return runs/steps before a specific date and time (yyyy-mm-dd hh:mm)

Example:

before:2016-12-24 14:50

Dates Before 24th December 2016 at 14:50

After

Return runs/steps after a specific date and time (yyyy-mm-dd hh:mm)

Example:

after:2016-12-24 14:50

Dates After 24th December 2016 at 14:50

Success

Return runs/steps that were successful

Examples:

success:[*]

All successful runs/steps

success:storage-2

In runs panel: All runs containing a successful step called 'storage-2'. In steps panel: All successful steps called 'storage-2'

Failure

Return runs/steps that have failed

Examples:

failure:[*]

All failed runs/steps

failure:storage-2

In runs panel: All runs containing a failed step called 'storage-2'. In steps panel: All failed steps called 'storage-2'

Running

Return runs that are currently still being executed (i.e. still running)

Examples:

running:[*]

All runs that are currently running

running:delay-2

All runs containing a currently running step called 'delay-2'

Input

Return runs/steps in which the step input has a particular value.

Query format: output[step_name][key_name]:value

Examples:

input[storage-1][scope]:workflow

In Runs panel: All runs containing a step called 'storage-1' which have a key in the input called 'scope' with the value 'workflow'. In Steps panel: All steps called 'storage-1' which have a key in the input called 'scope' with the value 'workflow'.

input[storage-1][*]:workflow

In Runs panel: All runs containing a step called 'storage-1' which have any key in the input with the value 'workflow'. In Steps panel: All steps called 'storage-1' which have any key in the input with the value 'workflow'.

input[*][scope]:workflow

In Runs panel: All runs which have any step with a key in the input called 'scope' with the value 'workflow'. In Steps panel: All steps which have any key in the input called 'scope' with the value 'workflow'.

input[*][*]:workflow

In Runs panel: All runs which have any key in the input with the value 'workflow'. In Steps panel: All steps which have any key in the input with the value 'workflow'.

Output

Return runs/steps in which the step output has a particular value.

Query format: output[step_name][key_name]:value

Examples:

output[storage-1][scope]:workflow

In Runs panel: All runs containing a step called 'storage-1' which have a key in the output called 'scope' with the value 'workflow'. In Steps panel: All steps called 'storage-1' which have a key in the output called 'scope' with the value 'workflow'.

output[storage-1][*]:workflow

In Runs panel: All runs containing a step called 'storage-1' which have any key in the output with the value 'workflow'. In Steps panel: All steps called 'storage-1' which have any key in the output with the value 'workflow'.

output[*][scope]:workflow

In Runs panel: All runs which have any step with a key in the output called 'scope' with the value 'workflow'. In Steps panel: All steps which have any key in the output called 'scope' with the value 'workflow'.

output[*][*]:workflow

In Runs panel: All runs which have any key in the output with the value 'workflow'. In Steps panel: All steps which have any key in the output with the value 'workflow'.

Last updated 18th July 2017