使用 Datadog 为 Azure DevOps 创建服务挂钩

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

可以在 Datadog 中创建事件和指标,以响应 Azure DevOps 中的事件。 在 Datadog 中,可以使用这些指标和事件来创建仪表板、排查问题,以及创建监视器来提醒你出现关键问题。 Datadog 接受所有 Azure DevOps 事件类型。

本文介绍如何使用服务挂钩将 Azure DevOps 事件发送到 Datadog。

重要

默认情况下,Azure DevOps Server 2020 和 2019 中可能无法打开 Datadog 功能,这是一个已知问题。 在解析之前,可以在 Tfs_Configuration 数据库中使用以下 SQL 命令来启用该功能:

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

先决条件

类别 要求
权限 - 项目集合管理员组的成员。 组织所有者自动是此组的成员。
- 编辑订阅查看订阅权限设置为允许。 默认情况下,只有项目管理员具有这些权限。 若要向其他用户授予权限,可以使用命令行工具或 安全 REST API。
工具 Datadog。 在 Datadog 应用程序中,进入个人资料,然后选择 组织设置>API 密钥。 创建新密钥或选择现有密钥,然后将密钥复制到剪贴板。

将 Azure DevOps 事件发送到 Datadog

若要将 Azure DevOps 事件发送到 Datadog,请为每种事件类型设置订阅。

为事件创建订阅

  1. 转到 Azure DevOps 项目,选择 “项目设置”,然后选择 “服务挂钩”。 或者,转到 https://{organization-name}/{project-name}/_settings/serviceHooks

  2. 选择“创建订阅”。

    Azure DevOps 项目的“服务挂钩”页的屏幕截图。突出显示了“创建订阅”按钮。

  3. 在服务列表中,选择 Datadog,然后选择“ 下一步”。

    “新建服务钩子订阅向导”中“服务”页的屏幕截图。在服务列表中,Datadog 被突出显示。然后,“下一步”也被突出显示。

  4. 选择要触发的事件,配置要使用的任何筛选器,然后选择“ 下一步”。

    “新建服务钩子订阅向导”中的“触发页”的屏幕截图。事件列表、两个筛选器和“下一步”按钮已被突出显示。

  5. 配置在事件发生时要执行的动作:

    • Datadog API 密钥下,输入 Datadog API 密钥。

    • Datadog 帐户类型下,选择帐户类型。 可以从 Datadog 帐户使用的 URL 的主机名确定帐户类型。

      URL 主机名 科目类型
      app.datadoghq.com 美国
      app.datadoghq.eu EU
      us3.datadoghq.com US3
      us5.datadoghq.com US5
      ap1.datadoghq.com AP1
      app.dog-gov.com 政府
  6. 若要验证 Azure DevOps 是否可以使用配置设置并成功创建订阅,请选择“ 测试”。

  7. 若要完成订阅创建,请选择“ 完成”。

    “新建服务挂钩订阅向导”中“操作”页面的屏幕截图,其中显示了密钥和帐户类型,并突出显示了“测试和完成”。

添加其他事件的订阅

针对要发送到 Datadog 的每个事件类型重复 创建事件订阅 中的步骤。 Datadog 接受并鼓励用户发送所有事件类型。

在 Datadog 中使用数据

当事件发生及其数据和指标开始流入 Datadog 时,可以设置仪表板和监视器。 若要开始,请转到 Datadog

常见问题

问:是否可以以编程方式创建服务挂钩订阅?

答:是的。 有关详细信息,请参阅 以编程方式创建服务挂钩订阅。 Datadog 帐户类型确定订阅应向其提交请求的终结点。 使用以下终结点之一:

科目类型 端点
美国 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>
州长 https://app.ddog-gov.com/intake/webhook/azuredevops?api_key=<API-key>

问:如何在 Datadog 中使用这些事件?

答:发送到 Datadog 的 Azure DevOps 事件对于在故障排除期间创建仪表板、设置监视器和查找关联非常有用。 还可以使用事件数据来深入了解开发人员作中的进程如何影响应用程序性能。

问:可以向 Datadog 发送哪些事件类型?

答:Datadog 接受所有事件类型。

问:是否可以获取有关 Datadog 的更多常规信息?

答:是的,请参阅 datadoghq.com