配置功能开关

您可以使用功能开关（也称为功能标志）在 Grafana 中启用或禁用功能。您可以在开发或测试环境中打开功能开关以试用新功能。

此页面包含可用功能开关的列表。要了解如何打开功能开关，请参阅我们的《配置 Grafana 文档》。功能开关也可供 Grafana Cloud Advanced 客户使用。如果您是 Grafana Cloud Advanced 客户，可以提交支持工单并指定您希望为其启用功能开关的技术栈。

有关功能发布阶段的更多信息，请参阅《Grafana Labs 发布生命周期》和《管理功能开关》。

通用可用功能开关

大多数通用可用功能默认启用。您可以通过在配置中将功能标志设置为“false”来禁用这些功能。

功能开关名称	描述	默认启用
`disableEnvelopeEncryption`	禁用信封加密（仅限紧急情况）
`publicDashboardsScene`	启用使用场景渲染公共面板	是
`featureHighlights`	突出显示 Grafana Enterprise 功能
`correlations`	关联页面	是
`cloudWatchCrossAccountQuerying`	在 CloudWatch 数据源中启用跨账户查询	是
`nestedFolders`	启用文件夹嵌套	是
`logsContextDatasourceUi`	允许数据源为上下文视图提供自定义 UI	是
`lokiQuerySplitting`	将大间隔查询拆分为更小时间间隔的子查询	是
`influxdbBackendMigration`	无需代理即可查询 InfluxDB InfluxQL	是
`dataplaneFrontendFallback`	支持转换和字段名称匹配器中数据平面契约字段名称更改，其中名称不同	是
`unifiedRequestLog`	将错误日志写入请求日志记录器	是
`pluginsDetailsRightPanel`	为插件详情页面启用右侧面板	是
`recordedQueriesMulti`	启用在记录的查询中从单个查询写入多个项目	是
`logsExploreTableVisualisation`	Explore 中日志的表格可视化	是
`transformationsRedesign`	启用转换重设计	是
`awsAsyncQueryCaching`	为 Redshift 和 Athena 的异步查询启用缓存。要求数据源启用了缓存和异步查询支持。	是
`angularDeprecationUI`	在面板中显示 Angular 警告	是
`dashgpt`	在面板中启用 AI 支持的功能	是
`alertingInsights`	显示新的报警洞察落地页	是
`externalCorePlugins`	允许核心插件作为外部插件加载	是
`panelMonitoring`	通过日志和测量启用面板监控	是
`formatString`	启用格式字符串转换器	是
`kubernetesPlaylists`	在前端使用 kubernetes API 处理播放列表，并将 /api/playlist 请求路由到 k8s	是
`kubernetesClientDashboardsFolders`	将文件夹和面板服务请求路由到 k8s	是
`recoveryThreshold`	为阈值服务器端表达式启用功能恢复阈值（也称滞后）	是
`lokiStructuredMetadata`	使 loki 数据源能够从 Loki 服务器请求结构化元数据	是
`addFieldFromCalculationStatFunctions`	将累积函数和窗口函数添加到从计算转换中添加字段	是
`annotationPermissionUpdate`	通过将注释权限限制到文件夹和面板来改变其工作方式。	是
`dashboardSceneForViewers`	为查看者角色启用使用场景渲染面板	是
`dashboardSceneSolo`	为单独面板启用使用场景渲染面板	是
`dashboardScene`	为所有角色启用使用场景渲染面板	是
`ssoSettingsApi`	在 Grafana 中启用 SSO 设置 API 和 OAuth 配置 UI	是
`logsInfiniteScrolling`	在 Explore 和面板中为日志面板启用无限滚动	是
`alertingSimplifiedRouting`	允许用户在编辑或创建警报规则时直接指定联系点，以便轻松配置警报通知	是
`logRowsPopoverMenu`	启用选择日志行文本时显示过滤菜单	是
`lokiQueryHints`	为 Loki 启用查询提示	是
`alertingQueryOptimization`	优化符合条件的查询以减少数据源负载
`onPremToCloudMigrations`	启用 Grafana 迁移助手，帮助您轻松将各种本地资源迁移到您的 Grafana Cloud 技术栈。	是
`groupToNestedTableTransformation`	启用分组到嵌套表格转换	是
`newPDFRendering`	面板到 PDF 渲染的新实现	是
`tlsMemcached`	在企业缓存功能中使用启用 TLS 的 memcached	是
`ssoSettingsSAML`	使用新的 SSO 设置 API 配置 SAML 连接器	是
`cloudWatchNewLabelParsing`	更新 CloudWatch 标签解析以提高准确性	是
`newDashboardSharingComponent`	启用新的共享抽屉设计	是
`pluginProxyPreserveTrailingSlash`	保留插件代理尾随斜杠。
`azureMonitorPrometheusExemplars`	允许将 Azure Monitor 配置为可提供 Prometheus 示例的数据源	是
`pinNavItems`	启用导航项固定	是
`failWrongDSUID`	如果数据源具有无效 UID，则抛出错误	是
`alertingApiServer`	将警报 API 注册到 K8s API 服务器	是
`cloudWatchRoundUpEndTime`	将指标查询的结束时间向上取整到下一分钟，以避免数据丢失	是
`newFiltersUI`	在场景架构中为即席过滤器变量启用新的组合框样式 UI	是
`alertingQueryAndExpressionsStepMode`	为警报查询和表达式启用步进模式	是
`useSessionStorageForRedirection`	使用会话存储处理登录后的重定向	是
`pluginsSriChecks`	为插件资产启用 SRI 检查
`prometheusUsesCombobox`	为 Prometheus 查询编辑器使用新的 Combobox 组件	是
`azureMonitorDisableLogLimit`	当设置为 true 时，禁用 Azure Monitor 的日志限制。此限制默认启用。
`preinstallAutoUpdate`	启用预安装插件的自动更新	是
`reportingUseRawTimeRange`	使用原始报告或面板时间范围，而不是进行绝对转换	是
`alertingUIOptimizeReducer`	在创建新的警报规则并使用即时查询时，允许从报警 UI 中移除 Reducer	是
`azureMonitorEnableUserAuth`	仅为 Azure Monitor 数据源启用用户认证	是
`alertingNotificationsStepMode`	在通知部分启用简化的步进模式	是
`lokiLabelNamesQueryApi`	默认使用 Loki 的 /labels API 而不是 /series	是
`unifiedNavbars`	启用统一导航栏

