已录制的查询

本文档主题专为支持 Grafana 8.x 版本的 Grafana 工作空间而设计。

有关支持 Grafana 版本 10.x 的 Grafana 工作空间，请参阅。在 Grafana 版本 10 中工作

有关支持 Grafana 9.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 9 中工作

您可以使用记录的查询按设定的间隔拍摄数据点的快照，从而查看一段时间内的趋势。这可以让你深入了解历史趋势。

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

录制的查询是如何运作的

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

• 单行和列-返回单行和单列的查询。

• 行数-返回有意义的行进行计数的查询。

• 表达式-任意表达式。要了解有关创建和使用表达式的更多信息，请参阅表达式。

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

注意

必须先配置 Prometheus 数据源并将其与远程写入目标相关联，然后才能使用记录的查询。

创建已录制的查询

要创建记录的查询，请完成以下步骤：

1. 在编辑面板中查找或创建要在仪表板上记录的查询。该查询只能返回一行和一列。如果返回的结果更多，您仍然可以使用 count 选项记录返回的结果数。查询的数据源必须是后端数据源。表达式可用于聚合来自时序查询的数据。要了解有关创建和使用表达式的更多信息，请参阅表达式。

2. 选择位于查询编辑器中的记录查询菜单。

3. 输入记录的查询信息。除非另有说明，否则所有字段均为必填字段。

   • 名称-记录的查询的名称。

   • Description-（可选）描述您希望记录的查询显示在记录的查询列表中。

   • 间隔-拍摄快照的时间间隔。该间隔从您创建录制的查询时开始，如果您暂停或删除已录制的查询，则间隔停止。有关暂停和删除已录制查询的更多信息，请参阅管理录制的查询。

   • 范围-查询的相对时间范围。如果您选择的范围为 30m，间隔为 1h，则查询将在过去 30 分钟内每小时拍摄一次快照。

   • 统计查询结果-如果您想计算查询返回的行数，请启用此选项。如果此选项处于禁用状态，则您的查询必须返回一行，其中包含一个值。

4. 选择 “测试记录的查询” 按钮，测试您录制的查询。

5. 选择 “开始录制查询”。

添加已录制的查询

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

1. 导航到仪表板中要在其中添加已录制查询的面板。

2. 选择 + 已录制查询菜单。

3. 如果要按数据源筛选记录的查询，请从 “按数据源筛选” 下拉菜单中选择一个数据源。

4. 在录制的查询上选择 “添加” 菜单，将其添加到面板中。

将您录制的查询添加到面板后，面板数据源将变为-- Mixed --。您录制的查询由名称标签与您录制的Prometheus查询名称相匹配的查询来表示。要了解有关 Prometheus 数据源的更多信息，请参阅 Prometheus。

如果在添加记录的查询后，出现了使用-- Mixed --数据源而不是 Prometheus 数据源的查询，则可能意味着Prometheus 没有为记录的查询设置远程写入目标。要设置远程写入点，请参阅远程写入目标。

使用录制的查询

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

管理录制的查询

可以暂停或激活录制的查询，也可以从 “首选项” 的 “已录制的查询” 选项卡中将其删除。删除记录的查询会将其从 Grafana 中删除，但在 Prometheus 中收集的信息仍然存在。在恢复查询之前，暂停已录制的查询将不再收集新的数据点。

远程写入目标

远程写入目标是写入记录的查询数据点的 Prometheus 数据源。你需要一台启用了远程写入功能的 Prometheus，你需要为这个 Prometheus 创建一个数据源。

要编辑远程写入目标，请在 “首选项” 的 “录制查询” 选项卡的控制台菜单中选择 “编辑远程写入目标”。选择启用远程写入的 Prometheus 数据源，然后输入远程写入路径。