跳转到主要内容

Configure feature toggles

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.

Experimental feature toggles are listed in the respective feature's documentation only.

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
cloudWatchCrossAccountQuerying Enables cross-account querying in CloudWatch datasources Yes
lokiQuerySplitting Split large interval queries into subqueries with smaller time intervals Yes
renderAuthJWT Uses JWT-based auth for rendering instead of relying on remote cache Yes
awsDatasourcesTempCredentials Support temporary security credentials in AWS plugins for Grafana Cloud customers Yes
provisioningFolderMetadata Allow setting folder metadata for provisioned folders Yes
awsAsyncQueryCaching Enable caching for async queries for Redshift and Athena. Requires that the data source has caching and async query support enabled Yes
reportingHeaderSettings Enables configuration of PDF report settings
reportingFooterSettings Enables the configurable footer settings for PDF reports
grafana.newPanelQueryErrorsUI Enables a new UI for query errors and notices Yes
useKubernetesShortURLsAPI Routes short URL requests from /api to the /apis endpoint in the frontend. Depends on kubernetesShortURLs Yes
cloudWatchBatchQueries Runs CloudWatch metrics queries as separate batches
annotationPermissionUpdate Change the way annotation permissions work by scoping them to folders and dashboards. Yes
dashboardNewLayouts Enables new dashboard layouts Yes
timeComparison Enables time comparison option in supported panels Yes
alertingQueryOptimization Optimizes eligible queries in order to reduce load on datasources
sqlExpressions Enables SQL Expressions, which can execute SQL queries against data source results. Yes
grafana.filterablePanels Enables interactive grouped-label filtering through the tooltip in state timeline, status history and histogram panels Yes
cloudWatchNewLabelParsing Updates CloudWatch label parsing to be more accurate Yes
playlistsRBAC Enables RBAC for playlists
savedQueriesRBAC Enables Saved queries (query library) RBAC permissions Yes
newSavedQueriesExperience Enables the new Saved queries (query library) modal experience Yes
alertingListViewV2 Enables the new alert list view design Yes
alertingNavigationV2 Enables the new Alerting navigation structure with improved menu grouping Yes
pluginProxyPreserveTrailingSlash Preserve plugin proxy trailing slash.
azureMonitorPrometheusExemplars Allows configuration of Azure Monitor as a data source that can provide Prometheus exemplars Yes
cloudWatchRoundUpEndTime Round up end time for metric queries to the next minute to avoid missing data Yes
useSessionStorageForRedirection Use session storage for handling the redirection after login Yes
azureMonitorDisableLogLimit Disables the log limit restriction for Azure Monitor when true. The limit is enabled by default.
enableSCIM Enables SCIM support for user and group management Yes
azureMonitorEnableUserAuth Enables user auth for Azure Monitor datasource only Yes
lokiLabelNamesQueryApi Defaults to using the Loki /labels API instead of /series Yes
unifiedNavbars Enables unified navbars
grafanaAssistantInProfilesDrilldown Enables integration with Grafana Assistant in Profiles Drilldown Yes
otelLogsFormatting Applies OTel formatting templates to displayed logs Yes
alertingNotificationHistory Enables the notification history feature Yes
newClickhouseConfigPageDesign Enables new design for the Clickhouse data source configuration page Yes
azureResourcePickerUpdates Enables the updated Azure Monitor resource picker Yes
panelTimeSettings Enables a new panel time settings drawer Yes
inlineLogDetailsNoScrolls Enables an inline version of Log Details that creates no new scrolls Yes
lokiAlignedQuerySplitting Aligns query splitting chunks with UTC midnight Yes
profilesHeatmap Enables heatmap visualization support for Pyroscope profiles Yes
datasources.useNewStackInfoToSettingsCache Use the new cache for datasource.StackInfoToSettings, backend flag
grafana.queryVarEditorRedesign Enables a redesigned query variable editor with split-pane preview and a spreadsheet for managing static options Yes
grafana.dashboardSettingsRedesign Redesigns dashboard settings page into Advanced Settings in a modal window Yes
grafana.thresholdsInterpolation Enables using dashboard variables in panel threshold values Yes
grafana.dashboardAutoGridDefault Uses auto grid as the default layout for new dashboards 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
faroDatasourceSelector Enable the data source selector within the Frontend Apps section of the Frontend Observability
externalServiceAccounts Automatic service account and token setup for plugins
grafana.mobileEditDeprecation Disables dashboard edit mode (manual and assistant-driven) on mobile/small-screen viewports
dashboard.notebooks Enable notebooks, a resource in the dashboard API group for mixing text cells, code cells, and visualization panels
feedbackButton Enables the feedback button in the dashboard edit sidebar
pdfTables Enables generating table data as PDF in reporting
canvasPanelPanZoom Allow pan and zoom in canvas panel
secretsManagementAppPlatformUI Enable the secrets management app platform UI
secretsKeeperUI Enable the Secrets Keeper management UI for configuring external secret storage
grafana.secretsReferenceValueUI Enable referencing an existing secret in an active keeper when creating a secure value
dashboardTemplates Enables a flow to get started with a new dashboard from a template
alertRuleRestore Enables the alert rule restore feature
alertingMigrationWizardUI Enables the migration wizard UI to migrate alert rules and notification resources from external sources to Grafana Alerting
azureMonitorLogsBuilderEditor Enables the logs builder mode for the Azure Monitor data source
datasources.azureMonitorBatchAPI Enables the Metrics Batch API for the Azure Monitor data source, allowing up to 50 resources to be queried in a single request
alertingListViewV2PreviewToggle Enables the alerting list view v2 preview toggle
alertingImportAlertmanagerAPI Enables the API to import Alertmanager configuration
grafana.newTextPanel Enables the new text panel
text.newFeatures Enables the new features in text panel
interactiveLearning Enables the interactive learning app
transformationsEmptyPlaceholder Show transformation quick-start cards in empty transformations state
grafana.dashboardGlobalVariables Enables global and folder-scoped dashboard variables via dashboard.grafana.app
pyroscopeUTF8LabelNames Enables support for UTF-8 label names in Pyroscope label selectors
queryEditorNext Enables next generation query editor experience
grafana.viewPanelPane Enables the sidebar pane with new toggles and options in panel view mode
splashScreen Enables the splash screen modal for introducing new Grafana features on first session
dataviz.tabularNums Enables tabular numerals for visualization legend values
grafana.dynamicTraceToLogs Check for the existence of logs when linking from the Trace View

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