# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
