Επεξεργασία

Κοινή χρήση μέσω

Create a service hook for Azure DevOps with Datadog

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

You can 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.

This article shows you how to use service hooks to send Azure DevOps events to Datadog.

Important

The Datadog feature might not be turned on by default in Azure DevOps Server 2020 and 2019, 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:

exec prc_SetRegistryValue 1, '#\FeatureAvailability\Entries\ServiceHooks.Consumers.datadog\AvailabilityState\', 1

Prerequisites

Category Requirements
Permissions - Member of the Project Collection Administrators group. Organization owners are automatically members of this group.
- Edit subscriptions and View subscriptions permissions set to Allow. By default, only project administrators have these permissions. To grant the permissions to other users, you can use the command-line tool or the Security REST API.
Tools Datadog. In the Datadog application, go to your profile and then select Organization Settings > API Keys. Create a new key or select an existing one, and then copy the key to your clipboard.

Send Azure DevOps events to Datadog

To send Azure DevOps events to Datadog, you set up a subscription for each type of event.

Create a subscription for an event

  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.

  2. Select Create subscription.

    Screenshot of the Service Hooks page of an Azure DevOps project. The Create subscription button is highlighted.

  3. In the list of services, select Datadog, and then select Next.

    Screenshot of the Service page in the New service hooks subscription wizard. In the service list, Datadog is highlighted. Next is also highlighted.

  4. Select an event to trigger on, configure any filters that you want to use, and then select Next.

    Screenshot of the Trigger page in the New service hooks subscription wizard. The event list, two filters, and the Next button are highlighted.

  5. Configure the action to perform when the event happens:

    • Under Datadog API Key, enter your Datadog API key.

    • Under Datadog Account Type, select your account type. You can determine your account type from the hostname of the URL that your Datadog account uses.

      URL hostname Account type
      app.datadoghq.com US
      app.datadoghq.eu EU
      us3.datadoghq.com US3
      us5.datadoghq.com US5
      ap1.datadoghq.com AP1
      app.dog-gov.com GOV

  6. To verify that Azure DevOps can use your configuration settings and successfully create a subscription, select Test.

  7. To finish creating the subscription, select Finish.

    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.

Add subscriptions for other events

Repeat the steps in 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.

Use your data in Datadog

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.

FAQs

Q: Can I create service hook subscriptions programmatically?

A: Yes. For more information, see Create a service hook subscription programmatically. Your Datadog account type determines the endpoint that your subscription should submit requests to. Use one of the following endpoints:

Account type Endpoint
US https://app.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
EU https://app.datadoghq.eu/intake/webhook/azuredevops?api_key=<API-key>
US3 https://us3.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
US5 https://us5.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
AP1 https://ap1.datadoghq.com/intake/webhook/azuredevops?api_key=<API-key>
Gov https://app.ddog-gov.com/intake/webhook/azuredevops?api_key=<API-key>

Q: How can I use these events in Datadog?

A: Azure DevOps events that are sent to Datadog are useful for creating dashboards, setting up monitors, and finding correlations during troubleshooting. You can also use event data to get insights into how processes in your developer operations affect application performance.

Q: What event types can I send to Datadog?

A: Datadog accepts all event types.

Q: Can I get more general information about Datadog?

A: Yes, see datadoghq.com.