Skip to content

Commit f0e8d2f

Browse files
committed
Refresh article
1 parent de99ec8 commit f0e8d2f

File tree

5 files changed

+38
-26
lines changed

5 files changed

+38
-26
lines changed
3.52 KB
Loading
5.87 KB
Loading
6.66 KB
Loading
Binary file not shown.

docs/service-hooks/services/datadog.md

Lines changed: 38 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,18 @@ ms.assetid: 7472f06c-11f3-4603-953c-9a0de5abe29d
77
ms.author: chcomley
88
author: chcomley
99
monikerRange: "<=azure-devops"
10-
ms.date: 11/03/2020
10+
ms.date: 06/25/2025
1111
---
1212
# Create a service hook for Azure DevOps with Datadog
1313

1414
[!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)]
1515

16-
Learn how to create events and metrics in Datadog in response to events from Azure DevOps. Use these metrics and events in Datadog to create dashboards, troubleshoot issues, and create monitors to alert you of critical issues. Datadog accepts all Azure DevOps event types.
16+
You can use Azure DevOps service hooks to create events and metrics in Datadog in response to events in Azure DevOps. In Datadog, you can use these metrics and events to create dashboards, troubleshoot issues, and create monitors to alert you to critical issues. Datadog accepts all Azure DevOps event types.
1717

1818
> [!IMPORTANT]
19-
> The Datadog feature might not be turned on by default for Azure DevOps Server 2019 and 2020, which is a known issue. Until it resolves, you can use the following SQL command in your config database to turn on the feature:
20-
`exec prc_SetRegistryValue 1, '#\FeatureAvailability\Entries\ServiceHooks.Consumers.datadog\AvailabilityState\', 1`
19+
> The Datadog feature might not be turned on by default for Azure DevOps Server 2020, which is a known issue. Until it's resolved, you can use the following SQL command in your **Tfs_Configuration** database to turn on the feature:
20+
>
21+
> `exec prc_SetRegistryValue 1, '#\FeatureAvailability\Entries\ServiceHooks.Consumers.datadog\AvailabilityState\', 1`
2122
2223
## Prerequisites
2324

@@ -28,45 +29,56 @@ Learn how to create events and metrics in Datadog in response to events from Azu
2829

2930
## Start sending Azure DevOps events to Datadog
3031

31-
1. Go to **Project settings** > **Service hooks**: `https://{orgName}/{project_name}/_settings/serviceHooks`.
32+
To send Azure DevOps events to Datadog, you set up a subscription for each type of event.
3233

33-
2. Select **Create subscription**.
34+
### Create a subscription for an event
3435

35-
![Select Create subscription from the Service hooks page](../media/service-hooks-page-select-create-subscription.png)
36+
1. Go to your Azure DevOps project, select **Project settings**, and then select **Service hooks**. Alternately, go to https://{organization-name}/{project-name}/_settings/serviceHooks`.
3637

37-
3. Choose **Datadog** among the list of services, and then choose **Next**.
38+
1. Select **Create subscription**.
3839

39-
:::image type="content" source="../media/select-datadog.png" alt-text="Screenshot with red box around Datadog and Next selections.":::
40+
:::image type="content" source="../media/azure-devops-create-subscription.png" alt-text="Screenshot of the Service Hooks page of an Azure DevOps project. The Create subscription button is highlighted.":::
4041

41-
4. Select an event to trigger on, configure any filters, and then select **Next**.
42+
1. In the list of services, select **Datadog**, and then select **Next**.
4243

43-
:::image type="content" source="../media/datadog-trigger-event.png" alt-text="Screenshot of configuration fields for triggering event in Azure DevOps.":::
44+
:::image type="content" source="../media/select-datadog.png" alt-text="Screenshot of the Service page in the New service hooks subscription wizard. In the service list, Datadog is highlighted. Next is also highlighted.":::
4445

45-
5. Configure the action to perform.
46-
- Paste (ctrl+v) your Datadog API Key into the required field.
47-
- Indicate whether your Datadog account is US or EU.
46+
1. Select an event to trigger on, configure any filters that you want to use, and then select **Next**.
4847

49-
6. Choose **Test** to verify that Azure DevOps can use the provided configuration and successfully create a subscription.
48+
:::image type="content" source="../media/datadog-trigger-event.png" alt-text="Screenshot of the Trigger page in the New service hooks subscription wizard. The event list, two filters, and the Next button are highlighted.":::
5049

51-
7. Once verified, choose **Finish** to complete the creation of subscription.
50+
1. Configure the action to perform when the event happens:
51+
- Under **Datadog API Key**, enter your Datadog API key.
52+
- Under **Datadog Account Type**, select your account type.
5253

53-
:::image type="content" source="../media/datadog-api-key-account-type-selection.png" alt-text="Screenshot of where you select and configure the action to perform.":::
54+
1. To verify that Azure DevOps can use the provided configuration and successfully create a subscription, select **Test**.
5455

55-
8. Repeat steps 2-7 for each event type you want to send to Datadog. Datadog accepts and encourages users to send all event types.
56-
9. Go to [Datadog](https://app.datadoghq.com/account/login) to see events and metrics start to flow into your environment.
56+
1. To create the subscription, select **Finish**.
57+
58+
:::image type="content" source="../media/datadog-api-key-account-type-selection.png" alt-text="Screenshot of the Action page in the New service hooks subscription wizard, with a key and an account type visible and Test and Finish highlighted.":::
59+
60+
### Add subscriptions for other events
61+
62+
Repeat the steps in [Create a subscription for an event](#create-a-subscription-for-an-event) for each event type you want to send to Datadog. Datadog accepts and encourages users to send all event types.
63+
64+
### Use your data in Datadog
65+
66+
As events occur and their data and metrics start to flow into Datadog, you can set up dashboards and monitors. To get started, go to [Datadog](https://app.datadoghq.com/account/login).
5767

5868
## FAQs
5969

6070
### Q: Can I create service hook subscriptions programmatically?
6171

62-
A: Yes. For more information, see [Create a service hooks subscription programmatically](../create-subscription.md). Submit to either of the following Datadog endpoints:
72+
A: Yes. For more information, see [Create a service hook subscription programmatically](../create-subscription.md). Your Datadog account type determines the endpoint that your subscription should submit requests to. Use one of the following endpoints:
6373

64-
- **US:** `https://app.datadoghq.com/intake/webhook/azuredevops?api_key=<API_KEY>`
65-
- **EU:** `https://app.datadoghq.eu/intake/webhook/azuredevops?api_key=<API_KEY>`
66-
- **US3:** `https://us3.datadoghq.com/intake/webhook/azuredevops?api_key=<API_KEY>`
67-
- **US5:** `https://us5.datadoghq.com/intake/webhook/azuredevops?api_key=<API_KEY>`
68-
- **AP1:** `https://ap1.datadoghq.com/intake/webhook/azuredevops?api_key=<API_KEY>`
69-
- **Gov:** `https://app.ddog-gov.com/intake/webhook/azuredevops?api_key=<API_KEY>`
74+
| Account type | Endpoint |
75+
| --- | --- |
76+
| US | `https://app.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>` |
77+
| EU | `https://app.datadoghq.eu/intake/webhook/azuredevops?api_key=<API-key>` |
78+
| US3 | `https://us3.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>` |
79+
| US5 | `https://us5.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>` |
80+
| AP1 | `https://ap1.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>` |
81+
| Gov | `https://app.ddog-gov.com/intake/webhook/azuredevops?api_key=<API-key>` |
7082

7183
### Q: How can I use these events in Datadog?
7284

0 commit comments

Comments
 (0)