Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Profiling: add upgrade notice of known issues for 8.9 versions #3214

Merged
merged 4 commits into from
Sep 8, 2023
Merged

Profiling: add upgrade notice of known issues for 8.9 versions #3214

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1cd8c7b
Profiling: add upgrade notice of known issues for 8.9 versions
inge4pres Sep 7, 2023
0f2b59e
move warning to get started page
inge4pres Sep 7, 2023
c08612a
grammar fix
inge4pres Sep 7, 2023
83e22d8
Suggestions from code review
inge4pres Sep 8, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 19 additions & 8 deletions docs/en/observability/profiling-get-started.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,9 +63,7 @@ Even if you're profiling a smaller fleet, we recommend configuring at least two
[[profiling-set-up-on-cloud]]
== Set up Universal Profiling on an {ecloud} deployment

To set up Universal Profiling on your {ecloud} deployment, you need to:

. <<profiling-configure-data-ingestion, Configure data ingestion>>
To set up Universal Profiling on your {ecloud} deployment, you need to <<profiling-configure-data-ingestion, configure data ingestion>> first.

[discrete]
[[profiling-configure-data-ingestion]]
Expand All @@ -85,9 +83,22 @@ If you're upgrading from a previous version with Universal Profiling enabled, se
IMPORTANT: When upgrading, you must remove all existing profiling data.
We still recommend upgrading as the latest version contains several improvements and new features.

[discrete]
[[profiling-install-host-agent]]
== Install the host-agent
[discrete]
[[profiling-upgrade-known-issues]]
==== Known issue when configuring data ingestion


inge4pres marked this conversation as resolved.
Show resolved Hide resolved
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.9.3 or more recent to fix this issue.


[discrete]
[[profiling-install-host-agent]]
== Install the host-agent
You have the following options when installing the host-agent:

. <<profiling-install-host-agent-elastic-agent, Install the host-agent using the {agent}>>
Expand All @@ -99,12 +110,12 @@ You have the following options when installing the host-agent:

To install the host-agent using the {agent} and the Universal Profiling Agent integration, complete the following steps:

. Copy the `secret token` and `Universal Profiling Collector url` from the Elastic Agent Integration
. Copy the `secret token` and `Universal Profiling Collector url` from the Elastic Agent Integration
+
[role="screenshot"]
image::images/profiling-elastic-agent.png[]
+
. Click `Manage Universal Profiling Agent in Fleet` to complete the integration.
. Click `Manage Universal Profiling Agent in Fleet` to complete the integration.
. On the Integrations page, click **Add Universal Profiling Agent**.
. In **Universal Profiling Agent → Settings**, add the information you copied from the *Add profiling data* page:
.. Add the Universal Profiling collector URL to the **Universal Profiling collector endpoint** field.
Expand Down