fix(python): fix Python logs docs (#13685)

Author: lcian

platform-includes/logs/integrations/python.mdx

@@ -1,8 +1,9 @@
 ### Python Logger Integration
 
-Sentry automatically instruments Python loggers via it's `LoggingIntegration`.
+Sentry automatically instruments Python loggers via its `LoggingIntegration`.
 
 ```python
+import sentry_sdk
 import logging
 
 sentry_sdk.init(
@@ -15,6 +16,7 @@ sentry_sdk.init(
 # Your existing logging setup
 my_logger = logging.Logger("some-logger")
 
+my_value = 42
 my_logger.debug('In this example debug events will not be sent to Sentry logs. my_value=%s', my_value)
 my_logger.info('But info events will be sent to Sentry logs. my_value=%s', my_value)
 ```

platform-includes/logs/options/python.mdx

@@ -1,29 +1,34 @@
 #### before_send_log
 
-To filter logs, or update them before they are sent to Sentry, you can use the `_experiments.before_send_log` option.
+To filter logs, or update them before they are sent to Sentry, you can use the `_experiments["before_send_log"]` option.
 
 ```python
-def _before_log(log):
-    if log.level == "info":
-        # Filter out all info logs
-        return None
+import sentry_sdk
+from sentry_sdk.types import Log, Hint
+from typing import Optional
 
+def before_log(log: Log, _hint: Hint) -> Optional[Log]:
+    # Filter out all info level logs
+    if log["severity_text"] == "info":
+        return None
     return log
 
 sentry_sdk.init(
     dsn="___PUBLIC_DSN___",
     _experiments={
         "enable_logs": True,
-        "before_send_log": _before_log,
+        "before_send_log": before_log,
     },
 )
 ```
 
 The `before_send_log` function receives a log object, and should return the log object if you want it to be sent to Sentry, or `None` if you want to discard it.
 
-The log object has the following properties:
+The log dict has the following keys:
 
-- `level`: (string - one of `trace`, `debug`, `info`, `warn`, `error`, `fatal`) The log level.
-- `message`: (string) The message to be logged.
-- `timestamp`: (number) The timestamp of the log.
-- `attributes`: (object) The attributes of the log.
+- `severity_text`: (`str` - one of `trace`, `debug`, `info`, `warning`, `error`, `fatal`) The log level.
+- `severity_number`: (`int`) The log level as a number ranging from 1 to 24, as per the OpenTelemetry specification of [`SeverityNumber`](https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-severitynumber).
+- `body`: (`str`) The log message.
+- `attributes`: (`dict[str, str | bool | float | int]`) Additional attributes to be sent with the log.
+- `time_unix_nano`: (`int`) The timestamp of the log in nanoseconds since the Unix epoch.
+- `trace_id`: (`Optional[str]`) The trace ID of the trace this log belongs to.

platform-includes/logs/requirements/python.mdx

@@ -1,5 +1,8 @@
 Logs for Python are supported in Sentry Python SDK version `2.27.0` and above.
 
-```bash
-pip install --upgrade sentry-sdk
+```bash {tabTitle:pip}
+pip install "sentry-sdk"
 ```
+```bash {tabTitle:uv}
+uv add "sentry-sdk"
+```

platform-includes/logs/setup/python.mdx

@@ -1,4 +1,4 @@
-To enable logging, you need to initialize the SDK with the `_experiments.enable_logs` option set to `true`.
+To enable logging, you need to initialize the SDK with the `_experiments["enable_logs"]` option set to `True`.
 
 ```python
 sentry_sdk.init(

platform-includes/logs/usage/python.mdx

@@ -1,16 +1,16 @@
 Once the feature is enabled on the SDK and the SDK is initialized, you can send logs using the `sentry_sdk.logger` APIs.
 
-The `logger` namespace exposes six methods that you can use to log messages at different log levels: `trace`, `debug`, `info`, `warn`, `error`, and `fatal`.
+The `logger` namespace exposes six methods that you can use to log messages at different log levels: `trace`, `debug`, `info`, `warning`, `error`, and `fatal`.
 
 You can pass additional attributes directly to the logging functions. These properties will be sent to Sentry, and can be searched from within the Logs UI, and even added to the Logs views as a dedicated column.
 
 ```python
 from sentry_sdk import logger as sentry_logger
 
-sentry_logger.trace('Starting database connection {database}', database="users");
-sentry_logger.debug('Cache miss for user {user_id}', user_id=123);
-sentry_logger.info('Updated global cache');
-sentry_logger.warn('Rate limit reached for endpoint {endpoint}', endpoint='/api/results/');
-sentry_logger.error('Failed to process payment. Order: {order_id}. Amount: {amount}', order_id="or_2342", amount=99.99);
-sentry_logger.fatal('Database {database} connection pool exhausted', database="users");
+sentry_logger.trace('Starting database connection {database}', database="users")
+sentry_logger.debug('Cache miss for user {user_id}', user_id=123)
+sentry_logger.info('Updated global cache')
+sentry_logger.warning('Rate limit reached for endpoint {endpoint}', endpoint='/api/results/')
+sentry_logger.error('Failed to process payment. Order: {order_id}. Amount: {amount}', order_id="or_2342", amount=99.99)
+sentry_logger.fatal('Database {database} connection pool exhausted', database="users")
 ```