本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接到 Datadog 数据来源
<a name="AMG-datadog-datasource-plugin"></a>

 Datadog 数据来源使您能够在 Amazon Managed Grafana 中可视化来自 Datadog 监控服务的指标。

**注意**  
此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 [管理对 Enterprise 插件的访问](upgrade-to-enterprise-plugins.md)。  
此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。

## 用法
<a name="datadog-usage"></a>

### 缓存
<a name="datadog-caching"></a>

 对于进行大量查询的大型控制面板，Datadog API 可能会限制其速率（达到 Datadog API 允许的每小时最大 API 调用次数）。缓存功能可将唯一查询缓存 60 秒。该时间间隔可在配置页面上更改为更长或更短。

### 查询编辑器
<a name="datadog-query-editor"></a>

 很简单易用，只需选择聚合和指标。如果要筛选结果，请选择一个或多个标签。

 Datadog 数据来源支持 Datadog 查询编辑器支持的所有高级函数。从下拉列表中选择，然后通过选择函数名称进行排列。

 **“按别名”字段用法选项**：
+  在“按别名”字段中输入别名。
+  使用作用域变量：
  +  `$__metric` = 替换为指标名称 
  +  `$__display_name` = 替换为指标名称 
  +  `$__expression` = 替换为完整的指标表达式 
  +  `$__aggr` = 替换为指标聚合函数（例如，avg、max、min、sum） 
  +  `$__scope` = 替换为指标范围（例如，region、site、env、host） 
+  使用正则表达式：
  +  在`/you regexp here/flags`格式化的 “别名 RegExp” 字段中输入您的正则表达式。
  +  如果 “Alias by” 字段为空，则将使用连接 RegExp 结果。指标表达式为 = 的示例`avg:system.load.5{*}`：“Alias by” 字段输入：“" "Alias RegExp" 字段输入：`avg:(.+)\.(\d)`结果：`system.load, 5`
  +  在“按别名”字段中使用 `$<group_number>` 变量。指标表达式为 = 的示例`avg:system.load.5{*}`：“别名依据” 字段输入：`$1: $2 seconds`“别名 RegExp” 字段输入：`avg:(.+)\.(\d)`结果：`system.load: 5 seconds`
  +  使用 `$0` 获取整个表达式。指标表达式为 = 的示例`datadog.dogstatsd.packet.count{*}`：“别名依据” 字段输入：`Expression: $0`“别名 RegExp” 字段输入：`DOGstatsd\.(.*)\.(.*){\*}/i`结果：`Expression: datadog.dogstatsd.packet.count{*}`

   注意：使用不存在的组号码会出错。

#### 指标算术运算
<a name="datadog-metric-arithmetic"></a>

 要使用指标算术运算，请将*查询类型*设置为*算术*。使用 `#` 符号链接到所需的指标。例如，`#A * 2` 会使查询 `A` 的结果翻倍。两个指标之间的算术运算方式相同：添加要用于计算的结果的查询，然后在第三个查询中链接到这些指标，例如 `#A / #B`。

### Annotations
<a name="datadog-annotations"></a>

 注释是叠加在图表上的事件，事件的例子包括部署或中断。使用此数据来源，您可以从 Datadog 获取事件并将其叠加到 Amazon Managed Grafana 中的图表上。可以按来源、标签或优先级筛选注释事件。

### 模板化
<a name="datadog-templating"></a>

 有几个选项可以获取模板变量的值，即指标和标签。要获取可用指标列表，请在*查询*字段中指定 `*`。

 要返回所有标签，请使用值：`tag` 或 `scope`。

 要返回指定标签组的标签，请使用以下默认类别值之一：
+  `host` 
+  `device` 
+  `env` 
+  `region` 
+  `site` 
+  `status` 
+  `version` 

 对于自定义标签组，只需输入标签组名称即可。例如，如果您的自定义标签组名称是 `subscription_name`，请在*查询*字段中输入该名称。

 使用*正则表达式*字段筛选结果。使用标签时，支持多值变量：多个选定的标签值将转换为逗号分隔的标签列表。

#### 临时筛选条件
<a name="datadog-ad-hoc-filters"></a>

 Grafana 中有一种特殊类型的新模板变量，称为*临时筛选条件。*此变量将应用于控制面板中的*所有* Datadog 查询。这样就可以像快速筛选器一样使用它。Datadog 的临时变量会从标签（例如 `region:east, region:west`）中获取所有键值对，并将它们用作查询标签。要创建此变量，请选择*临时筛选条件*类型，并选择您的 Datadog 数据来源。您可以为该变量设置任何名称。