profiling: add edge case resolution in known issues (#3235)

Signed-off-by: inge4pres <[email protected]> Co-authored-by: Mike Birnstiehl <[email protected]> (cherry picked from commit e72a87a)
elastic · Sep 21, 2023 · 4ca07bc · 4ca07bc
1 parent 885a20e
commit 4ca07bc
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 4 deletions.
diff --git a/docs/en/observability/profiling-get-started.asciidoc b/docs/en/observability/profiling-get-started.asciidoc
@@ -87,13 +87,23 @@ We still recommend upgrading as the latest version contains several improvements
 [[profiling-upgrade-known-issues]]
 ==== Known issue when configuring data ingestion
 
-
 If your {ecloud} deployment originated from version 7.x or earlier and is currently running on version 8.9.0–8.9.2, you may encounter a problem while trying to enable Universal Profiling.
 
 Specifically, clicking the *Set up Universal Profiling* button triggers an error message that reads `Error while setting up Universal Profiling`.
+Upgrade to version 8.10.0 or more recent to fix this issue.
+
+If you previously enabled Universal Profiling in {ecloud} version 8.9.0, and you're re-executing the setup, you may also encounter
+this error. In this scenario, you need to complete the following step in addition to upgrading to the most recent version.
+
+Open *Dev Tools* from the navigation menu and execute the following command:
+
 
+WARNING: When running the following command, customizations of APM and Fleet configurations will be erased.
 
-Upgrade to version 8.9.3 or more recent to fix this issue.
+[source,console]
+----
+POST kbn:/internal/fleet/reset_preconfigured_agent_policies/policy-elastic-agent-on-cloud
+----
 
 
 [discrete]

diff --git a/docs/en/observability/profiling-upgrade.asciidoc b/docs/en/observability/profiling-upgrade.asciidoc
@@ -81,14 +81,15 @@ Verify that no ingestion is happening by reloading the *Data Streams* and *Indic
 [[profiling-from-scratch]]
 === Set up Universal Profiling from scratch
 
-Refer to <<profiling-get-started>> to set up Universal Profiling from scratch.
+Refer to <<profiling-configure-data-ingestion>> to set up Universal Profiling from scratch.
+
 
 
 [discrete]
 [[profiling-start-data-ingestion]]
 === Start profiling data ingestion
 
-If you stopped ingesting data by stopping routing requests to the Integrations Server, reenable traffic following the same steps but click **Start routing requests** instead of **Stop routing requests**.
+If you stopped ingesting data by stopping routing requests to the Integrations Server, re-enable traffic following the same steps but click **Start routing requests** instead of **Stop routing requests**.
 
 [discrete]
 [[profiling-verify-upgrade-success]]