Skip to content

Latest commit

 

History

History
81 lines (53 loc) · 4.49 KB

datadog.md

File metadata and controls

81 lines (53 loc) · 4.49 KB
ms.subservice ms.topic title description ms.assetid ms.author author monikerRange ms.date
azure-devops-service-hooks
conceptual
Create a service hook for Azure DevOps Services and Azure DevOps Server with Datadog.
Use Datadog with your Azure DevOps Services organization
7472f06c-11f3-4603-953c-9a0de5abe29d
chcomley
chcomley
>= azure-devops-2019
11/03/2020

Create a service hook for Azure DevOps with Datadog

[!INCLUDE version-gt-eq-2019]

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.

Important

The Datadog feature may not be turned on by default for Azure DevOps Server 2019 and 2020. This is a known issue. Until it's resolved, you can use the following SQL command in your config database to turn on the feature: exec prc_SetRegistryValue 1, '#\FeatureAvailability\Entries\ServiceHooks.Consumers.datadog\AvailabilityState\', 1

Prerequisites

  1. You must have Edit subscriptions and View subscriptions permissions. 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.
  2. If you don't have a Datadog account, get started with Datadog. a. In the Datadog application, go to Integrations > API. b. Create a new key or select an existing one, and then copy the key to your clipboard.

Start sending Azure DevOps events to Datadog

  1. Go to Project settings > Service hooks: https://{orgName}/{project_name}/_settings/serviceHooks.

  2. Select Create subscription.

    Select Create subscription from the Service hooks page

  3. Choose Datadog among the list of services, and then choose Next.

    :::image type="content" source="../media/select-datadog.png" alt-text="Screenshot with red box around Datadog and Next selections.":::

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

    :::image type="content" source="../media/datadog-trigger-event.png" alt-text="Screenshot of configuration fields for triggering event in Azure DevOps.":::

  5. Configure the action to perform.

    • Paste (ctrl+v) your Datadog API Key into the required field.
    • Indicate whether your Datadog account is US or EU.

  6. Choose Test to verify that Azure DevOps can use the provided configuration and successfully create a subscription.

  7. Once verified, choose Finish to complete the creation of subscription.

    :::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.":::

  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.

  9. Go to Datadog to see events and metrics start to flow into your environment.

FAQs

Q: Can I create service hook subscriptions programmatically?

A: Yes. For more information, see Create a service hooks subscription programmatically. Submit to either of the following Datadog endpoints:

  • 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 them to get insights into how your developer operations processes impact 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.