Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Configure feature toggles

You use feature toggles, also known as feature flags, to turn experimental or beta features on and off in Grafana. Although we do not recommend using these features in production, you can turn on feature toggles to try out new functionality in development or test environments.

This page contains a list of available feature toggles. To learn how to turn on feature toggles, refer to our Configure Grafana documentation. 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.

Stable feature toggles

Some stable features are enabled by default. You can disable a stable feature by setting the feature flag to “false” in the configuration.

Feature toggle nameDescriptionEnabled by default
disableEnvelopeEncryptionDisable envelope encryption (emergency only)
database_metricsAdd Prometheus metrics for database tables
featureHighlightsHighlight Grafana Enterprise features
cloudWatchDynamicLabelsUse dynamic labels instead of alias patterns in CloudWatch datasourceYes
dataConnectionsConsoleEnables 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
internationalizationEnables internationalizationYes
topnavEnables new top navigation and page layoutsYes
cloudWatchCrossAccountQueryingEnables cross-account querying in CloudWatch datasourcesYes
newPanelChromeUIShow updated look and feel of grafana-ui PanelChrome: panel header, icons, and menuYes
accessTokenExpirationCheckEnable OAuth access_token expiration check and token refresh using the refresh_token
emptyDashboardPageEnable the redesigned user interface of a dashboard page that includes no panelsYes
disablePrometheusExemplarSamplingDisable Prometheus exemplar sampling
logsSampleInExploreEnables access to the logs sample feature in ExploreYes

Beta feature toggles

Feature toggle nameDescription
trimDefaultsUse cue schema to remove values that will be applied automatically
panelTitleSearchSearch for dashboards using panel title
prometheusAzureOverrideAudienceExperimental. Allow override default AAD audience for Azure Prometheus endpoint
migrationLockingLock database during migrations
newDBLibraryUse jmoiron/sqlx rather than xorm for a few backend services
validateDashboardsOnSaveValidate dashboard JSON POSTed to api/dashboards/db
autoMigrateOldPanelsMigrate old angular panels to supported versions (graph, table-old, worldmap, etc)
disableAngularDynamic 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.
accessControlOnCallAccess control primitives for OnCall
alertingNoNormalStateStop maintaining state of alerts that are not firing
disableElasticsearchBackendExploreQueryDisable executing of Elasticsearch Explore queries through backend
renderAuthJWTUses JWT-based auth for rendering instead of relying on remote cache

Alpha feature toggles

These features are early in their development lifecycle and so are not yet supported in Grafana Cloud. Alpha features might be changed or removed without prior notice.

Feature toggle nameDescription
dashboardPreviewsCreate and show thumbnails for dashboard search results
live-service-web-workerThis will use a webworker thread to processes events rather than the main thread
queryOverLiveUse Grafana Live WebSocket to execute backend queries
publicDashboardsEnables public access to dashboards
publicDashboardsEmailSharingEnables public dashboard sharing to be restricted to only allowed emails
lokiLiveSupport WebSocket streaming for loki (early prototype)
lokiDataframeApiUse experimental loki api for WebSocket streaming (early prototype)
storageConfigurable storage for dashboards, datasources, and resources
exploreMixedDatasourceEnable mixed datasource in Explore
newTraceViewShows the new trace view design
correlationsCorrelations page
datasourceQueryMultiStatusIntroduce HTTP 207 Multi Status for api/ds/query
traceToMetricsEnable trace to metrics links
prometheusWideSeriesEnable wide series responses in the Prometheus datasource
canvasPanelNestingAllow elements nesting
scenesExperimental framework to build interactive dashboards
disableSecretsCompatibilityDisable duplicated secret storage in legacy tables
logRequestsInstrumentedAsUnknownLogs the path for requests that are instrumented as unknown
redshiftAsyncQueryDataSupportEnable async query data support for Redshift
athenaAsyncQueryDataSupportEnable async query data support for Athena
showDashboardValidationWarningsShow warnings when dashboards do not validate against the schema
mysqlAnsiQuotesUse double quotes to escape keyword in a MySQL query
elasticsearchBackendMigrationUse Elasticsearch as backend data source
secureSocksDatasourceProxyEnable secure socks tunneling for supported core datasources
authnServiceUse new auth service to perform authentication
alertingBacktestingRule backtesting API for alerting
editPanelCSVDragAndDropEnables drag and drop for CSV and Excel files
logsContextDatasourceUiAllow datasource to provide custom UI for context view
lokiQuerySplittingSplit large interval queries into subqueries with smaller time intervals
lokiQuerySplittingConfigGive users the option to configure split durations for Loki queries
individualCookiePreferencesSupport overriding cookie preferences per user
onlyExternalOrgRoleSyncProhibits a user from changing organization roles synced with external auth providers
drawerDataSourcePickerChanges the user experience for data source selection to a drawer.
traceqlSearchEnables the ‘TraceQL Search’ tab for the Tempo datasource which provides a UI to generate TraceQL queries
prometheusMetricEncyclopediaReplaces the Prometheus query builder metric select option with a paginated and filterable component
timeSeriesTableEnable time series table transformer & sparkline cell type
prometheusResourceBrowserCacheDisplays browser caching options in Prometheus data source configuration
influxdbBackendMigrationQuery InfluxDB InfluxQL without the proxy
clientTokenRotationReplaces the current in-request token rotation so that the client initiates the rotation
prometheusDataplaneChanges 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.
alertStateHistoryLokiSecondaryEnable Grafana to write alert state history to an external Loki instance in addition to Grafana annotations.
alertStateHistoryLokiPrimaryEnable a remote Loki instance as the primary source for state history reads.
alertStateHistoryLokiOnlyDisable Grafana alerts from emitting annotations when a remote Loki instance is available.
unifiedRequestLogWrites error logs to the request logger

Development feature toggles

The following toggles require explicitly setting Grafana’s app mode to ‘development’ before you can enable this feature toggle. These features tend to be experimental.

Feature toggle nameDescription
k8sExplore native k8s integrations
grpcServerRun GRPC server
entityStoreSQL-based entity store (requires storage flag also)
nestedFoldersEnable folder nesting