# 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](/reference/api/_schemas/json-schema-grafana/#auth-azuread) | no |  |
| `auth_basic_enabled` | boolean | no |  |
| `auth_generic_oauth` | [Auth Generic Oauth](/reference/api/_schemas/json-schema-grafana/#auth-generic-oauth) | no |  |
| `auth_github` | [Auth Github](/reference/api/_schemas/json-schema-grafana/#auth-github) | no |  |
| `auth_gitlab` | [Auth Gitlab](/reference/api/_schemas/json-schema-grafana/#auth-gitlab) | no |  |
| `auth_google` | [Auth Google](/reference/api/_schemas/json-schema-grafana/#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<br/><br/>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<br/><br/>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](/reference/api/_schemas/json-schema-grafana/#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](/reference/api/_schemas/json-schema-grafana/#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 {#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 {#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 {#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 {#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 {#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 {#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 {#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 |  |

