elastic · KOTungseth · Mar 19, 2025 · Mar 19, 2025
@@ -1,12 +1,9 @@
 ---
-navigation_title: "Elastic APM"
+navigation_title: "Breaking changes"
 ---
 
-# Elastic APM breaking changes
-
-Before you upgrade, carefully review the Elastic APM breaking changes and take the necessary steps to mitigate any issues.
-
-% To learn how to upgrade, check out <uprade docs>.
+# Elastic APM breaking changes [elastic-apm-breaking-changes]
+Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the Elastic APM breaking changes and take the necessary steps to mitigate any issues. To learn how to upgrade, check out [Upgrade](docs-content://solutions/observability/apps/upgrade.md).
 
 % ## Next version
 
@@ -19,9 +16,8 @@ Before you upgrade, carefully review the Elastic APM breaking changes and take t
 % **Action**<br> Steps for mitigating deprecation impact.
 % ::::
 
-## 9.0.0 [9-0-0]
-
-**Release date:** March 25, 2025
+## 9.0.0 [elastic-apm-900-breaking-changes]
+**Release date:** April 2, 2025
 
 ::::{dropdown} Change server information endpoint "/" to only accept GET and HEAD requests
 This will surface any agent misconfiguration causing data to be sent to `/` instead of the correct endpoint (for example, `/v1/traces` for OTLP/HTTP).

@@ -2,10 +2,11 @@
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-known-issues.html
 
-navigation_title: "Elastic APM"
+navigation_title: "Known issues"
 ---
 
-# Elastic APM known issues
+# Elastic APM known issues [elastic-apm-known-issues]
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the Elastic APM known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 
@@ -21,8 +22,6 @@ navigation_title: "Elastic APM"
 
 :::
 
-APM has the following known issues:
-
 :::{dropdown} prefer_ilm required in component templates to create custom lifecycle policies
 
 *Elastic Stack versions: 8.15.1+*

@@ -5,8 +5,7 @@ mapped_pages:
   - https://www.elastic.co/guide/en/observability/master/release-notes-head.html
 ---
 
-# Elastic APM release notes
-
+# Elastic APM release notes [elastic-apm-release-notes]
 Review the changes, fixes, and more in each version of Elastic APM.
 
 To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).
@@ -21,15 +20,12 @@ To check for security updates, go to [Security announcements for the Elastic sta
 
 % ### Fixes [elastic-apm-next-fixes]
 
-## 9.0.0 [9-0-0]
-
+## 9.0.0 [elastic-apm-nodejs-agent-900-release-notes]
 **Release date:** March 25, 2025
 
-### Features and enhancements [9-0-0-features-enhancements]
-
+### Features and enhancements [elastic-apm-nodejs-agent-900-features-enhancements]
 * **Tail-based sampling**: Storage layer is rewritten to use Pebble database instead of BadgerDB. The new implementation offers a substantial throughput increase while consuming significantly less memory. Disk usage is significantly lower and more stable. See APM [Transaction sampling](docs-content://solutions/observability/apps/transaction-sampling.md) docs for benchmark details. ([#15235](https://github.com/elastic/apm-server/pull/15235))
 
-### Fixes [9-0-0-fixes]
-
+### Fixes [elastic-apm-nodejs-agent-900-fixes]
 * Fix overflow in validation of `apm-server.agent.config.cache.expiration` on 32-bit architectures. ([#15216](https://github.com/elastic/apm-server/pull/15216))
 * Change permissions of `apm-server.yml` in `tar.gz` artifacts to `0600`. ([#15627](https://github.com/elastic/apm-server/pull/15627))
@@ -1,5 +1,5 @@
 toc:
-  - file: index.md
+  - file: release-notes.md
   - file: known-issues.md
   - file: breaking-changes.md
   - file: deprecations.md