---
title: Track workflows
description: >-
  Monitor workflow activity, metrics, and costs using dashboards, audit trails,
  event management, and usage attribution.
breadcrumbs: Docs > Actions > Workflow Automation > Track workflows
---

# Track workflows

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

This page explains how to track different kinds of workflow activity and workflow costs.

## Out-of-the-box dashboard{% #out-of-the-box-dashboard %}

The Workflows Overview dashboard provides a high-level overview of your Datadog workflows and executions. To find the dashboard, go to your [Dashboard list](https://app.datadoghq.com/dashboard/lists) and search for Workflows Overview.

{% image
   source="https://docs.dd-static.net/images/service_management/workflows/workflows-dashboard.e556f0639a5fe440cf008dd9c3f2d176.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/service_management/workflows/workflows-dashboard.e556f0639a5fe440cf008dd9c3f2d176.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Workflows Overview dashboard" /%}

## View workflow edits and runs in Audit Trail{% #view-workflow-edits-and-runs-in-audit-trail %}

You can view workflow edits and runs using Audit Trail.

For example, to see who edited a workflow:

1. From your workflow, click the 
   {% icon name="icon-cog-2" /%}
 **(gear)** in the upper right corner and click View audit events.An Audit Trail search filtered to your workflow opens.
1. In the left, under the Core filters, expand Action.
1. Hover over Modified and click Only to filter the results to show only workflow edits.The User ID column displays the username of the person who performed each edit.

## Notify about runs{% #notify-about-runs %}

See [Workflow notifications](https://docs.datadoghq.com/service_management/workflows/build.md#workflow-notifications) for instructions on using built-in workflow notifications.

## Track Workflow metrics with a Datadog monitor{% #track-workflow-metrics-with-a-datadog-monitor %}

You can use Datadog monitors to track various Workflow metrics.

The list of available metrics is:

| Metric                                         | Description                                            |
| ---------------------------------------------- | ------------------------------------------------------ |
| `datadog.workflows.count`                      | Number of non-deleted workflows.                       |
| `datadog.workflows.executions.started`         | Number of workflow instances that have started.        |
| `datadog.workflows.executions.completed`       | Number of workflow instances that have completed.      |
| `datadog.workflows.steps.executions.started`   | Number of workflow instance steps that have started.   |
| `datadog.workflows.steps.executions.completed` | Number of workflow instance steps that have completed. |

To create a monitor that tracks whether daily workflow executions exceed a certain threshold, perform the following steps:

1. Go to [New Monitor](https://app.datadoghq.com/monitors/create) and select the Metric monitor type.

1. Under Define the metric, for a, fill in `datadog.workflows.executions.started`.

1. *Optionally*, to restrict the monitor to a specific workflow, for from, fill in `workflow_id:[WORKFLOW-ID]`, replacing `[WORKFLOW-ID]` with the ID for your workflow.

1. For Evaluation Details, use the following values:

   - Evaluate the: `sum`
   - Of the query over the: `last 1 day`.

1. For Set alert conditions, choose above, then fill in an alert and warning threshold. For example, you could fill in an Alert threshold of `200` and a Warning threshold of `150`.

1. Under Configure notifications & automations, name your workflow, then fill in message text. For example, you could use message text like the following:

   ```
   @slack-alert-channel
   
   {{#is_warning}}
   Workflow has executed {{warn_threshold}} times in the last day; manual action might be needed to avoid alerting.
   {{/is_warning}}
   {{#is_alert}}
   Workflow has executed {{threshold}} times in the last day, which is our budget threshold for workflows. We should unpublish the workflow to avoid any more automatic executions for the day.
   {{/is_alert}}
```

1. Click Create.

## View workflow events in Event Manager{% #view-workflow-events-in-event-manager %}

You can use [Event Manager](https://app.datadoghq.com/event/explorer?query=source%3Aworkflow_automation) to view workflow start and completion events by filtering on `source:workflow_automation`.

To see events for a specific workflow, in the Search facets box, search for `workflow.workflow_id`. You can select a specific set of IDs to view only events for those workflows.

You can also filter the output by Status to see only `info`, `warn`, or `error` messages.

## Track workflow billing in Usage Attribution{% #track-workflow-billing-in-usage-attribution %}

{% alert level="danger" %}
Usage Attribution is an advanced feature included in the Enterprise plan. For all other plans, contact your account representative or [success@datadoghq.com](mailto:success@datadoghq.com) to request this feature.
{% /alert %}

To track billing for your workflow executions, perform the following steps:

1. Navigate to the [Usage Attribution](https://app.datadoghq.com/billing/usage-attribution) page.
1. Under Products on the left, search for Workflow Executions.
1. Hover over Workflow Executions and click Only to view usage attribution for only workflows.

## Further reading{% #further-reading %}

- [Build workflows](https://docs.datadoghq.com/service_management/workflows/build.md)
- [Datadog Audit Trail](https://docs.datadoghq.com/account_management/audit_trail.md)
- [Usage Attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution.md)

Do you have questions or feedback? Join the **#workflows** channel on the [Datadog Community Slack](https://chat.datadoghq.com/).