wip

Author: cleptric

docs/platforms/php/common/integrations/monolog.mdx

@@ -1,11 +1,64 @@
 ---
 title: Monolog
-description: "Learn how to enable Sentry's PHP SDK to capture Monolog events."
+description: "Learn how to enable Sentry's PHP SDK to capture Monolog events and logs."
 ---
 
-When using [Monolog](https://github.com/Seldaek/monolog) you can configure a [breadcrumb](../../enriching-events/breadcrumbs/) handler to capture Monolog messages as breadcrumbs and a handler that captures messages as events in Sentry.
+When using [Monolog](https://github.com/Seldaek/monolog) you can configure handlers to capture Monolog messages in several ways:
+
+- **Logs Handler** - Send structured logs to Sentry for search and analysis
+- **Event Handler** - Capture messages as error events in Sentry
+- **Breadcrumb Handler** - Record messages as breadcrumbs attached to future events
+
 The breadcrumb handler will not send anything to Sentry directly, it only records breadcrumbs that will be attached to any event or exception sent to Sentry.
 
+## Logs
+
+<Alert level="info">
+Available in SDK version 4.12.0 and above.
+</Alert>
+
+To send structured logs to Sentry, use the `\Sentry\Monolog\LogsHandler`. This handler sends log entries to Sentry's structured logs feature, where they can be searched, filtered, and analyzed.
+
+```php
+<?php
+
+use Monolog\Level;
+use Monolog\Logger;
+
+// Setup the Sentry SDK with logs enabled
+\Sentry\init([
+    'dsn' => '___PUBLIC_DSN___',
+    'enable_logs' => true, // Required for logs to be sent to Sentry
+]);
+
+// Create a Monolog channel with a logs handler
+$log = new Logger('app');
+$log->pushHandler(new \Sentry\Monolog\LogsHandler(
+    hub: \Sentry\SentrySdk::getCurrentHub(),
+    level: Level::Info, // Minimum level to send to Sentry logs
+));
+
+// Send logs to Sentry
+$log->info('User logged in', [
+    'user_id' => 12345,
+    'email' => 'user@example.com',
+    'login_method' => 'password',
+]);
+
+$log->warning('API rate limit approaching', [
+    'endpoint' => '/api/users',
+    'requests_remaining' => 10,
+    'window_seconds' => 60,
+]);
+
+// Flush to ensure logs are sent
+\Sentry\logger()->flush();
+```
+
+The context array passed to Monolog methods becomes searchable attributes in the Sentry logs interface.
+
+## Events
+
 ```php
 <?php
 

docs/platforms/php/common/logs/index.mdx

@@ -25,6 +25,10 @@ Let us know what you would like to see on GitHub: [Symfony Logs](https://github.
 
 <PlatformContent includePath="logs/usage" />
 
+## Integrations
+
+<PlatformContent includePath="logs/integrations" />
+
 ## Options
 
 <PlatformContent includePath="logs/options" />

platform-includes/logs/integrations/php.mdx

@@ -0,0 +1,4 @@
+Available integrations:
+- [Monolog](/platforms/php/integrations/monolog/#logs)
+
+If there's an integration you would like to see, open a [new issue on GitHub](https://github.com/getsentry/sentry-php/issues/new/choose).

platform-includes/logs/requirements/php.mdx

@@ -1 +1,7 @@
 Logs for PHP are supported in Sentry PHP SDK version `4.12.0` and above.
+
+## Monolog Integration
+
+To use logs with Monolog, you'll need:
+- Sentry PHP SDK version `4.12.0` and above
+- Monolog version `^2.0` or `^3.0`

platform-includes/logs/setup/php.mdx

@@ -10,3 +10,31 @@ To enable logging, you need to initialize the SDK with the `enable_logs` option
 // Somewhere at the end of your execution, you should flush the logger to send pending logs to Sentry.
 \Sentry\logger()->flush();
 ```
+
+## Using with Monolog
+
+If you're already using [Monolog](https://github.com/Seldaek/monolog), you can use the `\Sentry\Monolog\LogsHandler` to send logs directly through your existing logging setup:
+
+```php
+use Monolog\Level;
+use Monolog\Logger;
+
+\Sentry\init([
+    'dsn' => '___PUBLIC_DSN___',
+    'enable_logs' => true,
+]);
+
+$log = new Logger('app');
+$log->pushHandler(new \Sentry\Monolog\LogsHandler(
+    hub: \Sentry\SentrySdk::getCurrentHub(),
+    level: Level::Info,
+));
+
+// Your existing Monolog usage will now send logs to Sentry
+$log->info('Application started');
+
+// Don't forget to flush
+\Sentry\logger()->flush();
+```
+
+For more details, see the [Monolog integration documentation](/platforms/php/integrations/monolog/#logs).