公共预览功能开关

公共预览功能由我们的支持团队提供支持，但可能仅限于启用、配置和部分故障排除。

功能开关名称	描述
`panelTitleSearch`	使用面板标题搜索面板
`grpcServer`	运行 GRPC 服务器
`renderAuthJWT`	使用基于 JWT 的认证进行渲染，而不是依赖远程缓存
`refactorVariablesTimeRange`	重构时间范围变量流程，减少链式查询变量时的 API 调用次数
`faroDatasourceSelector`	在前端可观测性的“前端应用程序”部分启用数据源选择器
`enableDatagridEditing`	在数据网格面板中启用编辑功能
`sqlDatasourceDatabaseSelection`	启用之前 SQL 数据源数据集下拉行为
`reportingRetries`	为报告功能启用渲染重试
`externalServiceAccounts`	插件的自动服务账户和令牌设置
`cloudWatchBatchQueries`	将 CloudWatch 指标查询作为单独的批次运行
`pdfTables`	在报告中启用将表格数据生成为 PDF
`canvasPanelPanZoom`	允许在 canvas 面板中平移和缩放
`regressionTransformation`	启用回归分析转换
`alertingSaveStateCompressed`	启用基于压缩 protobuf 的警报状态存储
`ssoSettingsLDAP`	使用新的 SSO 设置 API 配置 LDAP 连接器
`improvedExternalSessionHandling`	启用对 OAuth 外部会话的改进支持。启用此功能后，用户可能需要重新进行认证。
`elasticsearchCrossClusterSearch`	在 Elasticsearch 数据源中启用跨集群搜索
`improvedExternalSessionHandlingSAML`	启用对 SAML 外部会话的改进支持。确保在 Grafana 中正确配置 NameID 格式，以便 SAML 单点注销正常工作。
`teamHttpHeadersMimir`	为 Mimir 数据源启用 LBAC，以对团队用户的客户端请求应用 LBAC 指标过滤
`alertRuleRestore`	启用警报规则恢复功能
`azureMonitorLogsBuilderEditor`	为 Azure Monitor 数据源启用日志构建器模式
`logsPanelControls`	在 Explore 的日志面板中启用控制组件

开发功能开关

以下开关要求您在启用此功能开关之前，明确将 Grafana 的应用程序模式设置为“development”。这些功能通常是实验性的。

功能开关名称	描述
`grafanaAPIServerWithExperimentalAPIs`	将实验性 API 注册到 k8s API 服务器，包括所有数据源
`grafanaAPIServerEnsureKubectlAccess`	启动附加的 https 处理程序并写入 kubectl 选项