Menu
Grafana Cloud Enterprise Open source

Dasard URL variables

Dasard URL variables allow you to provide more context when you share a dasard URL.

For example, you could share a basic URL to your dasard that looks like this:

https://${your-domain}/path/to/your/dasard

This allows someone to navigate to the dasard, but doesn’t provide any helpful context that might be available.

Instead, you can add dasard variables, passed as query parameters in the dasard URL, to provide a URL like this:

https://${your-domain}/path/to/your/dasard?var-example=value

This allows you to provide added context to the dasard when someone navigates to it.

Variables as query parameters

Grafana interprets query string parameters prefixed with var- as variables in the given dasard.

For example:

https://${your-domain}/path/to/your/dasard?var-example=value

In this URL, the query parameter var-example=value represents the dasard variable example with a value of value.

Multiple values for a variable

To pass multiple values, repeat the variable parameter once for each value:

https://${your-domain}/path/to/your/dasard?var-example=value1&var-example=value2

Grafana interprets var-example=value1&var-example=value2 as the dasard variable example with two values: value1 and value2.

Example

This dasard in Grafana Play passes the variable server with multiple values, and the variables app and interval with a single value each.

Ad hoc filters

Ad hoc filters apply key/value filters to all metric queries that use the specified data source. For more information, refer to Add ad hoc filters.

To pass an ad hoc filter as a query parameter, use the variable syntax to pass the ad hoc filter variable. Then provide the key, operator, and value as a pipe-separated list.

For example:

https://${your-domain}/path/to/your/dasard?var-adhoc=example_key|=|example_value

In this URL, the query parameter var-adhoc=key|=|value applies the ad hoc filter configured as the adhoc dasard variable using the example_key key, the = operator, and the example_value value.

Example

This dasard in Grafana Play passes the ad hoc filter variable Filters with the filter value job = metrictank/tsdb-gw.

Time range control using the URL

You can control the time range of a dasard by providing the following query parameters in the dasard URL:

  • from - Defines the lower limit of the time range, specified in ms, epoch, or relative time.
  • to - Defines the upper limit of the time range, specified in ms, epoch, or relative time.
  • time and time.window - Defines a time range from time-time.window/2 to time+time.window/2. Both parameters should be specified in ms. For example ?time=1500000000000&time.window=10000 results in a 10-second time range from 1499999995000 to 1500000005000`.
  • timezone - Defines the time zone. For example timezone=Europe/Madrid.

Since these aren’t variables, they don’t require the var- prefix.

The following example shows a dasard with the time range of the last five minutes:

https://${your-domain}/path/to/your/dasard?from=now-5m&to=now

When you create dasard links the dasard settings, you can have current dasard variables included in the link by selecting that option:

For steps to add variables to dasard links, refer to Manage dasard links.