The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
grafana/docs/sources/setup-grafana/configure-grafana/feature-toggles/index.md

53 KiB

aliases description title weight
[/docs/grafana/latest/setup-grafana/configure-grafana/feature-toggles/] Learn about feature toggles, which you can enable or disable. Configure feature toggles 150

Configure feature toggles

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.

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.

For more information about feature release stages, refer to Release life cycle for Grafana Labs and Manage feature toggles.

General availability feature toggles

Most generally available features are enabled by default. You can disable these feature by setting the feature flag to "false" in the configuration.

Feature toggle name Description Enabled by default
disableEnvelopeEncryption Disable envelope encryption (emergency only)
publicDashboardsScene Enables public dashboard rendering using scenes Yes
featureHighlights Highlight Grafana Enterprise features
correlations Correlations page Yes
cloudWatchCrossAccountQuerying Enables cross-account querying in CloudWatch datasources Yes
nestedFolders Enable folder nesting Yes
logsContextDatasourceUi Allow datasource to provide custom UI for context view Yes
lokiQuerySplitting Split large interval queries into subqueries with smaller time intervals Yes
influxdbBackendMigration Query InfluxDB InfluxQL without the proxy Yes
prometheusRunQueriesInParallel Enables running Prometheus queries in parallel Yes
dataplaneFrontendFallback Support dataplane contract field name change for transformations and field name matchers where the name is different Yes
unifiedRequestLog Writes error logs to the request logger Yes
pluginsDetailsRightPanel Enables right panel for the plugins details page Yes
recordedQueriesMulti Enables writing multiple items from a single query within Recorded Queries Yes
logsExploreTableVisualisation A table visualisation for logs in Explore Yes
transformationsRedesign Enables the transformations redesign Yes
traceQLStreaming Enables response streaming of TraceQL queries of the Tempo data source
awsAsyncQueryCaching Enable caching for async queries for Redshift and Athena. Requires that the datasource has caching and async query support enabled Yes
angularDeprecationUI Display Angular warnings in dashboards and panels Yes
dashgpt Enable AI powered features in dashboards Yes
alertingInsights Show the new alerting insights landing page Yes
externalCorePlugins Allow core plugins to be loaded as external Yes
panelMonitoring Enables panel monitoring through logs and measurements Yes
formatString Enable format string transformer Yes
kubernetesPlaylists Use the kubernetes API in the frontend for playlists, and route /api/playlist requests to k8s Yes
recoveryThreshold Enables feature recovery threshold (aka hysteresis) for threshold server-side expression Yes
lokiStructuredMetadata Enables the loki data source to request structured metadata from the Loki server Yes
addFieldFromCalculationStatFunctions Add cumulative and window functions to the add field from calculation transformation Yes
annotationPermissionUpdate Change the way annotation permissions work by scoping them to folders and dashboards. Yes
dashboardSceneForViewers Enables dashboard rendering using Scenes for viewer roles Yes
dashboardSceneSolo Enables rendering dashboards using scenes for solo panels Yes
dashboardScene Enables dashboard rendering using scenes for all roles Yes
ssoSettingsApi Enables the SSO settings API and the OAuth configuration UIs in Grafana Yes
logsInfiniteScrolling Enables infinite scrolling for the Logs panel in Explore and Dashboards Yes
exploreMetrics Enables the new Grafana Metrics Drilldown core app Yes
alertingSimplifiedRouting Enables users to easily configure alert notifications by specifying a contact point directly when editing or creating an alert rule Yes
logRowsPopoverMenu Enable filtering menu displayed when text of a log line is selected Yes
lokiQueryHints Enables query hints for Loki Yes
alertingQueryOptimization Optimizes eligible queries in order to reduce load on datasources
groupToNestedTableTransformation Enables the group to nested table transformation Yes
newPDFRendering New implementation for the dashboard-to-PDF rendering Yes
tlsMemcached Use TLS-enabled memcached in the enterprise caching feature Yes
ssoSettingsSAML Use the new SSO Settings API to configure the SAML connector Yes
cloudWatchNewLabelParsing Updates CloudWatch label parsing to be more accurate Yes
newDashboardSharingComponent Enables the new sharing drawer design Yes
pluginProxyPreserveTrailingSlash Preserve plugin proxy trailing slash.
azureMonitorPrometheusExemplars Allows configuration of Azure Monitor as a data source that can provide Prometheus exemplars Yes
pinNavItems Enables pinning of nav items Yes
failWrongDSUID Throws an error if a data source has an invalid UIDs Yes
alertingApiServer Register Alerting APIs with the K8s API server Yes
cloudWatchRoundUpEndTime Round up end time for metric queries to the next minute to avoid missing data Yes
newFiltersUI Enables new combobox style UI for the Ad hoc filters variable in scenes architecture Yes
alertingQueryAndExpressionsStepMode Enables step mode for alerting queries and expressions Yes
useSessionStorageForRedirection Use session storage for handling the redirection after login Yes
pluginsSriChecks Enables SRI checks for plugin assets
prometheusUsesCombobox Use new Combobox component for Prometheus query editor Yes
azureMonitorDisableLogLimit Disables the log limit restriction for Azure Monitor when true. The limit is enabled by default.
preinstallAutoUpdate Enables automatic updates for pre-installed plugins Yes
reportingUseRawTimeRange Uses the original report or dashboard time range instead of making an absolute transformation Yes
alertingUIOptimizeReducer Enables removing the reducer from the alerting UI when creating a new alert rule and using instant query Yes
azureMonitorEnableUserAuth Enables user auth for Azure Monitor datasource only Yes
alertingNotificationsStepMode Enables simplified step mode in the notifications section Yes
lokiLabelNamesQueryApi Defaults to using the Loki /labels API instead of /series Yes

