Dataquery
Definition
export interface Dataquery {
// Additional Ad-hoc filters that take precedence over Scope on conflict.
adhocFilters?: prometheus.AdhocFilters[];
// The datasource
datasource?: common.DataSourceRef;
// what we should show in the editor
// Possible enum values:
// - `"builder"`
// - `"code"`
editorMode?: prometheus.QueryEditorMode;
// Execute an additional query to identify interesting raw samples relevant for the given expr
exemplar?: boolean;
// The actual expression/query that will be evaluated by Prometheus
expr: string;
// The response format
// Possible enum values:
// - `"time_series"`
// - `"table"`
// - `"heatmap"`
format?: prometheus.PromQueryFormat;
// Group By parameters to apply to aggregate expressions in the query
groupByKeys?: string[];
// true if query is disabled (ie should not be returned to the dashboard)
// NOTE: this does not always imply that the query should not be executed since
// the results from a hidden query may be used as the input to other queries (SSE etc)
hide?: boolean;
// Returns only the latest value that Prometheus has scraped for the requested time series
instant?: boolean;
// Used to specify how many times to divide max data points by. We use max data points under query options
// See https://github.com/grafana/grafana/issues/48081
// Deprecated: use interval
intervalFactor?: number;
// Interval is the suggested duration between time points in a time series query.
// NOTE: the values for intervalMs is not saved in the query model. It is typically calculated
// from the interval required to fill a pixels in the visualization
intervalMs?: number;
// Series name override or template. Ex. {{hostname}} will be replaced with label value for hostname
legendFormat?: string;
// MaxDataPoints is the maximum number of data points that should be returned from a time series query.
// NOTE: the values for maxDataPoints is not saved in the query model. It is typically calculated
// from the number of pixels visible in a visualization
maxDataPoints?: number;
// QueryType is an optional identifier for the type of query.
// It can be used to distinguish different types of queries.
queryType?: string;
// Returns a Range vector, comprised of a set of time series containing a range of data points over time for each time series
range?: boolean;
// RefID is the unique identifier of the query, set by the frontend call.
refId?: string;
// Optionally define expected query result behavior
resultAssertions?: prometheus.ResultAssertions;
// A set of filters applied to apply to the query
scopes?: prometheus.Scopes[];
// TimeRange represents the query range
// NOTE: unlike generic /ds/query, we can now send explicit time values in each query
// NOTE: the values for timeRange are not saved in a dashboard, they are constructed on the fly
timeRange?: prometheus.TimeRange;
// An additional lower limit for the step parameter of the Prometheus query and for the
// `$__interval` and `$__rate_interval` variables.
interval?: string;
_implementsDataqueryVariant(): void;
}
See also