已弃用录制查询

警告
录制查询已弃用。请改用新的Grafana 管理的录制规则。

录制查询允许您通过在设定的时间间隔获取数据点快照来查看随时间变化的趋势。这可以帮助您洞察历史趋势。

对于不返回时间序列的插件，绘制历史数据可能会很有用。例如，您可能想查询 ServiceNow 以查看请求响应时间的历史记录，但它只能返回当前的即时指标。

注意
可用版本
Grafana Enterprise 和 Grafana Cloud。

录制查询的工作原理

注意
在使用录制查询之前，管理员必须配置一个 Prometheus 数据源并将其与远程写入目标关联。

录制查询仅适用于后端数据源插件。有关后端数据源插件的更多信息，请参阅后端数据源插件。您可以录制四种类型的查询

单行单列 - 返回单行单列的查询。
行计数 - 返回需要计数的有意义行的查询。
表达式 - 任何表达式。要了解如何创建和使用表达式，请参阅编写表达式查询。
数据平面数字类型 - 返回数据平面数字类型数据的查询。

创建或启用录制查询后，它会立即创建快照，并以设定的时间间隔继续创建快照。当录制查询被禁用、删除或 Grafana 未运行时，它会停止获取快照。数据点通过运行录制查询并在后端收集，并将每个结果转发到启用了远程写入的 Prometheus 实例。

使用录制查询

要使用录制查询，请创建一个并将其添加到仪表盘。之后，可以在“首选项”的“录制查询”选项卡中对其进行管理。

创建录制查询

在仪表盘的编辑面板中查找/创建一个您想要录制的查询。查询必须只返回一行一列。如果返回多行多列，您仍然可以使用“计数”选项录制返回结果的数量。
- 查询的数据源必须是后端数据源。
- 表达式可用于聚合时间序列查询的数据。请参阅编写表达式查询，了解如何创建和使用表达式的更多信息。
点击查询编辑器右上角的录制查询按钮。
输入录制查询信息。所有字段均为必填项，除非另有说明。
- 名称 - 录制查询的名称。
- 描述 - （可选）描述录制查询，使其在录制查询列表中按您希望的方式显示。
- 间隔 - 获取快照的时间间隔。间隔从您创建录制查询时开始，如果您暂停或删除录制查询，它将停止。有关暂停和删除录制查询的更多信息，请参阅管理录制查询。
- 范围 - 查询的相对时间范围。如果您选择 30m 的范围和 1h 的间隔，则查询将每小时获取过去 30 分钟的快照。
- 计数查询结果 - 如果您想计数查询返回的行数，请启用此选项。如果此选项关闭，您的查询必须返回一行一个值。
点击测试录制查询按钮测试您的录制查询。
点击 开始录制查询 以开始录制您的查询。

添加录制查询

您可以将现有的录制查询添加到仪表盘中的面板。对于您添加的每个录制查询，都会创建一个 Prometheus 查询：generated_recorded_query_name{id="generated_id", name="recorded query name"}。从 Prometheus 创建的查询返回所有录制查询收集到的快照。