gitlab-org--gitlab-foss/doc/integration/datadog.md

2.4 KiB

stage group info
Ecosystem Integrations To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Datadog integration (FREE)

Introduced in GitLab 14.1

This integration enables you to send CI/CD pipeline and job information to Datadog. Datadog's CI Visibility product helps you monitor for job failures and performance issues, then troubleshoot them. It's based on Webhooks, 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.
    2. Go to the Integrations section.
    3. Generate an API key in the APIs tab. Copy this value, as you need it in a later step.
  2. For project-level or group-level integrations: In GitLab, go to your project or group.
  3. For instance-level integrations:
    1. Sign in to GitLab as a user with the Administrator role.
    2. On the top bar, select Menu > Admin.
  4. In the left sidebar, select Settings > Integrations.
  5. Scroll to Add an integration, and select Datadog.
  6. Select Active to enable the integration.
  7. Specify the Datadog site to send data to.
  8. (Optional) To override the API URL used to send data directly, provide an API URL. Used only in advanced scenarios.
  9. Provide your Datadog API key.
  10. (Optional) If you use more than one GitLab instance, provide a unique Service name to differentiate between your GitLab instances.
  11. (Optional) If you use groups of GitLab instances (such as staging and production environments), provide an Env name. This value is attached to each span the integration generates.
  12. (Optional) Select Test settings to test your integration.
  13. Select Save changes.

When the integration sends data, you can view it in the CI Visibility section of your Datadog account.