[Fleet] Add `xpack.fleet.experimentalFeatures` config setting by jillguyonnet · Pull Request #238840 · elastic/kibana

jillguyonnet · 2025-10-14T10:32:12Z

Summary

This PR adds a new xpack.fleet.experimentalFeatures config setting to allow enabling or disabling Fleet experimental features. Explicitly enabling or disabling using this setting overrides the default values defined here:

kibana/x-pack/platform/plugins/shared/fleet/common/experimental_features.ts

Lines 10 to 23 in 82b2d2d

    
           const _allowedExperimentalValues = { 
        
             showExperimentalShipperOptions: false, 
        
             useSpaceAwareness: true, 
        
             enableAutomaticAgentUpgrades: true, 
        
             enableSyncIntegrationsOnRemote: true, 
        
             enableSSLSecrets: false, 
        
             installedIntegrationsTabularUI: true, 
        
             enabledUpgradeAgentlessDeploymentsTask: true, 
        
             enablePackageRollback: false, 
        
             enableAutoInstallContentPackages: true, 
        
             enableOtelIntegrations: true, 
        
             enableAgentStatusAlerting: true, 
        
             enableAgentPrivilegeLevelChange: false, 
        
           };

Furthermore, this new setting takes precedence over the existing xpack.fleet.enableExperimental setting. The latter is now marked as deprecated to encourage users to use the new setting.

I have attempted to replace existing references to xpack.fleet.enableExperimental accordingly.

Docs change

Preview: docs/reference/configuration-reference/fleet-settings.md

Checklist

Documentation was added for features that require explanation or tutorials
Unit or functional tests were updated or added to match the most common scenarios
If a plugin configuration key changed, check if it needs to be allowlisted in the cloud and added to the docker list
The PR description includes the appropriate Release Notes section, and the correct release_note:* label is applied per the guidelines
Review the backport guidelines and apply applicable backport:* labels.

Identify risks

Low probability risk of Fleet experimental features incorrectly enabled or disabled.

MichelLosier

Looking good so far! Just a few things to consider.

x-pack/platform/plugins/shared/fleet/common/experimental_features.test.ts

x-pack/platform/plugins/shared/fleet/server/config.ts

elasticmachine · 2025-10-15T13:32:08Z

Pinging @elastic/fleet (Team:Fleet)

x-pack/platform/plugins/shared/fleet/common/experimental_features.ts

nchaulet · 2025-10-15T13:46:18Z

Looks like there is still some usage of the config directly in public https://github.com/elastic/kibana/blob/main/x-pack/platform/plugins/shared/fleet/public/applications/fleet/sections/agent_policy/create_package_policy_page/components/steps/components/package_policy_input_stream.tsx#L93 (probably can clean as I do not think that experimenal feature exists anymore)

x-pack/platform/plugins/shared/fleet/dev_docs/space_awareness.md

florent-leborgne

Docs update LGTM! Thank you

juliaElastic

LGTM

jillguyonnet · 2025-10-16T15:16:07Z

@elasticmachine merge upstream

…config

jillguyonnet · 2025-10-17T09:57:47Z

@elasticmachine merge upstream

…config

elasticmachine · 2025-10-17T11:56:29Z

💛 Build succeeded, but was flaky

Buildkite Build
Commit: 88bad28

Failed CI Steps

Metrics [docs]

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id	before	after	diff
`fleet`	2.1MB	2.1MB	-122.0B

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id	before	after	diff
`fleet`	178.6KB	178.7KB	+180.0B

History

💔 Build #351832 failed e9ab070
💛 Build #351356 was flaky 148b100
💔 Build #351323 failed 6bc52df
💔 Build #350907 failed 4fcb6ff

cc @jillguyonnet

…c#238840) ## Summary Relates elastic#238084 This PR adds a new `xpack.fleet.experimentalFeatures` config setting to allow enabling or disabling Fleet experimental features. Explicitly enabling or disabling using this setting overrides the default values defined here: https://github.com/elastic/kibana/blob/82b2d2d7b9c4a5d78fb12b53c655a8a72378a234/x-pack/platform/plugins/shared/fleet/common/experimental_features.ts#L10-L23 Furthermore, this new setting takes precedence over the existing `xpack.fleet.enableExperimental` setting. The latter is now marked as deprecated to encourage users to use the new setting. I have attempted to replace existing references to `xpack.fleet.enableExperimental` accordingly. ### Docs change Preview: [docs/reference/configuration-reference/fleet-settings.md](https://docs-v3-preview.elastic.dev/elastic/kibana/pull/238840/reference/configuration-reference/fleet-settings) <img width="913" height="554" alt="Screenshot 2025-10-15 at 14 30 50" src="https://github.com/user-attachments/assets/43815fa6-f7a4-4dcf-8cf5-34058e29d163" /> ### Checklist - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials - [x] [Unit or functional tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html) were updated or added to match the most common scenarios - [ ] If a plugin configuration key changed, check if it needs to be allowlisted in the cloud and added to the [docker list](https://github.com/elastic/kibana/blob/main/src/dev/build/tasks/os_packages/docker_generator/resources/base/bin/kibana-docker) - [x] The PR description includes the appropriate Release Notes section, and the correct `release_note:*` label is applied per the [guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process) - [x] Review the [backport guidelines](https://docs.google.com/document/d/1VyN5k91e5OVumlc0Gb9RPa3h1ewuPE705nRtioPiTvY/edit?usp=sharing) and apply applicable `backport:*` labels. ### Identify risks Low probability risk of Fleet experimental features incorrectly enabled or disabled. --------- Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>

