Datadog 查询编辑器

文档

插件

Datadog 数据源

Datadog 查询编辑器

Grafana 提供了 Datadog 查询编辑器，您可以使用它创建和执行 Datadog 查询、获取监控状态、检索服务级别目标 (SLO)、执行算术运算以及设置图表图例别名。

Datadog 查询编辑器选项

以下是 Datadog 查询类型

查询
原始查询
算术
RUM (真实用户监控)
日志
监控器
活动
SLO (服务级别目标)

查询

使用查询查询类型获取指标。使用可视化查询构建器构建您的查询。

指标 - 从下拉列表中选择一个指标。
From - 从下拉列表中选择一个可选标签。
聚合 - 从下拉列表中选择一个聚合。默认值为 average。
Group by - 点击 + 号 从下拉列表中选择分组选项。您可以选择多个标签。
函数 - 点击 + 号 从下拉列表中选择一个函数。您可以添加多个函数。
Alias by - 使用纯文本添加别名，以更改图表图例中的标题。
Alias RegExp - 使用正则表达式添加别名，以更改图表图例中的标题。

对于 Alias By，可以使用纯文本、如下所示的范围变量，或两者结合。

用于指标的范围变量	替换为
$__metric	指标名称
$__display_name	指标名称
$__expression	完整指标表达式
$__aggr	指标聚合函数（例如 avg, max, min, sum）
$__scope	指标范围（例如 region, site, env, host）
$__tag_name	对应的 tagName。仅适用于 group by 查询。（例如：使用 group by `host` 时，将 `$__tag_host` 用作别名）
$__scope_name	当有多个范围项可用时，使用此别名提取特定的范围名称。（例如：要提取 `host` 范围，将 `$__scope_host` 用作别名）

用于 (SLO) 的范围变量	替换为
$__name	名称（与 `Objective` 下拉列表中选择的相同）
$__aggr	聚合函数（例如 `avg`, `max`, `min`, `sum`）
$__metric	指标名称
$__scope	范围名称
$__numerator	在 SLO 计算中用作分子的指标
$__denominator	在 SLO 计算中用作分母的指标

原始查询

原始查询类似于常规查询，但没有可视化查询构建器。您可以直接在文本框中创建查询。您还可以使用 Alias by 和 Alias RegExp，就像在查询类型查询中使用一样。

算术

算术类型查询执行数学运算，并被视为指标查询。

表达式 - 支持的算术运算包括 +、-、*、/ 和 ()。

注意：算术查询仅支持与其他 datadog 指标查询结合使用。

示例

#A * 2 将查询 A 的结果加倍。

#A / #B 将查询 A 的结果除以查询 B 的结果。

真实用户监控

真实用户监控查询（即 RUM 查询）允许您查询 Datadog RUM 事件。有关 RUM 的更多信息，请参阅什么是真实用户监控？ RUM 查询最多返回 1000 个最新事件。结果会自动按仪表盘的时间范围进行筛选。

注意
RUM 查询目前处于公开预览阶段。

查询模式 - 有 2 种 RUM 查询模式：Search 和 Aggregate。
- Search - RUM 搜索查询返回 RUM 事件。
  - Query - 按照 RUM 搜索语法输入您的查询。
  - 排序 - 选择一个查询排序参数。点击 Timestamp DESC 或 Timestamp ASC。
  - 限制 - 设置返回事件的最大数量。默认值为 1000。
- Aggregate - RUM 聚合查询返回聚合的 RUM 事件。
  - Query - 按照 RUM 搜索语法输入您的查询。
  - 计算 - 计算聚合结果。从下拉菜单中添加一个 Aggregation，一个可选的 Metric（或在选择 count 聚合时使用 *），以及一个 Type，可以是 Total 或 Time Series。
  - Group by - 为您的 Group by 添加一个 Facet 和一个 Limit。Limit 默认值为 1000。
  - 限制 - 响应中事件的最大数量。默认值为 1000。
  - 显示选项 - 添加别名以创建结果的自定义名称。

使用 RUM 查询类型时，可以使用以下别名

用于指标的范围变量	替换为
$__metric	`$__metric` 将替换为指标名称
$__label_xyz	替换为标签 xyz，其中 xyz 可以是 DD 返回的任何有效标签。示例：`$__label_host`
$__no_labels	当您的别名包含 `$__no_labels` 时，grafana 不会为字段附加额外标签

日志

日志查询允许您查询 Datadog 日志。结果会自动按仪表盘的时间范围进行筛选。

