profiling: add edge case resolution in known issues

Signed-off-by: inge4pres <[email protected]>
elastic · Sep 15, 2023 · b0778e9 · b0778e9
1 parent 6d9ced9
commit b0778e9
Show file tree

Hide file tree

Showing 2 changed files with 13 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,22 @@ 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 face
+the same error, but upgrading to the most recent version won't be enough to fix the issue.
+
+To address the error, go to *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
@@ -77,14 +77,14 @@ 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-get-started#profiling-configure-data-ingestion,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]]