v1.tagValues() function

v1.tagValues() returns a list of unique values for a given tag.

Results include a single table with a single column, _value.

Function type signature

(
    bucket: string,
    tag: string,
    ?predicate: (
        r: {
            A with
            _value: B,
            _time: time,
            _stop: time,
            _start: time,
            _measurement: string,
            _field: string,
        },
    ) => bool,
    ?start: C,
    ?stop: D,
) => stream[E] where E: Record

Parameters

bucket

(Required) Bucket to return unique tag values from.

tag

(Required) Tag to return unique values from.

predicate

Predicate function that filters tag values. Default is (r) => true.

start

Oldest time to include in results. Default is -30d.

stop

Newest time include in results. The stop time is exclusive, meaning values with a time equal to stop time are excluded from the results. Default is now().

Relative start times are defined using negative durations. Negative durations are relative to now(). Absolute start times are defined using time values.

Examples

Query unique tag values from an InfluxDB bucket

import "influxdata/influxdb/v1"

v1.tagValues(bucket: "example-bucket", tag: "host")