2022-11-30 15:50:20 -06:00
---
2022-12-12 08:33:46 -06:00
aliases:
- /docs/grafana/latest/setup-grafana/configure-grafana/feature-toggles/
2023-06-08 11:16:55 -05:00
description: Learn about feature toggles, which you can enable or disable.
2022-11-30 15:50:20 -06:00
title: Configure feature toggles
weight: 150
---
<!-- DO NOT EDIT THIS PAGE, it is machine generated by running the test in -->
<!-- https://github.com/grafana/grafana/blob/main/pkg/services/featuremgmt/toggles_gen_test.go#L19 -->
# Configure feature toggles
2023-06-08 11:16:55 -05:00
You use feature toggles, also known as feature flags, to enable or disable features in Grafana. You can turn on feature toggles to try out new functionality in development or test environments.
2022-11-30 15:50:20 -06:00
2023-05-18 09:50:20 -05:00
This page contains a list of available feature toggles. To learn how to turn on feature toggles, refer to our [Configure Grafana documentation ]({{< relref "../_index.md#feature_toggles" >}} ). Feature toggles are also available to Grafana Cloud Advanced customers. If you use Grafana Cloud Advanced, you can open a support ticket and specify the feature toggles and stack for which you want them enabled.
2022-11-30 15:50:20 -06:00
2023-06-08 11:16:55 -05:00
## Feature toggles
2022-11-30 15:50:20 -06:00
2023-06-08 11:16:55 -05:00
Some features are enabled by default. You can disable these feature by setting the feature flag to "false" in the configuration.
2022-11-30 15:50:20 -06:00
2023-05-30 08:15:22 -05:00
| Feature toggle name | Description | Enabled by default |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `disableEnvelopeEncryption` | Disable envelope encryption (emergency only) | |
| `featureHighlights` | Highlight Grafana Enterprise features | |
| `exploreMixedDatasource` | Enable mixed datasource in Explore | Yes |
| `dataConnectionsConsole` | Enables a new top-level page called Connections. This page is an experiment that provides a better experience when you install and configure data sources and other plugins. | Yes |
| `topnav` | Enables new top navigation and page layouts | Yes |
| `cloudWatchCrossAccountQuerying` | Enables cross-account querying in CloudWatch datasources | Yes |
| `newPanelChromeUI` | Show updated look and feel of grafana-ui PanelChrome: panel header, icons, and menu | Yes |
| `accessTokenExpirationCheck` | Enable OAuth access_token expiration check and token refresh using the refresh_token | |
| `emptyDashboardPage` | Enable the redesigned user interface of a dashboard page that includes no panels | Yes |
| `disablePrometheusExemplarSampling` | Disable Prometheus exemplar sampling | |
| `logsSampleInExplore` | Enables access to the logs sample feature in Explore | Yes |
| `logsContextDatasourceUi` | Allow datasource to provide custom UI for context view | Yes |
| `prometheusDataplane` | Changes responses to from Prometheus to be compliant with the dataplane specification. In particular it sets the numeric Field.Name from 'Value' to the value of the `__name__` label when present. | Yes |
| `lokiMetricDataplane` | Changes metric responses from Loki to be compliant with the dataplane specification. | Yes |
| `dataplaneFrontendFallback` | Support dataplane contract field name change for transformations and field name matchers where the name is different | Yes |
| `alertingNotificationsPoliciesMatchingInstances` | Enables the preview of matching instances for notification policies | Yes |
| `useCachingService` | When turned on, the new query and resource caching implementation using a wire service inject will be used in place of the previous middleware implementation | |
| `advancedDataSourcePicker` | Enable a new data source picker with contextual information, recently used order and advanced mode | Yes |
2022-11-30 15:50:20 -06:00
2023-06-08 11:16:55 -05:00
## Preview feature toggles
2022-11-30 15:50:20 -06:00
2023-04-14 04:24:35 -05:00
| Feature toggle name | Description |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `trimDefaults` | Use cue schema to remove values that will be applied automatically |
| `panelTitleSearch` | Search for dashboards using panel title |
| `prometheusAzureOverrideAudience` | Experimental. Allow override default AAD audience for Azure Prometheus endpoint |
2023-05-11 13:31:19 -05:00
| `publicDashboards` | Enables public access to dashboards |
2023-04-14 04:24:35 -05:00
| `migrationLocking` | Lock database during migrations |
| `correlations` | Correlations page |
| `newDBLibrary` | Use jmoiron/sqlx rather than xorm for a few backend services |
| `validateDashboardsOnSave` | Validate dashboard JSON POSTed to api/dashboards/db |
| `autoMigrateOldPanels` | Migrate old angular panels to supported versions (graph, table-old, worldmap, etc) |
| `disableAngular` | Dynamic flag to disable angular at runtime. The preferred method is to set `angular_support_enabled` to `false` in the [security] settings, which allows you to change the state at runtime. |
| `grpcServer` | Run the GRPC server |
| `accessControlOnCall` | Access control primitives for OnCall |
2023-04-17 07:54:32 -05:00
| `nestedFolders` | Enable folder nesting |
2023-04-14 04:24:35 -05:00
| `alertingNoNormalState` | Stop maintaining state of alerts that are not firing |
| `renderAuthJWT` | Uses JWT-based auth for rendering instead of relying on remote cache |
2023-06-06 08:12:09 -05:00
| `refactorVariablesTimeRange` | Refactor time range variables flow to reduce number of API calls made when query variables are chained |
2023-04-14 04:24:35 -05:00
| `enableElasticsearchBackendQuerying` | Enable the processing of queries and responses in the Elasticsearch data source through backend |
2023-05-04 19:35:10 -05:00
| `faroDatasourceSelector` | Enable the data source selector within the Frontend Apps section of the Frontend Observability |
2023-04-24 09:46:31 -05:00
| `enableDatagridEditing` | Enables the edit functionality in the datagrid panel |
2023-05-23 08:18:00 -05:00
| `dataSourcePageHeader` | Apply new pageHeader UI in data source edit page |
2023-06-06 11:28:52 -05:00
| `sqlDatasourceDatabaseSelection` | Enables previous SQL data source dataset dropdown behavior |
2022-11-30 15:50:20 -06:00
2023-06-08 11:16:55 -05:00
## Experimental feature toggles
2022-11-30 15:50:20 -06:00
These features are early in their development lifecycle and so are not yet supported in Grafana Cloud.
2023-06-08 11:16:55 -05:00
Experimental features might be changed or removed without prior notice.
2022-11-30 15:50:20 -06:00
2023-05-12 10:09:30 -05:00
| Feature toggle name | Description |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `live-service-web-worker` | This will use a webworker thread to processes events rather than the main thread |
| `queryOverLive` | Use Grafana Live WebSocket to execute backend queries |
2023-06-19 05:03:51 -05:00
| `lokiExperimentalStreaming` | Support new streaming approach for loki (prototype, needs special loki build) |
2023-05-12 10:09:30 -05:00
| `storage` | Configurable storage for dashboards, datasources, and resources |
| `newTraceViewHeader` | Shows the new trace view header |
| `datasourceQueryMultiStatus` | Introduce HTTP 207 Multi Status for api/ds/query |
| `traceToMetrics` | Enable trace to metrics links |
| `prometheusWideSeries` | Enable wide series responses in the Prometheus datasource |
| `canvasPanelNesting` | Allow elements nesting |
| `scenes` | Experimental framework to build interactive dashboards |
| `disableSecretsCompatibility` | Disable duplicated secret storage in legacy tables |
| `logRequestsInstrumentedAsUnknown` | Logs the path for requests that are instrumented as unknown |
| `redshiftAsyncQueryDataSupport` | Enable async query data support for Redshift |
| `athenaAsyncQueryDataSupport` | Enable async query data support for Athena |
| `showDashboardValidationWarnings` | Show warnings when dashboards do not validate against the schema |
| `mysqlAnsiQuotes` | Use double quotes to escape keyword in a MySQL query |
| `showTraceId` | Show trace ids for requests |
| `alertingBacktesting` | Rule backtesting API for alerting |
| `editPanelCSVDragAndDrop` | Enables drag and drop for CSV and Excel files |
| `lokiQuerySplitting` | Split large interval queries into subqueries with smaller time intervals |
| `lokiQuerySplittingConfig` | Give users the option to configure split durations for Loki queries |
| `individualCookiePreferences` | Support overriding cookie preferences per user |
| `onlyExternalOrgRoleSync` | Prohibits a user from changing organization roles synced with external auth providers |
| `traceqlSearch` | Enables the 'TraceQL Search' tab for the Tempo datasource which provides a UI to generate TraceQL queries |
| `prometheusMetricEncyclopedia` | Replaces the Prometheus query builder metric select option with a paginated and filterable component |
| `timeSeriesTable` | Enable time series table transformer & sparkline cell type |
| `prometheusResourceBrowserCache` | Displays browser caching options in Prometheus data source configuration |
| `influxdbBackendMigration` | Query InfluxDB InfluxQL without the proxy |
| `clientTokenRotation` | Replaces the current in-request token rotation so that the client initiates the rotation |
| `disableSSEDataplane` | Disables dataplane specific processing in server side expressions. |
| `alertStateHistoryLokiSecondary` | Enable Grafana to write alert state history to an external Loki instance in addition to Grafana annotations. |
| `alertStateHistoryLokiPrimary` | Enable a remote Loki instance as the primary source for state history reads. |
| `alertStateHistoryLokiOnly` | Disable Grafana alerts from emitting annotations when a remote Loki instance is available. |
| `unifiedRequestLog` | Writes error logs to the request logger |
| `pyroscopeFlameGraph` | Changes flame graph to pyroscope one |
| `extraThemes` | Enables extra themes |
2023-06-02 05:52:36 -05:00
| `lokiPredefinedOperations` | Adds predefined query operations to Loki query editor |
2023-06-05 03:51:36 -05:00
| `pluginsFrontendSandbox` | Enables the plugins frontend sandbox |
2023-06-12 08:49:52 -05:00
| `cloudWatchLogsMonacoEditor` | Enables the Monaco editor for CloudWatch Logs queries |
2023-06-15 06:25:34 -05:00
| `exploreScrollableLogsContainer` | Improves the scrolling behavior of logs in Explore |
2023-06-14 07:34:22 -05:00
| `recordedQueriesMulti` | Enables writing multiple items from a single query within Recorded Queries |
2023-06-16 12:55:49 -05:00
| `alertingLokiRangeToInstant` | Rewrites eligible loki range queries to instant queries |
2023-06-19 09:34:06 -05:00
| `flameGraphV2` | New version of flame graph with new features |
2022-11-30 15:50:20 -06:00
## Development feature toggles
2023-05-18 09:50:20 -05:00
The following toggles require explicitly setting Grafana's [app mode ]({{< relref "../_index.md#app_mode" >}} ) to 'development' before you can enable this feature toggle. These features tend to be experimental.
2022-11-30 15:50:20 -06:00
2023-04-11 08:21:19 -05:00
| Feature toggle name | Description |
| --------------------- | -------------------------------------------------------------- |
| `entityStore` | SQL-based entity store (requires storage flag also) |
| `externalServiceAuth` | Starts an OAuth2 authentication provider for external services |
