Test a monitor trigger

You can test a monitor trigger during workflow creation. Testing a monitor generates a snippet that you can paste into your monitor notification window to trigger the workflow.

To test a monitor trigger:

1. Select the monitor trigger action in your workflow.
2. Click Test from Monitor.
3. If your monitor passes inputs to the workflow, enter a test value under Workflow Inputs.
4. Select a monitor to test.
5. Select a monitor state.
6. Click Run From Monitor.

Test a step

To ensure a step functions as desired without having to run the entire workflow, you can test the step independently.

To test a workflow step:

1. Click Test in the step Inputs section.
2. Optionally, adjust the step configuration. If your step uses output variables from a previous step, enter some hardcoded test data for the step to use.
3. Click Test to test the action.
4. When you’re finished testing the step, click Use in configuration to use your new configuration in the workflow, or close the screen to return to the workflow without saving your test configuration.

Testing is not available for branching and logic actions. To test a JavaScript function or expression action that uses output variables from a previous step, comment out the variables in your code and replace them with test data. For more information, see Test expressions and functions.

Debug a failed step

You can use a workflow’s Run History to debug a failed step. Click Configuration or Run History in the top-left to switch between the configuration and run history views.

Clicking on a failed step gives you the inputs, outputs, and execution context for the step, as well as the associated error message. The example below shows a failed GitHub pull request status step. The error message shows that the step failed due to missing permissions:

The initial run history for a workflow provides a panel with the list of previous workflow executions and whether each execution succeeded or failed. Failures include a link to the failed workflow step. Click on a workflow execution in the list to inspect it. You can return to the initial execution history at any time by clicking anywhere on the workflow canvas.

Further reading

Additional helpful documentation, links, and articles:

Getting Started with Workflow AutomationDOCUMENTATION Build workflowsDOCUMENTATION Trigger workflowsDOCUMENTATION

Do you have questions or feedback? Join the #workflows channel on the Datadog Community Slack.