JSON Schema Grafana

Properties

Property	Type	Required	Description
`alerting_enabled`	boolean	no
`alerting_error_or_timeout`	string	no	Allowed values: `alerting`, `keep_state`.
`alerting_max_annotations_to_keep`	integer	no	Min: `0`. Max: `1e+06`.
`alerting_nodata_or_nullvalues`	string	no	Allowed values: `alerting`, `no_data`, `keep_state`, `ok`.
`allow_embedding`	boolean	no
`auth_azuread`	Auth Azuread	no
`auth_basic_enabled`	boolean	no
`auth_generic_oauth`	Auth Generic Oauth	no
`auth_github`	Auth Github	no
`auth_gitlab`	Auth Gitlab	no
`auth_google`	Auth Google	no
`cookie_samesite`	string	no	Allowed values: `lax`, `strict`, `none`.
`custom_domain`	string	no	Serve the web frontend using a custom CNAME pointing to the Aiven DNS name Max length: `255`.
`dashboard_previews_enabled`	boolean	no	This feature is new in Grafana 9 and is quite resource intensive. It may cause low-end plans to work more slowly while the dashboard previews are rendering.
`dashboards_min_refresh_interval`	string	no	Signed sequence of decimal numbers, followed by a unit suffix (ms, s, m, h, d), e.g. 30s, 1h Max length: `16`.
`dashboards_versions_to_keep`	integer	no	Min: `1`. Max: `100`.
`dataproxy_send_user_header`	boolean	no
`dataproxy_timeout`	integer	no	Min: `15`. Max: `90`.
`date_formats`	Date Formats	no
`disable_gravatar`	boolean	no
`editors_can_admin`	boolean	no
`google_analytics_ua_id`	string	no	Max length: `64`.
`metrics_enabled`	boolean	no
`oauth_allow_insecure_email_lookup`	boolean	no
`service_log`	boolean	no	Store logs for the service so that they are available in the HTTP API and console.
`smtp_server`	SMTP Server	no
`unified_alerting_enabled`	boolean	no
`user_auto_assign_org`	boolean	no
`user_auto_assign_org_role`	string	no	Allowed values: `Viewer`, `Admin`, `Editor`.
`viewers_can_edit`	boolean	no
`wal`	boolean	no	Setting to enable/disable Write-Ahead Logging. The default value is false (disabled).

Auth Azuread

Property	Type	Required	Description
`auth_url`	string	yes	Max length: `2048`.
`client_id`	string	yes	Max length: `1024`.
`client_secret`	string	yes	Max length: `1024`.
`token_url`	string	yes	Max length: `2048`.
`allow_sign_up`	boolean	no
`allowed_domains`	array[string]	no
`allowed_groups`	array[string]	no

Auth Github

Property	Type	Required	Description
`client_id`	string	yes	Max length: `1024`.
`client_secret`	string	yes	Max length: `1024`.
`allow_sign_up`	boolean	no
`allowed_organizations`	array[string]	no
`auto_login`	boolean	no
`skip_org_role_sync`	boolean	no
`team_ids`	array[integer]	no

SMTP Server

Property	Type	Required	Description
`from_address`	string	yes	Max length: `319`.
`host`	string	yes	Max length: `255`.
`port`	integer	yes	Min: `1`. Max: `65535`.
`from_name`	string	no	Max length: `128`.
`password`	string	no	Max length: `255`.
`skip_verify`	boolean	no
`starttls_policy`	string	no	Allowed values: `OpportunisticStartTLS`, `MandatoryStartTLS`, `NoStartTLS`.
`username`	string	no	Max length: `255`.

Auth Gitlab

Property	Type	Required	Description
`allowed_groups`	array[string]	yes
`client_id`	string	yes	Max length: `1024`.
`client_secret`	string	yes	Max length: `1024`.
`allow_sign_up`	boolean	no
`api_url`	string	no	Max length: `2048`.
`auth_url`	string	no	Max length: `2048`.
`token_url`	string	no	Max length: `2048`.

Date Formats

Property	Type	Required	Description
`default_timezone`	string	no	Max length: `64`.
`full_date`	string	no	Max length: `128`.
`interval_day`	string	no	Max length: `128`.
`interval_hour`	string	no	Max length: `128`.
`interval_minute`	string	no	Max length: `128`.
`interval_month`	string	no	Max length: `128`.
`interval_second`	string	no	Max length: `128`.
`interval_year`	string	no	Max length: `128`.

Auth Google

Property	Type	Required	Description
`allowed_domains`	array[string]	yes
`client_id`	string	yes	Max length: `1024`.
`client_secret`	string	yes	Max length: `1024`.
`allow_sign_up`	boolean	no

Auth Generic Oauth

Property	Type	Required	Description
`api_url`	string	yes	Max length: `2048`.
`auth_url`	string	yes	Max length: `2048`.
`client_id`	string	yes	Max length: `1024`.
`client_secret`	string	yes	Max length: `1024`.
`token_url`	string	yes	Max length: `2048`.
`allow_sign_up`	boolean	no
`allowed_domains`	array[string]	no
`allowed_organizations`	array[string]	no
`auto_login`	boolean	no
`name`	string	no	Max length: `128`.
`scopes`	array[string]	no

Last updated on May 29, 2026