apitech
/
grafana
mirror of https://github.com/grafana/grafana
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

DashboardSchema: Add options to VariableModel (#79236)

Browse Source 
* Add includeAll and regex fields to VariableModel  #67639

* Add allValue option to VariableModel
pull/81110/head
Denis 1 year ago committed by GitHub
parent cbdbdf72e5
commit f7fd8e6cd1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 38 additions and 0 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 3
      docs/sources/developers/kinds/core/dashboard/schema-reference.md
  2. 8
      kinds/dashboard/dashboard_kind.cue
  3. 17
      packages/grafana-schema/src/raw/dashboard/x/dashboard_types.gen.ts
  4. 10
      pkg/kinds/dashboard/dashboard_spec_gen.go

3
docs/sources/developers/kinds/core/dashboard/schema-reference.md
Unescape View File

@ -606,15 +606,18 @@ A variable is a placeholder for a value. You can use variables in metric queries
|---------------|-------------------------------------|----------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `name` | string | **Yes** | | Name of variable |
| `type` | string | **Yes** | | Dashboard variable type<br/>`query`: Query-generated list of values such as metric names, server names, sensor IDs, data centers, and so on.<br/>`adhoc`: Key/value filters that are automatically added to all metric queries for a data source (Prometheus, Loki, InfluxDB, and Elasticsearch only).<br/>`constant`: Define a hidden constant.<br/>`datasource`: Quickly change the data source for an entire dashboard.<br/>`interval`: Interval variables represent time spans.<br/>`textbox`: Display a free text input field with an optional default value.<br/>`custom`: Define the variable options manually using a comma-separated list.<br/>`system`: Variables defined by Grafana. See: https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/#global-variables<br/>Possible values are: `query`, `adhoc`, `constant`, `datasource`, `interval`, `textbox`, `custom`, `system`. |
| `allValue` | string | No | | Custom all value |
| `current` | [VariableOption](#variableoption) | No | | Option to be selected in a variable. |
| `datasource` | [DataSourceRef](#datasourceref) | No | | Ref to a DataSource instance |
| `description` | string | No | | Description of variable. It can be defined but `null`. |
| `hide` | integer | No | | Determine if the variable shows on dashboard<br/>Accepted values are 0 (show label and value), 1 (show value only), 2 (show nothing).<br/>Possible values are: `0`, `1`, `2`. |
| `includeAll` | boolean | No | `false` | Whether all value option is available or not |
| `label` | string | No | | Optional display name |
| `multi` | boolean | No | `false` | Whether multiple values can be selected or not from variable value list |
| `options` | [VariableOption](#variableoption)[] | No | | Options that can be selected for a variable. |
| `query` | | No | | Query used to fetch values for a variable |
| `refresh` | integer | No | | Options to config when to refresh a variable<br/>`0`: Never refresh the variable<br/>`1`: Queries the data source every time the dashboard loads.<br/>`2`: Queries the data source when the dashboard time range changes.<br/>Possible values are: `0`, `1`, `2`. |
| `regex` | string | No | | Optional field, if you want to extract part of a series name or metric node segment.<br/>Named capture groups can be used to separate the display text and value. |
| `skipUrlSync` | boolean | No | `false` | Whether the variable value should be managed by URL query params or not |
| `sort` | integer | No | | Sort variable options<br/>Accepted values are:<br/>`0`: No sorting<br/>`1`: Alphabetical ASC<br/>`2`: Alphabetical DESC<br/>`3`: Numerical ASC<br/>`4`: Numerical DESC<br/>`5`: Alphabetical Case Insensitive ASC<br/>`6`: Alphabetical Case Insensitive DESC<br/>`7`: Natural ASC<br/>`8`: Natural DESC<br/>Possible values are: `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`. |

8
kinds/dashboard/dashboard_kind.cue
Unescape View File

@ -199,9 +199,17 @@ lineage: schemas: [{
multi?: bool | *false
// Options that can be selected for a variable.
options?: [...#VariableOption]
// Options to config when to refresh a variable
refresh?: #VariableRefresh
// Options sort order
sort?: #VariableSort
// Whether all value option is available or not
includeAll?: bool | *false
// Custom all value
allValue?: string
// Optional field, if you want to extract part of a series name or metric node segment.
// Named capture groups can be used to separate the display text and value.
regex?: string
...
} @cuetsy(kind="interface") @grafana(TSVeneer="type") @grafanamaturity(NeedsExpertReview)

17
packages/grafana-schema/src/raw/dashboard/x/dashboard_types.gen.ts
Unescape View File

@ -126,6 +126,10 @@ export const defaultAnnotationQuery: Partial<AnnotationQuery> = {
* A variable is a placeholder for a value. You can use variables in metric queries and in panel titles.
*/
export interface VariableModel {
/**
* Custom all value
*/
allValue?: string;
/**
* Shows current selected variable text/value on the dashboard
*/
@ -142,6 +146,10 @@ export interface VariableModel {
* Visibility configuration for the variable
*/
hide?: VariableHide;
/**
* Whether all value option is available or not
*/
includeAll?: boolean;
/**
* Optional display name
*/
@ -162,7 +170,15 @@ export interface VariableModel {
* Query used to fetch values for a variable
*/
query?: (string | Record<string, unknown>);
/**
* Options to config when to refresh a variable
*/
refresh?: VariableRefresh;
/**
* Optional field, if you want to extract part of a series name or metric node segment.
* Named capture groups can be used to separate the display text and value.
*/
regex?: string;
/**
* Whether the variable value should be managed by URL query params or not
*/
@ -178,6 +194,7 @@ export interface VariableModel {
}
export const defaultVariableModel: Partial<VariableModel> = {
includeAll: false,
multi: false,
options: [],
skipUrlSync: false,

10
pkg/kinds/dashboard/dashboard_spec_gen.go
Unescape View File

@ -900,6 +900,9 @@ type VariableHide int
// A variable is a placeholder for a value. You can use variables in metric queries and in panel titles.
type VariableModel struct {
// Custom all value
AllValue *string `json:"allValue,omitempty"`
// Option to be selected in a variable.
Current *VariableOption `json:"current,omitempty"`
@ -913,6 +916,9 @@ type VariableModel struct {
// Accepted values are 0 (show label and value), 1 (show value only), 2 (show nothing).
Hide *VariableHide `json:"hide,omitempty"`
// Whether all value option is available or not
IncludeAll *bool `json:"includeAll,omitempty"`
// Optional display name
Label *string `json:"label,omitempty"`
@ -934,6 +940,10 @@ type VariableModel struct {
// `2`: Queries the data source when the dashboard time range changes.
Refresh *VariableRefresh `json:"refresh,omitempty"`
// Optional field, if you want to extract part of a series name or metric node segment.
// Named capture groups can be used to separate the display text and value.
Regex *string `json:"regex,omitempty"`
// Whether the variable value should be managed by URL query params or not
SkipUrlSync *bool `json:"skipUrlSync,omitempty"`

Write Preview
Loading…
Cancel
Save