docs: update logs example to use opentelemetry-instrumentation-logging (#5344)

* docs: update logs example to use opentelemetry-instrumentation-logging

* docs: restore experimental warning, keep scope focused on LoggingHandler

* add changelog fragment for #5344

* docs: address review feedback, use deprecated and update propagate comment

* Apply suggestion from @xrmx

* Apply suggestion from @xrmx

---------

Co-authored-by: Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>

Author: avinab-neogy

.changelog/5344.changed

@@ -0,0 +1 @@
+docs: update logs example to use `opentelemetry-instrumentation-logging`

docs/examples/logs/README.rst

@@ -8,6 +8,26 @@ OpenTelemetry Logs SDK
 
 The source files of these examples are available :scm_web:`here <docs/examples/logs/>`.
 
+.. note::
+
+   ``LoggingHandler`` has moved from the SDK to the
+   ``opentelemetry-instrumentation-logging`` package in the contrib repo
+   and is deprecated in ``opentelemetry-sdk``.
+
+
+Installation
+------------
+
+.. code-block:: sh
+
+    pip install opentelemetry-api
+    pip install opentelemetry-sdk
+    pip install opentelemetry-exporter-otlp-proto-grpc
+    pip install opentelemetry-instrumentation-logging
+
+Run the Example
+---------------
+
 Start the Collector locally to see data being exported. Write the following file:
 
 .. code-block:: yaml

docs/examples/logs/example.py

@@ -48,6 +48,9 @@
 # Create different namespaced loggers
 # It is recommended to not use the root logger with OTLP handler
 # so telemetry is collected only for the application
+# Logger.propagate is True by default, ensure it is not set to False so log
+# records reach the root logger handler. See
+# https://docs.python.org/3/library/logging.html#logging.Logger.propagate
 logger1 = logging.getLogger("myapp.area1")
 logger2 = logging.getLogger("myapp.area2")