---
updatedAt: 2026-09-29T20:55:55.000Z
agentTools:
  siteIndex: https://support.pagerduty.com/llms.txt
  projectIndex: https://support.pagerduty.com/actions/llms.txt
---

# Datadog: Get a Monitor's Details

Datadog

<Callout icon="📘" theme="info">
  ### Availability

  See the [Incident Workflow Actions Overview table](https://support.pagerduty.com/actions/docs/incident-workflow-actions-overview) for the plans this workflow is available on.
</Callout>

# Description

Get the overall status of a monitor, e.g. "Alert", "Ignored", "No Data", "OK", "Skipped", "Unknown" or "Warn."

# Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/main/docs/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/main/docs/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

# Inputs

> 📘 Field References
>
> Fields with the **{+}** icon accept [Field References](https://support.pagerduty.com/main/docs/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **{+}**, or enter `{{`, and select relevant fields. Refer to the [Field References](https://support.pagerduty.com/main/docs/incident-workflows#field-references) article for more information.

| Name        | Description                                                                                                                                                 |
| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Integration | Select a [Workflow Integration](https://support.pagerduty.com/main/docs/workflow-integrations)  or click **New Datadog Connection** to establish a new one. |
| Monitor ID  | Enter the ID of the monitor. This will be the number at the end of the monitor URL, e.g., `https://app.datadoghq.com/monitors/<Monitor ID>`.                |

# Outputs

| Name            | Description                                                                                                   |
| :-------------- | :------------------------------------------------------------------------------------------------------------ |
| Monitor Details | The details of the monitor.                                                                                   |
| Monitor Name    | The name of the monitor.                                                                                      |
| Monitor State   | The overall state of the monitor. Can be "Alert", "Ignored", "No Data", "OK", "Skipped", "Unknown" or "Warn." |
| Monitor Query   | The query used to define the monitor. Can be used to fetch a graph snapshot of the monitor state.             |
| Result          | Value that shows if the action was successful or not. Either "Success" or "Failed."                           |
| Result Summary  | Brief description of what the action did or if it failed.                                                     |
| Error           | Brief description that is populated if the action failed.                                                     |