From 92e22c45f87188b0ee36dabbe10ca66f502253f1 Mon Sep 17 00:00:00 2001
From: wajihaparvez <wajiha.parvez@elastic.co>
Date: Thu, 23 Jan 2025 04:15:59 -0500
Subject: [PATCH] [Docs] Add known issue about upgrade error (#207629)

## Summary

Adding #187254 as a known issue to the 8.10.0 release notes + all
subsequent versions.

See [slack
thread](https://elastic.slack.com/archives/CED7QCL3E/p1737476287242609)
for details.

Closes:
[#622](https://github.com/orgs/elastic/projects/1232/views/54?pane=issue&itemId=94643452&issue=elastic%7Cplatform-docs-team%7C622)

(cherry picked from commit c17f45d3f1aa9bfd408bf181b66540514534791a)

# Conflicts:
#	docs/CHANGELOG.asciidoc
---
 docs/CHANGELOG.asciidoc | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
index 095c4e039d630..79c169db53494 100644
--- a/docs/CHANGELOG.asciidoc
+++ b/docs/CHANGELOG.asciidoc
@@ -181,6 +181,8 @@ For information about the {kib} 8.13.0 release, review the following information
 [[known-issues-8.13.0]]
 === Known issues
 
+include::CHANGELOG.asciidoc[tag=known-issue-187254]
+
 [discrete]
 [[known-179457]]
 .In Canvas, an empty text element incorrectly triggers a toast notification
@@ -627,6 +629,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.
@@ -1027,6 +1031,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
@@ -1371,6 +1377,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]]