From 1fd9750ca83dd857c3d87dca8a637036582b5791 Mon Sep 17 00:00:00 2001 From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com> Date: Fri, 7 Mar 2025 15:20:06 +0200 Subject: [PATCH 1/5] Update troubleshooting.asciidoc --- docs/reference/troubleshooting.asciidoc | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/reference/troubleshooting.asciidoc b/docs/reference/troubleshooting.asciidoc index 75cd0c1be49fc..cf617ed25d099 100644 --- a/docs/reference/troubleshooting.asciidoc +++ b/docs/reference/troubleshooting.asciidoc @@ -25,6 +25,7 @@ If you're using Elastic Cloud Hosted, then you can use AutoOps to monitor your c * <> * <> * <> +* <> * <> * <> * <> From 23fd2832c0fc541a81f9d57266b90e7fac286fd4 Mon Sep 17 00:00:00 2001 From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com> Date: Fri, 7 Mar 2025 15:21:08 +0200 Subject: [PATCH 2/5] Create source-mode-setting.asciidoc --- .../data/source-mode-setting.asciidoc | 49 +++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 docs/reference/troubleshooting/data/source-mode-setting.asciidoc diff --git a/docs/reference/troubleshooting/data/source-mode-setting.asciidoc b/docs/reference/troubleshooting/data/source-mode-setting.asciidoc new file mode 100644 index 0000000000000..79c2d8d064d1c --- /dev/null +++ b/docs/reference/troubleshooting/data/source-mode-setting.asciidoc @@ -0,0 +1,49 @@ +[[troubleshoot-migrate-source-mode]] +== Configuring source mode in mappings is deprecated and replaced by an index setting + +Index <> mode was previously configured in mappings as follows: + +[source,js] +---- +"mappings": { + "source": { + "mode": "synthetic" + }, + "foo": { + "type": "keyword" + }, + "bar": { + "type": "keyword" + } +} +---- +// NOTCONSOLE + +Starting with version 8.18, this method for configuring the source mode is considered +deprecated and replaced by index setting `index.mapping.source.mode` that accepts the +same values: `stored` (default), `synthetic` and `disabled`. The index setting can be +used as follows: + +[source,js] +---- +"settings": { + "index.mapping.source.mode": "synthetic" +} +"mappings": { + "foo": { + "type": "keyword" + }, + "bar": { + "type": "keyword" + } +} +---- +// NOTCONSOLE + +Existing indexes using the deprecated method for configuring the source mode are not +affected, but creating new indexes raises warnings and will not be supported in a future +release. This can be an issue for data streams and other indexes that get regularly +generated using component templates. To avoid these problems, identify all affected +component templates, as shown in the <>, +and update them to use setting `index.mapping.source.mode` instead of +`mappings.source.mode`, according to the examples above. From f811f64147216efc4e3b102760e5a9b159238d62 Mon Sep 17 00:00:00 2001 From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com> Date: Fri, 7 Mar 2025 16:17:17 +0200 Subject: [PATCH 3/5] Update troubleshooting.asciidoc --- docs/reference/troubleshooting.asciidoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/reference/troubleshooting.asciidoc b/docs/reference/troubleshooting.asciidoc index cf617ed25d099..bd066cd56e1d3 100644 --- a/docs/reference/troubleshooting.asciidoc +++ b/docs/reference/troubleshooting.asciidoc @@ -110,6 +110,8 @@ include::troubleshooting/data/increase-shard-limit.asciidoc[] include::troubleshooting/data/increase-cluster-shard-limit.asciidoc[] +include::troubleshooting/data/source-mode-setting.asciidoc[] + include::troubleshooting/corruption-issues.asciidoc[] include::troubleshooting/disk/fix-data-node-out-of-disk.asciidoc[] From 580bbf5f5af7f11f96157527feccedb62656becb Mon Sep 17 00:00:00 2001 From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com> Date: Sat, 8 Mar 2025 12:37:41 +0200 Subject: [PATCH 4/5] Update source-mode-setting.asciidoc --- .../reference/troubleshooting/data/source-mode-setting.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/troubleshooting/data/source-mode-setting.asciidoc b/docs/reference/troubleshooting/data/source-mode-setting.asciidoc index 79c2d8d064d1c..0ab6327120436 100644 --- a/docs/reference/troubleshooting/data/source-mode-setting.asciidoc +++ b/docs/reference/troubleshooting/data/source-mode-setting.asciidoc @@ -21,7 +21,7 @@ Index <> mode was previously configured in mappings Starting with version 8.18, this method for configuring the source mode is considered deprecated and replaced by index setting `index.mapping.source.mode` that accepts the -same values: `stored` (default), `synthetic` and `disabled`. The index setting can be +same values: `stored`, `synthetic` and `disabled`. The index setting can be used as follows: [source,js] From ad284b5d354a0c72e9e571f500d02a14687dad19 Mon Sep 17 00:00:00 2001 From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com> Date: Mon, 10 Mar 2025 18:35:04 +0200 Subject: [PATCH 5/5] Update logs.asciidoc --- docs/reference/data-streams/logs.asciidoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/reference/data-streams/logs.asciidoc b/docs/reference/data-streams/logs.asciidoc index 7058cfe51496f..381bc8bb91809 100644 --- a/docs/reference/data-streams/logs.asciidoc +++ b/docs/reference/data-streams/logs.asciidoc @@ -112,7 +112,9 @@ IMPORTANT: On existing data streams, `logsdb` mode is applied on <