Datadog
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The Datadog integration enables you to connect your GitLab projects to Datadog, synchronizing repository metadata to enrich your Datadog telemetry, have Datadog comment on Merge Requests, and send CI/CD pipeline and job information to Datadog.
Connect your Datadog account
Users with the Administrator role can configure the integration for the entire instance or for a specific project or group:
- If you do not have a Datadog API key:
- Sign in to Datadog.
- Go to the Integrations section.
- Generate an API key in the APIs tab. Copy this value, as you need it in a later step.
- For integrations for a specific project or group: In GitLab, go to your project or group.
- For integrations for the entire instance:
- Sign in to GitLab as a user with administrator access.
- On the left sidebar, at the bottom, select Admin.
- Select Settings > Integrations.
- Scroll to Add an integration, and select Datadog.
- Select Active to enable the integration.
- Specify the Datadog site to send data to.
- Optional. To override the API URL used to send data directly, provide an API URL. Used only in advanced scenarios.
- Provide your Datadog API key.
Configure CI Visibility
You can optionally enable Datadog CI Visibility to send the CI/CD pipeline and job data to Datadog. Use this feature to monitor and troubleshoot job failures and performance issues.
For more information, see the Datadog CI Visibility documentation.
Datadog CI Visibility is priced per committer. Using this feature might affect your Datadog bill. For details, see the Datadog pricing page.
This feature is based on Webhooks, and only requires configuration in GitLab:
- Optional. Select Enable Pipeline job logs collection to enable logs collection for the output of jobs. (Introduced in GitLab 15.3.)
- Optional. If you use more than one GitLab instance, provide a unique Service name to differentiate between your GitLab instances.
- 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.
- 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
. - Optional. Select Test settings.
- Select Save changes.
When the integration sends data, you can view it in the CI Visibility section of your Datadog account.
Related topics
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support