You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[9.0] [DOCS] Consolidate and clean up Kibana settings (part 1) (#214934) (#215048)
# Backport
This will backport the following commits from `main` to `9.0`:
- [[DOCS] Consolidate and clean up Kibana settings (part 1)
(#214934)](#214934)
<!--- Backport version: 9.6.6 -->
### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)
<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"[email protected]"},"sourceCommit":{"committedDate":"2025-03-18T18:37:40Z","message":"[DOCS]
Consolidate and clean up Kibana settings (part 1)
(#214934)","sha":"3b2df8935b7ab386a7b94df5f14737fc1b9b0307","branchLabelMapping":{"^v9.1.0$":"main","^v8.19.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","backport:version","v9.1.0","v9.0.1"],"title":"[DOCS]
Consolidate and clean up Kibana settings (part
1)","number":214934,"url":"https://github.com/elastic/kibana/pull/214934","mergeCommit":{"message":"[DOCS]
Consolidate and clean up Kibana settings (part 1)
(#214934)","sha":"3b2df8935b7ab386a7b94df5f14737fc1b9b0307"}},"sourceBranch":"main","suggestedTargetBranches":["9.0"],"targetPullRequestStates":[{"branch":"main","label":"v9.1.0","branchLabelMappingKey":"^v9.1.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/214934","number":214934,"mergeCommit":{"message":"[DOCS]
Consolidate and clean up Kibana settings (part 1)
(#214934)","sha":"3b2df8935b7ab386a7b94df5f14737fc1b9b0307"}},{"branch":"9.0","label":"v9.0.1","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->
Co-authored-by: Lisa Cawley <[email protected]>
Copy file name to clipboardExpand all lines: docs/reference/configuration-reference.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ navigation_title: "Configuration"
6
6
Configuration settings enable you to customize the behavior of Kibana apps and features.
7
7
This reference provides details about each setting, such as its purpose, default behavior, and availability in Elastic Cloud environments.
8
8
9
-
% TO-DO: For information about how to update these settings, refer to "Configure Kibana" (link to appropriate deployment pages) %
9
+
For information about how to update these settings, refer to the appropriate instructions for your environment. For example, [{{ecloud}} Hosted](docs-content://deploy-manage/deploy/elastic-cloud/edit-stack-settings.md), [{{ece}}](docs-content://deploy-manage/deploy/cloud-enterprise/edit-stack-settings-kibana.md), or [self-managed clusters](docs-content://deploy-manage/deploy/self-managed/configure-kibana.md).
10
10
11
11
The settings are grouped by feature or purpose, for example:
12
12
@@ -16,9 +16,11 @@ The settings are grouped by feature or purpose, for example:
# AI Assistant settings in {{kib}} [ai-assistant-settings-kb]
8
11
9
-
10
12
`xpack.productDocBase.artifactRepositoryUrl`
11
13
: Url of the repository to use to download and install the Elastic product documentation artifacts for the AI assistants. Defaults to `https://kibana-knowledge-base-artifacts.elastic.co`
These settings allow the APM app to function, and specify the data that it surfaces. Unless you’ve customized your setup, you do not need to configure any settings to use the APM app. It is enabled by default.
10
14
15
+
:::{note}
16
+
If a setting is applicable to {{ecloud}} Hosted environments, its name is followed by this icon: 
17
+
:::
18
+
11
19
## APM indices [apm-indices-settings-kb]
12
20
13
21
The APM app uses data views to query APM indices. To change the default APM indices that the APM app queries, open the APM app and select **Settings** > **Indices**. Index settings in the APM app take precedence over those set in `kibana.yml`.
14
22
15
-
Starting in version 8.2.0, APM indices are {{kib}} Spaces-aware; Changes to APM index settings will only apply to the currently enabled space.
16
-
17
-
:::{image} ../../images/apm-settings.png
18
-
:alt: APM app settings in Kibana
19
-
:class: screenshot
20
-
:::
23
+
APM indices are {{kib}} space-aware; changes to APM index settings will only apply to the currently enabled space.
# {{fleet}} settings in {{kib}} [fleet-settings-kb]
8
12
9
13
10
14
::::{note}
11
15
In {{ecloud}}, {{fleet}} flags are already configured.
12
-
16
+
If a setting is applicable to {{ecloud}} Hosted environments, its name is followed by this icon: 
13
17
::::
14
18
15
-
16
-
You can configure `xpack.fleet` settings in your `kibana.yml`. By default, {{fleet}} is enabled. To use {{fleet}}, you also need to configure {{kib}} and {{es}} hosts.
19
+
By default, {{fleet}} is enabled. To use {{fleet}}, you also need to configure {{kib}} and {{es}} hosts.
17
20
18
21
Many {{fleet}} settings can also be configured directly through the {{fleet}} UI. See [Fleet UI settings](docs-content://reference/ingestion-tools/fleet/fleet-settings.md) for details.
19
22
20
-
See the [{{fleet}}](docs-content://reference/ingestion-tools/fleet/index.md) docs for more information about {{fleet}}.
23
+
Go to the [{{fleet}}](docs-content://reference/ingestion-tools/fleet/index.md) docs for more information about {{fleet}}.
21
24
22
25
## General {{fleet}} settings [general-fleet-settings-kb]
23
26
@@ -27,6 +30,9 @@ See the [{{fleet}}](docs-content://reference/ingestion-tools/fleet/index.md) doc
27
30
`xpack.fleet.isAirGapped`
28
31
: Set to `true` to indicate {{fleet}} is running in an air-gapped environment. Refer to [Air-gapped environments](docs-content://reference/ingestion-tools/fleet/air-gapped.md) for details. Enabling this flag helps Fleet skip needless requests and improve the user experience for air-gapped environments.
29
32
33
+
`xpack.fleet.createArtifactsBulkBatchSize`
34
+
: Allow to configure batch size for creating and updating Fleet user artifacts. Examples include creation of Trusted Applications and Endpoint Exceptions in Security. It is available in {{ecloud}} 8.9.0 and later versions.
@@ -342,13 +348,13 @@ These settings are not supported to pre-configure the Endpoint and Cloud Securit
342
348
:::::
343
349
344
350
345
-
`xpack.fleet.enableExperimental`
351
+
`xpack.fleet.enableExperimental`
346
352
: List of experimental feature flag to enable in Fleet.
353
+
It is available in {{ecloud}} 8.6.0 and later versions.
347
354
348
-
::::{note}
349
-
Experimental features should not be enabled in production environments. The features in this section are experimental and may be changed or removed completely in future releases. Elastic will make a best effort to fix any issues, but experimental features are not supported to the same level as generally available (GA) features.
350
-
351
-
::::
355
+
::::{note}
356
+
Experimental features should not be enabled in production environments. The features in this section are experimental and may be changed or removed completely in future releases. Elastic will make a best effort to fix any issues, but experimental features are not supported to the same level as generally available (GA) features.
0 commit comments