> For the complete documentation index, see [llms.txt](https://help.isdown.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.isdown.app/integrations/how-to-set-up-datadog-integration.md).

# How to Set Up Datadog Integration

1. Use your existing account or create a new one at <https://isdown.app/users/sign_up>.
2. Log in to your account and go to **"Alerts & Integrations"** section.
3. Click on the checkbox to **Add** **Datadog.**

<figure><img src="/files/SEjzcix4lgMDBzLXsRp7" alt=""><figcaption></figcaption></figure>

4. You are then redirected to Datadog to authorize the application. IsDown creates an API key that only has access to what IsDown needs to send events and service checks to Datadog.

<figure><img src="/files/x66F6J3NBZa8i4LUFVle" alt=""><figcaption></figcaption></figure>

**IsDown will not read any data from your Datadog account. The requested scope only allows us to send data and not read it.**

5. After authorization, you are redirected to IsDown.
6. A new dashboard will be created in Datadog.

   <figure><img src="/files/zRESQKFLsEgIB76IbyRA" alt=""><figcaption></figcaption></figure>
7. Other notes
   1. We send two types of data. Checks and Events.
   2. In the case of the Events, we will send the outage information with tags. One of the tags identifies the profile from where it is sent. This will allow you to set up your Datadog account alerts based on the source profile sent. E.g., Identify outages that might be critical to your platform vs non-critical ones.

      \
      **Tags sent in each event:**\
      \- "source:isdown"\
      \- "isdown:SERVICE\_URLNAME" , e.g., 'isdown:azure'\
      \- "isdown:profile-PROFILE\_URLNAME, e.g. 'isdown:profile-all-company'<br>
   3. Apart from the base widgets, you can create your own. See more in [How to Create Custom Widgets in Datadog](/integrations/how-to-set-up-datadog-integration/how-to-create-custom-widgets-in-datadog.md).

Need assistance? Reach out via chat or email us at [**support@isdown.app**](mailto:support@isdown.app).

***

**Related Articles**

* [**How to Set Up PagerDuty Integration**](https://help.isdown.app/integrations/setup-pagerduty)
* [**How to Set Up Slack Notifications**](https://help.isdown.app/notifications/slack)
* [**How to Filter Outages by Severity**](https://help.isdown.app/cloud-monitoring/how-to-get-filter-notifications-by-outage-severity)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.isdown.app/integrations/how-to-set-up-datadog-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.