jillguyonnet added Team:Fleet Team label for Observability Data Collection Fleet team backport:skip This PR does not require backporting release_note:enhancement labels Oct 14, 2025

jillguyonnet self-assigned this Oct 14, 2025

jillguyonnet force-pushed the fleet/238084-add-experimentalFeatures-fleet-config branch from b5e0070 to 062b1d8 Compare October 14, 2025 14:12

This comment was marked as outdated.

Sign in to view

[Fleet] Add xpack.fleet.experimentalFeatures config

ba13441

jillguyonnet force-pushed the fleet/238084-add-experimentalFeatures-fleet-config branch from 062b1d8 to ba13441 Compare October 14, 2025 14:16

Update doc

4fcb6ff

MichelLosier reviewed Oct 14, 2025

View reviewed changes

x-pack/platform/plugins/shared/fleet/common/experimental_features.test.ts Outdated Show resolved Hide resolved

x-pack/platform/plugins/shared/fleet/server/config.ts Outdated Show resolved Hide resolved

jillguyonnet added 2 commits October 15, 2025 10:44

Fix tests

dac3935

Feedback

6bc52df

jillguyonnet marked this pull request as ready for review October 15, 2025 13:32

jillguyonnet requested review from a team as code owners October 15, 2025 13:32

jillguyonnet requested review from parkiino and szwarckonrad October 15, 2025 13:32

jillguyonnet requested a review from nchaulet October 15, 2025 13:32

nchaulet reviewed Oct 15, 2025

View reviewed changes

x-pack/platform/plugins/shared/fleet/common/experimental_features.ts Outdated Show resolved Hide resolved

Feedback

148b100

juliaElastic reviewed Oct 15, 2025

View reviewed changes

x-pack/platform/plugins/shared/fleet/dev_docs/space_awareness.md Outdated Show resolved Hide resolved

seanrathier approved these changes Oct 15, 2025

View reviewed changes

florent-leborgne approved these changes Oct 15, 2025

View reviewed changes

Update dev_docs/space_awareness.md

edc84e4

szwarckonrad approved these changes Oct 16, 2025

View reviewed changes

juliaElastic approved these changes Oct 16, 2025

View reviewed changes

jeramysoucy approved these changes Oct 16, 2025

View reviewed changes

Merge branch 'main' into fleet/238084-add-experimentalFeatures-fleet-…

e9ab070

…config

Merge branch 'main' into fleet/238084-add-experimentalFeatures-fleet-…

88bad28

…config

nchaulet approved these changes Oct 17, 2025

View reviewed changes

jillguyonnet merged commit 0f27afc into elastic:main Oct 17, 2025
12 checks passed

jillguyonnet deleted the fleet/238084-add-experimentalFeatures-fleet-config branch October 17, 2025 14:40

kibanamachine added the v9.3.0 label Oct 17, 2025

jillguyonnet mentioned this pull request Oct 21, 2025

[Fleet] Allow to disable feature flags turned on by default #238084

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Fleet] Add `xpack.fleet.experimentalFeatures` config setting#238840

[Fleet] Add `xpack.fleet.experimentalFeatures` config setting#238840
jillguyonnet merged 8 commits intoelastic:mainfrom
jillguyonnet:fleet/238084-add-experimentalFeatures-fleet-config

jillguyonnet commented Oct 14, 2025 •

edited

Loading

This comment was marked as outdated.

MichelLosier left a comment

Uh oh!

Uh oh!

elasticmachine commented Oct 15, 2025

Uh oh!

nchaulet commented Oct 15, 2025 •

edited

Loading

Uh oh!

florent-leborgne left a comment

juliaElastic left a comment

jillguyonnet commented Oct 16, 2025

jillguyonnet commented Oct 17, 2025

elasticmachine commented Oct 17, 2025

Uh oh!

Labels

10 participants

	const _allowedExperimentalValues = {
	showExperimentalShipperOptions: false,
	useSpaceAwareness: true,
	enableAutomaticAgentUpgrades: true,
	enableSyncIntegrationsOnRemote: true,
	enableSSLSecrets: false,
	installedIntegrationsTabularUI: true,
	enabledUpgradeAgentlessDeploymentsTask: true,
	enablePackageRollback: false,
	enableAutoInstallContentPackages: true,
	enableOtelIntegrations: true,
	enableAgentStatusAlerting: true,
	enableAgentPrivilegeLevelChange: false,
	};

Conversation

jillguyonnet commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Docs change

Checklist

Identify risks

This comment was marked as outdated.

MichelLosier left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

elasticmachine commented Oct 15, 2025

Uh oh!

nchaulet commented Oct 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

florent-leborgne left a comment

Choose a reason for hiding this comment

juliaElastic left a comment

Choose a reason for hiding this comment

jillguyonnet commented Oct 16, 2025

jillguyonnet commented Oct 17, 2025

elasticmachine commented Oct 17, 2025

💛 Build succeeded, but was flaky

Failed CI Steps

Metrics [docs]

Async chunks

Page load bundle

History

Uh oh!

Labels

10 participants

jillguyonnet commented Oct 14, 2025 •

edited

Loading

nchaulet commented Oct 15, 2025 •

edited

Loading