Use and manage variables

Variables are scoped by organization.

Both and custom dashboard variables are stored in a record associated with each dashboard. Reference each variable using dot-notation (e.g. v.variableName).

When building Flux queries for dashboard cells, view available dashboard variables in the Variables tab next to the Functions tab.

Click a variable name to add it to your query and select a value from the Value dropdown.

When you apply a variable to your dashboard, &vars[variable_name]=value is appended to the URL so you can share the link with the variables included.

v.timeRangeStart

Specifies the beginning of the queried time range. This variable is typically used to define the start parameter of the function.

The Time Range selector defines the value of this variable.

v.timeRangeStop

Specifies the end of the queried time range. This variable is typically used to define the stop parameter of the range() function.

The Time Range selector defines the value of this variable. It defaults to now.

v.windowPeriod

Specifies the period of windowed data. This variable is typically used to define the or period parameters of the window() function in data aggregation operations.

The value of this variable is calculated by analyzing the duration of the Flux query it is used within. Queries that fetch data from a longer time range will have a larger v.windowPeriod duration.

Create dashboard variables in the Data Explorer, from the Organization page, or import a variable.

Use and manage variables

Use and manage variables

v.timeRangeStart

v.timeRangeStop

v.windowPeriod

Update a variable

Export a variable

Variable types