使用和管理变量

仪表板变量允许您更改单元格查询的特定组件，而无需编辑查询，从而轻松与仪表板单元格交互并探索您的数据。

变量的作用域限定为组织。

使用仪表板变量

预定义仪表板变量和自定义仪表板变量都存储在与每个仪表板关联的 v 记录中。使用点表示法（例如 v.variableName）引用每个变量。

from(bucket: v.bucket)
    |> range(start: v.timeRangeStart, stop: v.timeRangeStop)
    |> filter(fn: (r) => r._measurement == v.measurement and r._field == v.field)
    |> aggregateWindow(every: v.windowPeriod, fn: mean)

在为仪表板单元格构建 Flux 查询时，在“函数”选项卡旁边的“变量”选项卡中查看可用的仪表板变量。

单击变量名称以将其添加到您的查询，并从“值”下拉列表中选择一个值。

链接到 URL 中定义了变量的仪表板

当您将变量应用于仪表板时，&vars[variable_name]=value 将附加到 URL，以便您可以共享包含变量的链接。

预定义仪表板变量

InfluxDB 用户界面 (UI) 提供以下预定义仪表板变量

v.timeRangeStart

指定查询时间范围的开始时间。此变量通常用于定义 range() 函数的 start 参数。

“时间范围”选择器定义此变量的值。

v.timeRangeStop

指定查询时间范围的结束时间。此变量通常用于定义 range() 函数的 stop 参数。

“时间范围”选择器定义此变量的值。它默认为 now。

v.windowPeriod

指定窗口数据的周期。此变量通常用于定义数据聚合操作中 window() 函数的 every 或 period 参数。

此变量的值通过分析使用它的 Flux 查询的持续时间来计算。从较长时间范围获取数据的查询将具有较大的 v.windowPeriod 持续时间。

自定义仪表板变量

在 InfluxDB 用户界面 (UI) 中创建、管理和使用自定义仪表板变量。