From e8465b05fd22ec62ba71ce33bee92eed89df306f Mon Sep 17 00:00:00 2001
From: avinab-neogy <avinabneogy23@gmail.com>
Date: Thu, 16 Jul 2026 10:27:18 +0530
Subject: [PATCH 1/2] docs: warn about dictConfig clearing OTel handlers in
 logs example

---
 docs/examples/logs/README.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/examples/logs/README.rst b/docs/examples/logs/README.rst
index 2e3c749c7b..438ee0b392 100644
--- a/docs/examples/logs/README.rst
+++ b/docs/examples/logs/README.rst
@@ -14,6 +14,28 @@ The source files of these examples are available :scm_web:`here <docs/examples/l
    ``opentelemetry-instrumentation-logging`` package in the contrib repo
    and is deprecated in ``opentelemetry-sdk``.
 
+.. warning::
+   If you configure logging using ``logging.config.dictConfig``, be aware
+   that it may clear existing handlers on the root logger, including the
+   OTel handler. To avoid losing telemetry, save and restore the root
+   logger handlers around the ``dictConfig`` call:
+
+   .. code-block:: python
+
+      import logging
+      import logging.config
+
+      # Save OTel handlers before calling dictConfig
+      otel_handlers = logging.getLogger().handlers[:]
+
+      logging.config.dictConfig({
+          "version": 1,
+          "root": {"level": "DEBUG"},
+      })
+
+      # Re-apply saved handlers
+      for handler in otel_handlers:
+          logging.getLogger().addHandler(handler)
 
 Installation
 ------------

From 67620efc741c53c65e61e64143c638726c1fdb81 Mon Sep 17 00:00:00 2001
From: avinab-neogy <avinabneogy23@gmail.com>
Date: Thu, 16 Jul 2026 10:43:07 +0530
Subject: [PATCH 2/2] add changelog fragment for #5420

---
 .changelog/5420.changed | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 .changelog/5420.changed

diff --git a/.changelog/5420.changed b/.changelog/5420.changed
new file mode 100644
index 0000000000..3dc70b4006
--- /dev/null
+++ b/.changelog/5420.changed
@@ -0,0 +1 @@
+docs: warn about `dictConfig` clearing OTel handlers in logs example