2021-09-30 23:02:18 +05:30
---
2022-11-25 23:54:43 +05:30
stage: Manage
2021-10-27 15:23:28 +05:30
group: Integrations
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2021-09-30 23:02:18 +05:30
---
# Datadog integration **(FREE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/270123) in GitLab 14.1
2021-10-27 15:23:28 +05:30
This integration enables you to send CI/CD pipeline and job information to
[Datadog ](https://www.datadoghq.com/ ). Datadog's [CI Visibility ](https://app.datadoghq.com/ci )
product helps you monitor for job failures and performance issues, then troubleshoot them.
It's based on [Webhooks ](../user/project/integrations/webhooks.md ),
and only requires configuration on GitLab.
## Configure the integration
Users with the **Administrator** role can configure the integration at the
project, group, or instance level:
1. If you do not have a Datadog API key:
1. Sign in to Datadog.
1. Go to the **Integrations** section.
1. Generate an API key in the [APIs tab ](https://app.datadoghq.com/account/settings#api ).
Copy this value, as you need it in a later step.
1. *For project-level or group-level integrations:* In GitLab, go to your project or group.
1. *For instance-level integrations:*
2022-04-04 11:22:00 +05:30
1. Sign in to GitLab as a user with administrator access.
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Admin** .
2021-11-11 11:23:49 +05:30
1. On the left sidebar, select **Settings > Integrations** .
2021-10-27 15:23:28 +05:30
1. Scroll to **Add an integration** , and select **Datadog** .
1. Select **Active** to enable the integration.
1. Specify the [**Datadog site** ](https://docs.datadoghq.com/getting_started/site/ ) to send data to.
2022-03-02 08:16:31 +05:30
1. Provide your Datadog **API key** .
2022-08-27 11:52:29 +05:30
1. Optional. Select **Enable logs collection** to enable logs collection for the output of jobs. ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/346339) in GitLab 15.3.)
2022-01-26 12:08:38 +05:30
1. Optional. To override the API URL used to send data directly, provide an **API URL** .
2021-10-27 15:23:28 +05:30
Used only in advanced scenarios.
2022-01-26 12:08:38 +05:30
1. Optional. If you use more than one GitLab instance, provide a unique **Service** name
2021-10-27 15:23:28 +05:30
to differentiate between your GitLab instances.
2022-01-26 12:08:38 +05:30
1. Optional. If you use groups of GitLab instances (such as staging and production
2021-10-27 15:23:28 +05:30
environments), provide an **Env** name. This value is attached to each span
the integration generates.
2022-04-04 11:22:00 +05:30
1. Optional. To define any custom tags for all spans at which the integration is being configured,
enter one tag per line in **Tags** . Each line must be in the format `key:value` . ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/79665) in GitLab 14.8.)
2022-01-26 12:08:38 +05:30
1. Optional. Select **Test settings** to test your integration.
2021-10-27 15:23:28 +05:30
1. Select **Save changes** .
When the integration sends data, you can view it in the [CI Visibility ](https://app.datadoghq.com/ci )
section of your Datadog account.
2022-01-26 12:08:38 +05:30
## Related topics
2021-10-27 15:23:28 +05:30
- [Datadog's CI Visibility ](https://docs.datadoghq.com/continuous_integration/ ) documentation.