Public preview feature toggles

Public preview features are supported by our Support teams, but might be limited to enablement, configuration, and some troubleshooting.

Feature toggle name Description
panelTitleSearch Search for dashboards using panel title
autoMigrateOldPanels Migrate old angular panels to supported versions (graph, table-old, worldmap, etc)
autoMigrateGraphPanel Migrate old graph panel to supported time series panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateTablePanel Migrate old table panel to supported table panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigratePiechartPanel Migrate old piechart panel to supported piechart panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateWorldmapPanel Migrate old worldmap panel to supported geomap panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateStatPanel Migrate old stat panel to supported stat panel - broken out from autoMigrateOldPanels to enable granular tracking
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
renderAuthJWT Uses JWT-based auth for rendering instead of relying on remote cache
refactorVariablesTimeRange Refactor time range variables flow to reduce number of API calls made when query variables are chained
faroDatasourceSelector Enable the data source selector within the Frontend Apps section of the Frontend Observability
enableDatagridEditing Enables the edit functionality in the datagrid panel
sqlDatasourceDatabaseSelection Enables previous SQL data source dataset dropdown behavior
reportingRetries Enables rendering retries for the reporting feature
externalServiceAccounts Automatic service account and token setup for plugins
cloudWatchBatchQueries Runs CloudWatch metrics queries as separate batches
pdfTables Enables generating table data as PDF in reporting
canvasPanelPanZoom Allow pan and zoom in canvas panel
regressionTransformation Enables regression analysis transformation
onPremToCloudMigrations Enable the Grafana Migration Assistant, which helps you easily migrate on-prem resources, such as dashboards, folders, and data source configurations, to your Grafana Cloud stack.
alertingSaveStateCompressed Enables the compressed protobuf-based alert state storage
ssoSettingsLDAP Use the new SSO Settings API to configure LDAP
improvedExternalSessionHandling Enables improved support for OAuth external sessions. After enabling this feature, users might need to re-authenticate themselves.
elasticsearchCrossClusterSearch Enables cross cluster search in the Elasticsearch datasource
improvedExternalSessionHandlingSAML Enables improved support for SAML external sessions. Ensure the NameID format is correctly configured in Grafana for SAML Single Logout to function properly.
teamHttpHeadersMimir Enables LBAC for datasources for Mimir to apply LBAC filtering of metrics to the client requests for users in teams
exploreMetricsUseExternalAppPlugin Use the externalized Grafana Metrics Drilldown (formerly known as Explore Metrics) app plugin
alertRuleRestore Enables the alert rule restore feature

