diff --git a/docs/en/observability/index.asciidoc b/docs/en/observability/index.asciidoc index b288d07d09..5da49017ca 100644 --- a/docs/en/observability/index.asciidoc +++ b/docs/en/observability/index.asciidoc @@ -162,6 +162,7 @@ include::profiling-troubleshooting.asciidoc[leveloffset=+3] include::profiling-self-managed.asciidoc[leveloffset=+3] include::profiling-self-managed-ops.asciidoc[leveloffset=+4] include::profiling-self-managed-troubleshooting.asciidoc[leveloffset=+4] +include::profiling-known-issues.asciidoc[leveloffset=+3] // Tutorials include::monitor-k8s/monitor-k8s.asciidoc[leveloffset=+2] diff --git a/docs/en/observability/profiling-known-issues.asciidoc b/docs/en/observability/profiling-known-issues.asciidoc new file mode 100644 index 0000000000..334a4e9a08 --- /dev/null +++ b/docs/en/observability/profiling-known-issues.asciidoc @@ -0,0 +1,22 @@ +[[profiling-known-issues]] += Known issues + +Universal Profiling has the following known issues: + +[discrete] +== Helm chart `profiling-collector` faulty binary location + +_Affected: 8.16.0, 8.16.1, 8.16.2, 8.17.0_ +_Fixed in: 8.16.3+, 8.17.1+_ + +The installation of Universal Profiling collector using the Helm chart `profiling-collector` produces a Deployment with +the wrong binary path set in `spec.template.spec.containers['pf-elastic-collector'].command`. + +The correct path should be `/home/nonroot/pf-elastic-collector` while the `command` field references the deprecated path +`/root/pf-elastic-collector`. This issue prevents the collector from starting and as a result, the Deployment has Pods +in `CrashLoopBackoff` status. + +To fix this issue, a manual edit of the Deployment manifest should be performed, removing entirely the `command` field +from the `spec` section. + +This can be performed by either manipulating the Deployment template emitted by Helm or by using the `kubectl edit` command.