mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 14:42:18 +08:00
68b588b912
* Schematize prometheus * revert changes * close response body * Update report.json * Update pkg/tsdb/prometheus/models/query.go Co-authored-by: sam boyer <sdboyer@grafana.com> * Use without pointers * remove unused * Specify query format * Rename * Clean up schema * Update public/app/plugins/datasource/prometheus/dataquery.cue Co-authored-by: Ryan McKinley <ryantxu@gmail.com> * Update pkg/tsdb/prometheus/models/query.go Co-authored-by: Ryan McKinley <ryantxu@gmail.com> * Clean up tests * Update public/app/plugins/datasource/prometheus/dataquery.cue Co-authored-by: sam boyer <sdboyer@grafana.com> * make gen-cue * Add comments * Make linter happy * Remove editormode override * Update --------- Co-authored-by: sam boyer <sdboyer@grafana.com> Co-authored-by: Ryan McKinley <ryantxu@gmail.com>
6.1 KiB
6.1 KiB
| keywords | title | ||
|---|---|---|---|
|
PrometheusDataQuery kind |
Both documentation generation and kinds schemas are in active development and subject to change without prior notice.
PrometheusDataQuery
Maturity: experimental
Version: 0.0
It extends DataQuery.
| Property | Type | Required | Description |
|---|---|---|---|
expr |
string | Yes | The actual expression/query that will be evaluated by Prometheus |
refId |
string | Yes | (Inherited from DataQuery) A unique identifier for the query within the list of targets. In server side expressions, the refId is used as a variable name to identify results. By default, the UI will assign A->Z; however setting meaningful names may be useful. |
datasource |
No | (Inherited from DataQuery) For mixed data sources the selected datasource is on the query level. For non mixed scenarios this is undefined. TODO find a better way to do this ^ that's friendly to schema TODO this shouldn't be unknown but DataSourceRef | null |
|
editorMode |
string | No | Possible values are: code, builder. |
exemplar |
boolean | No | Execute an additional query to identify interesting raw samples relevant for the given expr |
format |
string | No | Possible values are: time_series, table, heatmap. |
hide |
boolean | No | (Inherited from DataQuery) 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) |
instant |
boolean | No | Returns only the latest value that Prometheus has scraped for the requested time series |
queryType |
string | No | (Inherited from DataQuery) Specify the query flavor TODO make this required and give it a default |
range |
boolean | No | Returns a Range vector, comprised of a set of time series containing a range of data points over time for each time series |
DataQuery
These are the common properties available to all queries in all datasources. Specific implementations will extend this interface, adding the required properties for the given context.
| Property | Type | Required | Description |
|---|---|---|---|
refId |
string | Yes | A unique identifier for the query within the list of targets. In server side expressions, the refId is used as a variable name to identify results. By default, the UI will assign A->Z; however setting meaningful names may be useful. |
datasource |
No | For mixed data sources the selected datasource is on the query level. For non mixed scenarios this is undefined. TODO find a better way to do this ^ that's friendly to schema TODO this shouldn't be unknown but DataSourceRef | null |
|
hide |
boolean | No | 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) |
queryType |
string | No | Specify the query flavor TODO make this required and give it a default |