diff --git a/src/main/asciidoc/advanced-usage.asciidoc b/src/main/asciidoc/advanced-usage.asciidoc
index d277cc2346..26eef83bf4 100644
--- a/src/main/asciidoc/advanced-usage.asciidoc
+++ b/src/main/asciidoc/advanced-usage.asciidoc
@@ -1,6 +1,6 @@
 :auto-reconnect-link: <<client-options,auto-reconnection>>
-:client-options-link: <<client-options>>
-:client-resources-link: <<client-resources>>
+:client-options-link: <<client-options,client options>>
+:client-resources-link: <<client-resources,client resources>>
 
 :custom-commands-command-output-link: <<custom-commands.outputs>>
 :custom-commands-command-exec-model-link: <<custom-commands.synchronous-asynchronous-and-reactive,Custom commands>>
@@ -36,6 +36,21 @@ include::{ext-doc}/Streaming-API.asciidoc[leveloffset=+1]
 === Events
 include::{ext-doc}/Connection-Events.asciidoc[leveloffset=+2]
 
+[[observability]]
+=== Observability
+
+The following section explains Lettuces metrics and tracing capabilities.
+
+[[observability.metrics]]
+==== Metrics
+
+include::{ext-doc}/Command-Latency-Metrics.asciidoc[leveloffset=+2]
+
+[[observability.tracing]]
+==== Tracing
+
+include::{ext-doc}/Tracing.asciidoc[leveloffset=+2]
+
 === Pipelining and command flushing
 
 include::{ext-doc}/Pipelining-and-command-flushing.asciidoc[leveloffset=+2]