Update CHANGELOG.md

CHANGELOG.md

@@ -4,17 +4,45 @@
 
 ### Various fixes & improvements
 
-- Fixed Celery headers for Beat auto-instrumentation (#2102) by @antonpirker
-- Add a note about `pip freeze` to the bug template (#2103) by @sentrivana
-- Make sure we're importing redis the library (#2106) by @sentrivana
-- Surface `include_source_context` as an option (#2100) by @sentrivana
-- Import Markup from markupsafe (#2047) by @rco-ableton
-- Fix __qualname__ missing attribute in asyncio integration (#2105) by @sl0thentr0py
-- Ref: Add `include_source_context` option in utils (#2020) by @farhat-nawaz
+- **New:** Add `loguru` integration (#1994) by @PerchunPak
+
+  Check [the documentation](https://docs.sentry.io/platforms/python/configuration/integrations/loguru/) for more information.
+
+  Usage:
+
+  ```python
+  from loguru import logger
+  import sentry_sdk
+  from sentry_sdk.integrations.loguru import LoguruIntegration
+
+  sentry_sdk.init(
+      dsn="___PUBLIC_DSN___",
+      integrations=[
+          LoguruIntegration(),
+      ],
+  )
+
+  logger.debug("I am ignored")
+  logger.info("I am a breadcrumb")
+  logger.error("I am an event", extra=dict(bar=43))
+  logger.exception("An exception happened")
+  ```
+
+  - An error event with the message `"I am an event"` will be created.
+  - `"I am a breadcrumb"` will be attached as a breadcrumb to that event.
+  - `bar` will end up in the `extra` attributes of that event.
+  - `"An exception happened"` will send the current exception from `sys.exc_info()` with the stack trace to Sentry. If there's no exception, the current stack will be attached.
+  - The debug message `"I am ignored"` will not be captured by Sentry. To capture it, set `level` to `DEBUG` or lower in `LoguruIntegration`.
+
 - Do not truncate request body if `request_bodies` is `"always"` (#2092) by @sentrivana
+- Fixed Celery headers for Beat auto-instrumentation (#2102) by @antonpirker
+- Add `db.operation` to Redis and MongoDB spans (#2089) by @antonpirker
+- Make sure we're importing `redis` the library (#2106) by @sentrivana
+- Add `include_source_context` option (#2020) by @farhat-nawaz and @sentrivana
+- Import `Markup` from `markupsafe` (#2047) by @rco-ableton
+- Fix `__qualname__` missing attribute in asyncio integration (#2105) by @sl0thentr0py
 - Remove relay extension from AWS Layer (#2068) by @sl0thentr0py
-- Add `loguru` integration (#1994) by @PerchunPak
-- Add `db.operation` to Redis and MongoDB spans. (#2089) by @antonpirker
+- Add a note about `pip freeze` to the bug template (#2103) by @sentrivana
 
 ## 1.22.2