Create a new Workflow

Creation

Creating new workflows is currently supported through the groundcover app in two ways from the Monitors menu:

Create Workflow

1. "Create Notification Workflow" button - The quick way

This provides a guided approach to create a workflow. When creating a notification workflow, you will be asked to give your workflow a name, add filters, and select the specific integration to use.

Filter Rules By Labels - Add key-value attributes to ensure your workflow executes under specific conditions only - for example, env = prod only.

Delivery Destinations - Select one or more integrations to be used for notifications with this workflow.

Scope - When The Workflow Will Run - This setting allows you to limit this workflow execution only to monitors that explicitly select to route their triggers to this workflow, as opposed to "Handle all issues" that catches triggers from any monitor.

Once you create a workflow using this option, you can later edit the workflow to apply any configuration or logic by using the editor option (see next).

2. "Create Workflow" button

Clicking the button will open up a text editor where you can add your workflow definition in YAML format by applying any valid configuration, logic, and functionality.

Note: Make sure to create your integration prior to creating the workflow as it requires using an existing integration.

View

Upon successful workflow creation it will be active immediately, and a new workflow record will appear in the underlying table.

For each existing workflow, we can see the following fields:

  • Name: Your defined workflow name

  • Description: If you've added a description of the workflow

  • Creator: Workflow creator email

  • Creation Date: Workflow creation date

  • Last Execution Time: Timestamp of last workflow execution (depends on workflow trigger type)

  • Last Execution Status: Last execution status (failure or success)

Editing

From the right side of each workflow record in the display, you can access the menu (three dots) and click "Edit Workflow". This will open the editor so you can modify the YAML to conform to the available functionality. See examples below.

Last updated