diff --git a/.changelog/5344.changed b/.changelog/5344.changed new file mode 100644 index 00000000000..f99bd173f92 --- /dev/null +++ b/.changelog/5344.changed @@ -0,0 +1 @@ +docs: update logs example to use `opentelemetry-instrumentation-logging` diff --git a/docs/examples/logs/README.rst b/docs/examples/logs/README.rst index 6edebf6e064..6f12f8fec82 100644 --- a/docs/examples/logs/README.rst +++ b/docs/examples/logs/README.rst @@ -8,6 +8,26 @@ OpenTelemetry Logs SDK The source files of these examples are available :scm_web:`here `. +.. note:: + + ``LoggingHandler`` has moved from the SDK to the + ``opentelemetry-instrumentation-logging`` package in the contrib repo + and is no longer available 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 diff --git a/docs/examples/logs/example.py b/docs/examples/logs/example.py index 08d04e90ac7..2778e65f81b 100644 --- a/docs/examples/logs/example.py +++ b/docs/examples/logs/example.py @@ -51,6 +51,10 @@ logger1 = logging.getLogger("myapp.area1") logger2 = logging.getLogger("myapp.area2") +# Ensure log records propagate to root logger so the handler picks them up +logger1.propagate = True +logger2.propagate = True + logger1.debug("Quick zephyrs blow, vexing daft Jim.") logger1.info("How quickly daft jumping zebras vex.") logger2.warning("Jail zesty vixen who grabbed pay from quack.")