Experimental feature toggles

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

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
lokiExperimentalStreaming Support new streaming approach for loki (prototype, needs special loki build)
storage Configurable storage for dashboards, datasources, and resources
canvasPanelNesting Allow elements nesting
disableSecretsCompatibility Disable duplicated secret storage in legacy tables
logRequestsInstrumentedAsUnknown Logs the path for requests that are instrumented as unknown
showDashboardValidationWarnings Show warnings when dashboards do not validate against the schema
mysqlAnsiQuotes Use double quotes to escape keyword in a MySQL query
alertingBacktesting Rule backtesting API for alerting
editPanelCSVDragAndDrop Enables drag and drop for CSV and Excel files
lokiShardSplitting Use stream shards to split queries into smaller subqueries
lokiQuerySplittingConfig Give users the option to configure split durations for Loki queries
individualCookiePreferences Support overriding cookie preferences per user
influxqlStreamingParser Enable streaming JSON parser for InfluxDB datasource InfluxQL query language
lokiLogsDataplane Changes logs responses from Loki to be compliant with the dataplane specification.
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.
extraThemes Enables extra themes
lokiPredefinedOperations Adds predefined query operations to Loki query editor
awsDatasourcesTempCredentials Support temporary security credentials in AWS plugins for Grafana Cloud customers
mlExpressions Enable support for Machine Learning in server-side expressions
datasourceAPIServers Expose some datasources as apiservers.
provisioning Next generation provisioning... and git
permissionsFilterRemoveSubquery Alternative permission filter implementation that does not use subqueries for fetching the dashboard folder
aiGeneratedDashboardChanges Enable AI powered features for dashboards to auto-summary changes when saving
sseGroupByDatasource Send query to the same datasource in a single request when using server side expressions. The cloudWatchBatchQueries feature toggle should be enabled if this used with CloudWatch.
libraryPanelRBAC Enables RBAC support for library panels
wargamesTesting Placeholder feature flag for internal testing
pluginsAPIMetrics Sends metrics of public grafana packages usage by plugins
enableNativeHTTPHistogram Enables native HTTP Histograms
disableClassicHTTPHistogram Disables classic HTTP Histogram (use with enableNativeHTTPHistogram)
kubernetesSnapshots Routes snapshot requests from /api to the /apis endpoint
kubernetesDashboards Use the kubernetes API in the frontend for dashboards
kubernetesClientDashboardsFolders Route the folder and dashboard service requests to k8s
datasourceQueryTypes Show query type endpoints in datasource API servers (currently hardcoded for testdata, expressions, and prometheus)
queryService Register /apis/query.grafana.app/ -- will eventually replace /api/ds/query
queryServiceRewrite Rewrite requests targeting /ds/query to the query service
queryServiceFromUI Routes requests to the new query service
queryServiceFromExplore Routes explore requests to the new query service
cachingOptimizeSerializationMemoryUsage If enabled, the caching backend gradually serializes query responses for the cache, comparing against the configured [caching]max_value_mb value as it goes. This can can help prevent Grafana from running out of memory while attempting to cache very large query responses.
prometheusCodeModeMetricNamesSearch Enables search for metric names in Code Mode, to improve performance when working with an enormous number of metric names
alertmanagerRemoteSecondary Enable Grafana to sync configuration and state with a remote Alertmanager.
alertmanagerRemotePrimary Enable Grafana to have a remote Alertmanager instance as the primary Alertmanager.
alertmanagerRemoteOnly Disable the internal Alertmanager and only use the external one defined.
extractFieldsNameDeduplication Make sure extracted field names are unique in the dataframe
dashboardNewLayouts Enables experimental new dashboard layouts
pluginsSkipHostEnvVars Disables passing host environment variable to plugin processes
tableSharedCrosshair Enables shared crosshair in table panel
kubernetesFeatureToggles Use the kubernetes API for feature toggle management in the frontend
newFolderPicker Enables the nested folder picker without having nested folders enabled
secretsManagementAppPlatform Enable the secrets management API and services under app platform
scopeApi In-development feature flag for the scope api using the app platform.
sqlExpressions Enables SQL Expressions, which can execute SQL queries against data source results.
nodeGraphDotLayout Changed the layout algorithm for the node graph
kubernetesAggregator Enable grafana's embedded kube-aggregator
expressionParser Enable new expression parser
disableNumericMetricsSortingInExpressions In server-side expressions, disable the sorting of numeric-kind metrics by their metric name or labels.
queryLibrary Enables Query Library feature in Explore
logsExploreTableDefaultVisualization Sets the logs table as default visualisation in logs explore
alertingListViewV2 Enables the new alert list view design
dashboardRestore Enables deleted dashboard restore feature
alertingCentralAlertHistory Enables the new central alert history.
dataplaneAggregator Enable grafana dataplane aggregator
tableNextGen Allows access to the new react-data-grid based table component.
lokiSendDashboardPanelNames Send dashboard and panel names to Loki when querying
alertingPrometheusRulesPrimary Uses Prometheus rules as the primary source of truth for ruler-enabled data sources
exploreLogsShardSplitting Used in Logs Drilldown to split queries into multiple queries based on the number of shards
exploreLogsAggregatedMetrics Used in Logs Drilldown to query by aggregated metrics
exploreLogsLimitedTimeRange Used in Logs Drilldown to limit the time range
homeSetupGuide Used in Home for users who want to return to the onboarding flow or quickly find popular config pages
appSidecar Enable the app sidecar feature that allows rendering 2 apps at the same time
rolePickerDrawer Enables the new role picker drawer design
unifiedStorageBigObjectsSupport Enables to save big objects in blob storage
timeRangeProvider Enables time pickers sync
playlistsReconciler Enables experimental reconciler for playlists
exploreMetricsRelatedLogs Display Related Logs in Grafana Metrics Drilldown
prometheusSpecialCharsInLabelValues Adds support for quotes and special characters in label values for Prometheus queries
enableExtensionsAdminPage Enables the extension admin page regardless of development mode
enableSCIM Enables SCIM support for user and group management
crashDetection Enables browser crash detection reporting to Faro.
jaegerBackendMigration Enables querying the Jaeger data source without the proxy
unifiedHistory Displays the navigation history so the user can navigate back to previous pages
investigationsBackend Enable the investigations backend API
k8SFolderCounts Enable folder's api server counts
k8SFolderMove Enable folder's api server move
templateVariablesUsesCombobox Use new Combobox component for template variables
grafanaAdvisor Enables Advisor app
elasticsearchImprovedParsing Enables less memory intensive Elasticsearch result parsing
newLogsPanel Enables the new logs panel in Explore
pluginsCDNSyncLoader Load plugins from CDN synchronously
assetSriChecks Enables SRI checks for Grafana JavaScript assets
localeFormatPreference Specify the locale so we can show the correct format for numbers and dates
localizationForPlugins Enables localization for plugins

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 name Description
grafanaAPIServerWithExperimentalAPIs Register experimental APIs with the k8s API server, including all datasources
grafanaAPIServerEnsureKubectlAccess Start an additional https handler and write kubectl options