文档文档

在 Chronograf 仪表板中使用 Flux

此页面记录了早期版本的 InfluxDB OSS。 InfluxDB OSS v2 是最新的稳定版本。请参阅 InfluxDB v2 文档

Chronograf 是用于管理 InfluxData 平台的 Web 用户界面,可让您创建和自定义可视化数据的仪表板。可视化的数据使用 InfluxQL 或 Flux 查询检索。本指南将引导您完成在 Chronograf 仪表板单元格中使用 Flux 查询的过程。

在仪表板单元格中使用 Flux


Chronograf v1.8+InfluxDB v1.8+ 且 启用了 Flux 是在仪表板中使用 Flux 的必要条件。


要在仪表板单元格中使用 Flux,请创建新单元格或编辑现有单元格,方法是单击单元格右上角的铅笔图标。在图表预览上方的源下拉列表右侧,选择 Flux 作为源类型。

Flux in Chronograf dashboard cells

仅当您的数据源启用了 Flux 时,Flux 源类型才可用。

这将提供模式脚本函数窗格。

模式窗格

模式窗格允许您浏览数据,并为 Flux 脚本添加特定测量、字段和标签的过滤器。

脚本窗格

脚本窗格是您编写 Flux 脚本的地方。在其默认状态下,脚本窗格包含一个可选的 脚本向导,该向导使用选定的选项为您构建 Flux 查询。生成的查询包括返回所需数据所需的所有相关函数和 模板变量

函数窗格

函数窗格提供 Flux 查询中可用函数的列表。单击函数会将该函数添加到脚本窗格中脚本的末尾。将鼠标悬停在函数上会提供该函数的文档以及指向深入文档的链接。

动态源

Chronograf 可以配置多个数据源。源下拉列表允许您选择要连接的特定数据源,但动态源选项也可用。使用动态源,单元格将从 Chronograf 当前连接到的任何数据源查询数据。连接在 Chronograf 的配置选项卡下进行管理。

查看原始数据

在构建 Flux 脚本时,每个函数都以特定于该函数的方式处理或转换您的数据。查看实际数据以了解其形状可能会有所帮助。数据可视化上方的查看原始数据切换在图表数据和表格形式显示的原始数据之间切换。

View raw data

查看原始数据切换仅在使用 Flux 时可用。

Flux 中的模板变量

Chronograf 模板变量 允许您使用 Chronograf 用户界面中提供的元素来更改单元格查询的特定组件。

在您的 Flux 查询中,像引用定义的 Flux 变量一样引用模板变量。以下示例使用 Chronograf 的 预定义模板变量dashboardTimeupperDashboardTimeautoInterval

from(bucket: "telegraf/autogen")
  |> filter(fn: (r) => r._measurement == "cpu")
  |> range(
    start: dashboardTime,
    stop: upperDashboardTime
  )
  window(every: autoInterval)

预定义模板变量

dashboardTime

dashboardTime 模板变量表示范围数据的下限时间。它的值由仪表板中的时间下拉列表控制。它应用于定义 range() 函数的 start 参数。

dataSet
  |> range(
    start: dashboardTime
  )

upperDashboardTime

upperDashboardTime 模板变量表示范围数据的上限时间。当使用绝对时间范围时,其值由仪表板中的时间下拉列表修改。它应用于定义 range() 函数的 stop 参数。

dataSet
  |> range(
    start: dashboardTime,
    stop: upperDashboardTime
  )

作为最佳实践,始终在单元格查询中将 range() 函数的 stop 参数设置为 upperDashboardTime。如果没有它,stop 默认设置为“now”,并且不遵守在时间下拉列表中选择的绝对上限范围,这可能会导致 InfluxDB 上不必要的负载。

autoInterval

autoInterval 模板变量表示仪表板的刷新间隔,并由刷新间隔下拉列表控制。它通常用于使 窗口和聚合 操作中创建的窗口间隔与仪表板刷新对齐。

dataSet
  |> range(
    start: dashboardTime,
    stop: upperDashboardTime
  )
  |> aggregateWindow(
    every: autoInterval,
    fn: mean
  )

自定义模板变量

<% warn %> Chronograf 不支持在 Flux 查询中使用自定义模板变量。 <% /warn %>

使用 Flux 和 InfluxQL

在单个仪表板单元格中,Flux 和 InfluxQL 的使用是互斥的。但是,仪表板可能由不同的单元格组成,每个单元格都使用 Flux 或 InfluxQL。


此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像现在这样使用它,而无需对代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一款开源、高速、近期数据引擎,可实时收集和处理数据,并将其持久保存到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上,增加了高可用性、读取副本、增强的安全性以及数据压缩,从而实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看