From 0029eb759470abcc844634c995987f621aa02b4f Mon Sep 17 00:00:00 2001
From: florent-leborgne <florent.leborgne@elastic.co>
Date: Thu, 23 Jan 2025 12:03:52 +0100
Subject: [PATCH] [8.12] [Docs] Add known issue about upgrade error (#207629)
 (#208011)

# Backport

This will backport the following commits from `8.x` to `8.12`:
- [[Docs] Add known issue about upgrade error
(#207629)](https://github.com/elastic/kibana/pull/207629)

<!--- Backport version: 8.9.8 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT
[{"author":{"name":"wajihaparvez","email":"wajiha.parvez@elastic.co"},"sourceCommit":{"committedDate":"2025-01-23T09:15:59Z","message":"[Docs]
Add known issue about upgrade error (#207629)\n\n##
Summary\r\n\r\nAdding #187254 as a known issue to the 8.10.0 release
notes + all\r\nsubsequent versions.\r\n\r\nSee
[slack\r\nthread](https://elastic.slack.com/archives/CED7QCL3E/p1737476287242609)\r\nfor
details.\r\n\r\nCloses:\r\n[#622](https://github.com/orgs/elastic/projects/1232/views/54?pane=issue&itemId=94643452&issue=elastic%7Cplatform-docs-team%7C622)","sha":"c17f45d3f1aa9bfd408bf181b66540514534791a","branchLabelMapping":{"^v8.16.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v8.10.0","v8.11.0","v8.12.0","v8.13.0","v8.14.0","v8.15.0","v8.16.0","backport:version","v8.17.0"],"number":207629,"url":"https://github.com/elastic/kibana/pull/207629","mergeCommit":{"message":"[Docs]
Add known issue about upgrade error (#207629)\n\n##
Summary\r\n\r\nAdding #187254 as a known issue to the 8.10.0 release
notes + all\r\nsubsequent versions.\r\n\r\nSee
[slack\r\nthread](https://elastic.slack.com/archives/CED7QCL3E/p1737476287242609)\r\nfor
details.\r\n\r\nCloses:\r\n[#622](https://github.com/orgs/elastic/projects/1232/views/54?pane=issue&itemId=94643452&issue=elastic%7Cplatform-docs-team%7C622)","sha":"c17f45d3f1aa9bfd408bf181b66540514534791a"}},"sourceBranch":"8.x","suggestedTargetBranches":["8.10","8.11","8.12","8.13","8.14","8.15","8.16","8.17"],"targetPullRequestStates":[{"branch":"8.10","label":"v8.10.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.11","label":"v8.11.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.12","label":"v8.12.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.13","label":"v8.13.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.14","label":"v8.14.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.15","label":"v8.15.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.16.0","labelRegex":"^v8.16.0$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.17","label":"v8.17.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: wajihaparvez <wajiha.parvez@elastic.co>
---
 docs/CHANGELOG.asciidoc | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
index ff4334201a99b..fb64f49013eeb 100644
--- a/docs/CHANGELOG.asciidoc
+++ b/docs/CHANGELOG.asciidoc
@@ -143,6 +143,8 @@ For information about the {kib} 8.12.0 release, review the following information
 [[known-issues-8.12.0]]
 === Known issues
 
+include::CHANGELOG.asciidoc[tag=known-issue-187254]
+
 [discrete]
 [[known-177938-8.12]]
 .Index templates UI incorrectly sets the `allow_auto_create` field to `false` by default.
@@ -544,6 +546,8 @@ For information about the {kib} 8.11.0 release, review the following information
 [[known-issues-8.11.0]]
 === Known issues
 
+include::CHANGELOG.asciidoc[tag=known-issue-187254]
+
 // tag::known-issue-169170[]
 [discrete]
 .Gatekeeper error on macOS
@@ -888,6 +892,35 @@ Presentation::
 IMPORTANT: {kib} 8.10.0 has been withdrawn.
 
 For information about the {kib} 8.10.0 release, review the following information.
+[float]
+[[known-issues-8.10.0]]
+=== Known issues
+
+// tag::known-issue-187254[]
+.Errors appear when loading Observability Infrastructure inventory views after upgrading to version 8.10.0 or higher.
+[%collapsible]
+====
+*Details* +
+After upgrading to version 8.10.0 or higher, you may encounter errors when loading inventory views. 
+
+For more information, refer to https://github.com/elastic/kibana/issues/187254[#187254].
+
+*Workaround* +
+You can mitigate the issue by completing the following steps:
+
+. Search the `.kibana_*` index for `type: inventory_view`.
+
+. Copy the `_id` field, which will be formatted as `inventory-view:<id>`. For example, `inventory-view:3d3d06b0-f873-4373-8446-f6a8341cd8b1`. Omit the `inventory-view:` portion and copy only the string of `_id` characters.
+
+. The offending documents are those with fields `inventory-view.legend.steps` > 18. Delete these documents by running the following in *Console*:
+
+[source,js]
+----------------------------------
+DELETE kbn:/api/infra/inventory-views/<id> 
+----------------------------------
+====
+// end::known-issue-187254[]
+
 
 [float]
 [[security-updates-v8.10.0]]