Preferences kind | Grafana documentation

Documentation

Grafana documentation

Developers

Grafana schema

Core kinds

Preferences kind

Grafana Cloud Enterprise Open source

Both documentation generation and kinds schemas are in active development and subject to change without prior notice.

Preferences

Maturity: merged

Version: 0.0

The user or team frontend preferences

Property	Type	Required	Description
`metadata`	object	Yes	metadata contains embedded CommonMetadata and can be extended with custom string fields TODO: use CommonMetadata instead of redefining here; currently needs to be defined here without external reference as using the CommonMetadata reference breaks thema codegen.
`spec`	object	Yes	Spec defines user, team or org Grafana preferences swagger:model Preferences
`status`	object	Yes

Metadata

metadata contains embedded CommonMetadata and can be extended with custom string fields TODO: use CommonMetadata instead of redefining here; currently needs to be defined here without external reference as using the CommonMetadata reference breaks thema codegen.

It extends _kubeObjectMetadata.

Property	Type	Required	Description
`createdBy`	string	Yes
`creationTimestamp`	string	Yes	(Inherited from _kubeObjectMetadata)
`extraFields`	object	Yes	extraFields is reserved for any fields that are pulled from the API server metadata but do not have concrete fields in the CUE metadata
`finalizers`	string[]	Yes	(Inherited from _kubeObjectMetadata)
`labels`	map[string]string	Yes	(Inherited from _kubeObjectMetadata)
`resourceVersion`	string	Yes	(Inherited from _kubeObjectMetadata)
`uid`	string	Yes	(Inherited from _kubeObjectMetadata)
`updateTimestamp`	string	Yes
`updatedBy`	string	Yes
`deletionTimestamp`	string	No	(Inherited from _kubeObjectMetadata)

_kubeObjectMetadata

_kubeObjectMetadata is metadata found in a kubernetes object’s metadata field. It is not exhaustive and only includes fields which may be relevant to a kind’s implementation, As it is also intended to be generic enough to function with any API Server.

Property	Type	Required
`creationTimestamp`	string	Yes
`finalizers`	string[]	Yes
`labels`	map[string]string	Yes
`resourceVersion`	string	Yes
`uid`	string	Yes
`deletionTimestamp`	string	No

ExtraFields

extraFields is reserved for any fields that are pulled from the API server metadata but do not have concrete fields in the CUE metadata

Property	Type	Required	Default	Description

Spec

Spec defines user, team or org Grafana preferences swagger:model Preferences

Property	Type	Required	Description
`cookiePreferences`	CookiePreferences	No
`homeDashboardUID`	string	No	UID for the home dashboard
`language`	string	No	Selected language (beta)
`queryHistory`	QueryHistoryPreference	No
`theme`	string	No	light, dark, empty is default
`timezone`	string	No	The timezone selection TODO: this should use the timezone defined in common
`weekStart`	string	No	day of the week (sunday, monday, etc)

CookiePreferences

Property	Type	Required
`analytics`	object	No
`functional`	object	No
`performance`	object	No

Analytics

Property	Type	Required	Default	Description

Functional

Property	Type	Required	Default	Description

Performance

Property	Type	Required	Default	Description

QueryHistoryPreference

Property	Type	Required	Default	Description
`homeTab`	string	No		one of: ’’ \| ‘query’ \| ‘starred’;

Status

Property	Type	Required	Default	Description
`additionalFields`	object	No		additionalFields is reserved for future use
`operatorStates`	map[string]status.#OperatorState	No		operatorStates is a map of operator ID to operator state evaluations. Any operator which consumes this kind SHOULD add its state evaluation information to this field.

AdditionalFields

additionalFields is reserved for future use

Property	Type	Required	Default	Description

Status.#OperatorState

Property	Type	Required	Description
`lastEvaluation`	string	Yes	lastEvaluation is the ResourceVersion last evaluated
`state`	string	Yes	state describes the state of the lastEvaluation. It is limited to three possible states for machine evaluation. Possible values are: `success`, `in_progress`, `failed`.
`descriptiveState`	string	No	descriptiveState is an optional more descriptive state field which has no requirements on format
`details`	object	No	details contains any extra information that is operator-specific