[8.14](backport #4218) [apm] Add headings to APM known issues page (#…

…4222)

* add headings to apm known issues doc (#4218)

(cherry picked from commit fc7581c)

# Conflicts:
#	docs/en/observability/apm/known-issues.asciidoc

* fix merge conflict

---------

Co-authored-by: Colleen McGinnis <[email protected]>

docs/en/observability/apm/known-issues.asciidoc

@@ -7,20 +7,24 @@ 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
 ////
 
+[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_
 
@@ -147,8 +151,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_
 
@@ -174,7 +180,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
@@ -194,8 +202,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+_
 
@@ -230,7 +239,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
@@ -260,7 +271,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