From 0f99b78296f57a67d4a97e6e2817b94b8f889490 Mon Sep 17 00:00:00 2001 From: "mergify[bot]" <37929162+mergify[bot]@users.noreply.github.com> Date: Wed, 4 Sep 2024 14:28:18 -0500 Subject: [PATCH] add headings to apm known issues doc (#4218) (#4223) (cherry picked from commit fc7581cfc208bd224089f3440163553a4c62f85e) Co-authored-by: Colleen McGinnis --- .../observability/apm/known-issues.asciidoc | 43 +++++++++++++------ 1 file changed, 29 insertions(+), 14 deletions(-) diff --git a/docs/en/observability/apm/known-issues.asciidoc b/docs/en/observability/apm/known-issues.asciidoc index 05fd5e24f3..256d030765 100644 --- a/docs/en/observability/apm/known-issues.asciidoc +++ b/docs/en/observability/apm/known-issues.asciidoc @@ -7,19 +7,23 @@ TEMPLATE Note: Add known issues for newer Elastic Stack versions to the top of this page -*Brief description* + +[discrete] +== Brief description + _Versions: XX.XX.XX, YY.YY.YY, ZZ.ZZ.ZZ_ -Detailed description including: +// Detailed description including: -The conditions in which this issue occurs -The behavior of the issue -Why it happens -If applicable, exact error messages linked to this issue so users searching for the error message end up here -Link to fix +// The conditions in which this issue occurs +// The behavior of the issue +// Why it happens +// If applicable, exact error messages linked to this issue so users searching for the error message end up here +// If applicable, link to fix //// -*Upgrading to v8.15.0 may cause APM indices to lose their lifecycle policy* + +[discrete] +== Upgrading to v8.15.0 may cause APM indices to lose their lifecycle policy + _Elastic Stack versions: 8.15.0_ + _Fixed in Elastic Stack version 8.15.1_ @@ -95,8 +99,10 @@ PUT _data_stream/logs-apm.*/_lifecycle // Link to fix if it exists This issue is fixed in 8.15.1 (https://github.com/elastic/elasticsearch/pull/112432[elastic/elasticsearch#112432]). +[discrete] [[broken-apm-anomaly-rule]] -*Upgrading to v8.13.0 to v8.13.2 breaks APM anomaly rules* + +== Upgrading to v8.13.0 to v8.13.2 breaks APM anomaly rules + _Elastic Stack versions: 8.13.0, 8.13.1, 8.13.2_ + _Fixed in Elastic Stack version 8.13.3_ @@ -223,8 +229,10 @@ curl -u "$KIBANA_USER":"$KIBANA_PASSWORD" -XPUT "$KIBANA_URL/api/alerting/rule/0 Once the PUT request executes successfully, the rule will no longer be broken. ==== +[discrete] [[apm-empty-metricset-values]] -*Upgrading APM Server to 8.11+ might break event intake from older APM Java agents* + +== Upgrading APM Server to 8.11+ might break event intake from older APM Java agents + _APM Server versions: >=8.11.0_ + _Elastic APM Java agent versions: < 1.43.0_ @@ -250,7 +258,9 @@ The fix is to upgrade the Elastic APM Java agent to a version >= 1.43.0. Find details in https://github.com/elastic/apm-data/pull/157[elastic/apm-data#157]. -*traces-apm@custom ingest pipeline applied to certain data streams unintentionally* + +[discrete] +== traces-apm@custom ingest pipeline applied to certain data streams unintentionally + _APM Server versions: 8.12.0_ + // Describe the conditions in which this issue occurs @@ -270,8 +280,9 @@ If you rely on this unintended behavior in 8.12.0, please rename your pipeline t // Link to fix? A fix was released in 8.12.1: https://github.com/elastic/kibana/pull/175448[elastic/kibana#175448]. +[discrete] +== Ingesting new JVM metrics in 8.9 and 8.10 breaks upgrade to 8.11 and stops ingestion -*Ingesting new JVM metrics in 8.9 and 8.10 breaks upgrade to 8.11 and stops ingestion* + _APM Server versions: 8.11.0, 8.11.1_ + _Elastic APM Java agent versions: 1.39.0+_ @@ -306,7 +317,9 @@ Failed installing package [apm] due to error: [ResponseError: mapper_parsing_exc A fix was released in 8.11.2: https://github.com/elastic/kibana/pull/171712[elastic/kibana#171712]. -*APM integration package upgrade through Fleet causes excessive data stream rollovers* + +[discrete] +== APM integration package upgrade through Fleet causes excessive data stream rollovers + _APM Server versions: \<= 8.12.1 +_ // Describe the conditions in which this issue occurs @@ -336,7 +349,9 @@ Mappings update for metrics-apm.service_destination.10m-default failed due to Re A fix was released in 8.12.2: https://github.com/elastic/apm-server/pull/12219[elastic/apm-server#12219]. -*Performance regression: APM issues too many small bulk requests for Elasticsearch output* + +[discrete] +== Performance regression: APM issues too many small bulk requests for Elasticsearch output + _APM Server versions: >=8.13.0, \<= 8.14.2_ + // Describe the conditions in which this issue occurs