配置 Datadog 数据源

文档

插件

Datadog 数据源

配置 Datadog 数据源

Grafana 为 Datadog 提供了许多配置选项。要安装数据源，请参阅安装 Grafana 插件。有关添加数据源的常规信息，请参阅添加数据源。

只有具有组织 administrator 角色的用户才能添加数据源。管理员还可以使用 Grafana 的配置系统通过 YAML 配置数据源。

要安装 Datadog 插件，请访问 Datadog 插件页面上的安装部分。

配置数据源

要添加 Datadog 数据源，请完成以下步骤

安装 Datadog 插件。
点击左侧菜单中的 Connections。
在 Connections 下，点击 Add new connection。
在搜索栏中输入 Datadog。
在 Data Source 部分下选择 Datadog。
点击右上角的 Add new data source。

您将被带到 Settings 选项卡，在那里您将设置您的 Datadog 配置。

请注意，这些说明适用于 Grafana 10.x 版本。

配置选项

以下是 Datadog 的配置选项列表。

第一个要配置的选项是连接的名称

名称 - 数据源名称。这是您在面板和查询中引用数据源的方式。示例：Datadog_Metrics, Datadog-1。
默认 - 切换以在创建查询时将其设置为默认数据源。

连接

您可以通过 2 种不同的连接模式连接到 Datadog：默认或 托管式 Datadog 指标。

模式 - 选择您的 Datadog 连接模式。
- 默认 - 点击连接到 Datadog API 端点。
- 托管式 Datadog 指标 - 此模式现已弃用。有关更多信息，请参阅 Datadog 代理文档。
API URL / 区域 - 与默认模式一起使用。选择您的 Grafana Cloud 区域或站点 URL，或您的 API URL。示例：https://us3.datadoghq.com, https://api/datadohq.com。

身份验证

您的身份验证方式取决于您的连接方法。

如果使用 默认模式 连接，您需要配置以下项进行身份验证

API Key - 输入您组织独有的 Datadog API key。要生成 API key，请参阅要生成 Datadog API key，请参阅添加 API key 或客户端令牌。有关 API key 的更多信息，请参阅 Datadog 文档中的 API 和应用 Key。
App Key - 输入您组织独有的 Datadog 应用 key。应用 key 与 API key 协同工作以授予用户访问权限。要生成应用 key，请参阅添加应用 Key。有关应用 key 的更多信息，请参阅 Datadog 文档中的应用 Key。

附加设置

附加设置是可选设置，您可以配置它们以更好地控制您的 Datadog 数据源。

API 请求速率限制 - 限制对 Datadog API 的访问。
- 显示 API 请求速率限制 - 勾选此框以显示每个查询端点的 Datadog API 限制。要查看 API 请求速率限制，请前往 Explore 中的 Query Inspector，选择 JSON 选项，并将源设置为 DataFrame 结构。
- 启用 API 请求速率限制阈值 - 勾选此框以启用速率限制。一旦达到阈值，Datadog 查询将停止。
- API 请求速率限制阈值 % - 在框中输入一个阈值百分比。当 API 达到指定的速率限制百分比时，插件会阻止后续请求，直到下一次重置。默认值为 100。
禁用数据链接 - 勾选此框以禁用数据链接。数据链接可在面板之间创建链接，当用户与面板交互时，可以将用户直接带到 Datadog 中的相关位置 (URL)。

配置好 Datadog 数据源选项后，点击底部的 保存并测试 以测试您的数据源连接。您也可以点击删除来移除连接。

使用配置系统配置数据源

使用 Grafana 的配置系统通过配置文件配置 Datadog 数据源。要了解有关配置系统工作原理的更多信息，包括所有数据源设置，请参阅配置 Grafana。

您可以使用 YAML 文件定义和配置 Datadog 数据源，作为 Grafana 配置系统的一部分。有关配置数据源的更多信息以及可用的配置选项，请参阅配置 Grafana。

以下示例是用于配置 Datadog 数据源的

apiVersion: 1
datasources:
  - name: DATADOG
    type: grafana-datadog-datasource
    jsonData:
      url: https://api.datadoghq.com
      logApiRateLimits: false
      rateLimitEnabled: false
      rateLimitMetrics: 100
      disableDataLinks: false
    secureJsonData:
      apiKey: xxxxxxxxxxxx (enter your datadog api key here)
      appKey: xxxxxxxxxxxx (enter your datadog application key here)