查询模式 - 有 2 种日志查询模式：Search 和 Aggregate。
- Search - 使用日志查询语法搜索 Datadog 日志。
  - 搜索查询 - 输入您的日志搜索查询。
  - 排序 - 选择 Timestamp DESC 或 Timestamp ASC 按时间戳排序，并添加可选的 Limit 以设置响应中日志的最大数量。默认值为 1000。
- Aggregate - 将日志和/或事件聚合到存储桶中，并计算指标和时间序列。
  - 计算 - 计算聚合结果。从下拉菜单中添加一个 Aggregation，一个可选的 Metric（或在选择 count 聚合时使用 *），以及一个 Type，可以是 Total 或 Time Series。
  - Group by - 为您的 Group by 添加一个 Facet 和一个 Limit。Limit 默认值为 1000。
  - 限制 - 响应中事件的最大数量。默认值为 1000。
  - 显示选项 - 添加别名以创建结果的自定义名称。

监控器

Grafana 中的警报在 Datadog 中称为监控器。监控器查询获取并列出有关警报的数据和状态信息。有关监控器的更多信息，请参阅监控器类型。有关监控器查询的更多信息，请参阅搜索监控器。

搜索类型 - 从 2 种监控器查询搜索类型中选择：Individual 或 Group。

注意
Group mode 搜索类型目前处于公开预览阶段。

Individual mode - 搜索和筛选您的监控器详细信息。
- 结果类型 - 点击下拉菜单从以下结果类型列表中选择
  - 按状态计数 - 按状态显示监控器数量。
  - 按类型计数 - 按类型显示监控器数量。
  - 按标签计数 - 按标签显示监控器数量。
  - 按静音状态计数 - 按静音状态显示监控器数量。
  - 监控器列表 - 列出所有监控器及其对应的状态及其他相关详细信息。列表选项 包括按 Name、Status 或 Tags 排序，ASC 或 DESC 顺序，以及 Items per page 限制。
- 查询 - 可选。添加一个 Datadog 监控器筛选查询。如果您指定筛选查询，计数或列表将仅返回与查询匹配的监控器。
Group mode - 与单个监控器搜索类似，您也可以搜索和筛选您的监控器组详细信息。有关底层 API 详细信息，请参阅监控器组搜索。此端点需要 monitors_read 授权范围。
- 结果类型 - 点击下拉菜单从以下结果类型列表中选择
  - 按状态计数 - 按状态显示监控器数量。
  - 按类型计数 - 按类型显示监控器数量。
  - 监控器列表 - 列出所有监控器及其对应的状态及其他相关详细信息。列表选项 包括按 Name、Status 或 Tags 排序，ASC 或 DESC 顺序，以及 Items per page 限制。
- 查询 - 可选。添加一个 Datadog 监控器筛选查询。如果您指定筛选查询，计数或列表将仅返回与查询匹配的监控器。

示例

status:(alert OR ok OR "no data" OR warn) 列出状态为 alert、ok、no data 或 warn 中至少一种的监控器。
status:(alert OR warn) type:metric "cassandra" 列出状态为 alert 或 warn 且与“cassandra”相关的指标监控器。
id:(7254197 OR 240232) 仅显示 ID 为 7254197 或 240232 的监控器状态。

注意
对于 监控器列表 选项，由于 API 限制，仅检索和显示由 items per page 设置指定的靠前 n 个监控器。

活动

事件查询允许您查询 Datadog 事件流。有关事件的更多信息，请参阅事件管理。事件查询最多返回 1000 个最新结果。结果也会自动按仪表盘的时间范围进行筛选。

注意
Events 查询类型目前处于公开预览阶段。

按以下项筛选您的结果

来源 - 在查询中输入要筛选的来源列表。
标签 - 在查询中输入要筛选的标签。
优先级 - 选择事件的优先级。选项包括 All、Low 或 Normal。

服务级别目标

通过将 Query type 设置为 SLO 来获取 SLO（服务级别目标）。SLO 会从您的 Datadog 账户中填充。有关更多信息，请参阅服务级别目标和获取 SLO 的历史记录。

对于监控器类型 SLO 查询，您可以选择展开单个监控器结果。

注意
SLO Value 结果类型目前处于公开预览阶段。

结果类型 - 选择一个结果类型：Timeseries 或 Value。
- 时间序列 -
- Value - 仅显示当前的 SLO 值。
Objective - 从下拉列表中选择一个目标。
Alias by - 仅在 Timeseries 结果类型下可用。 使用纯文本添加别名，以更改图表图例中的标题。
Alias RegExp - 仅在 Timeseries 结果类型下可用。 使用正则表达式添加别名，以更改图表图例中的标题。