Logs for Laravel (#14033)

Co-authored-by: Cursor Agent <[email protected]>

Author: cleptric

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

@@ -9,9 +9,9 @@ sidebar_order: 5600
 
 With Sentry Structured Logs, you can send text based log information from your applications to Sentry. Once in Sentry, these logs can be viewed alongside relevant errors, searched by text-string, or searched using their individual attributes.
 
-<Alert title="Looking for Laravel or Symfony?">
+<Alert title="Looking for Symfony?">
 
-Let us know what you would like to see on GitHub: [Laravel Logs](https://github.com/getsentry/sentry-laravel/issues/999) or [Symfony Logs](https://github.com/getsentry/sentry-symfony/issues/925).
+Let us know what you would like to see on GitHub: [Symfony Logs](https://github.com/getsentry/sentry-symfony/issues/925).
 
 </Alert>
 

docs/platforms/php/guides/laravel/logs/index.mdx

@@ -0,0 +1,26 @@
+---
+title: Set Up Logs
+sidebar_title: Logs
+description: "Structured logs allow you to send, view and query logs sent from your Laravel applications within Sentry."
+sidebar_order: 5600
+---
+
+<Include name="feature-stage-beta-logs.mdx" />
+
+With Sentry Structured Logs, you can send text based log information from your Laravel applications to Sentry. Once in Sentry, these logs can be viewed alongside relevant errors, searched by text-string, or searched using their individual attributes.
+
+## Requirements
+
+<PlatformContent includePath="logs/requirements" />
+
+## Setup
+
+<PlatformContent includePath="logs/setup" />
+
+## Usage
+
+<PlatformContent includePath="logs/usage" />
+
+## Options
+
+<PlatformContent includePath="logs/options" />

docs/product/explore/logs/getting-started/index.mdx

@@ -206,6 +206,11 @@ To set up Sentry Logs, use the links below for supported SDKs. After it's been s
     label="PHP"
     url="/platforms/dart/guides/php/logs/"
   />
+- <LinkWithPlatformIcon
+    platform="php.laravel"
+    label="Laravel"
+    url="/platforms/php/guides/laravel/logs/"
+  />
 
 ### Python
 
@@ -245,11 +250,6 @@ We're actively working on adding Log functionality to additional SDKs. Check out
     label="Elixir"
     url="https://github.com/getsentry/sentry-elixir/issues/886"
   />
-- <LinkWithPlatformIcon
-    platform="php.laravel"
-    label="Laravel"
-    url="https://github.com/getsentry/sentry-laravel/issues/999"
-  />
 - <LinkWithPlatformIcon
     platform="react-native"
     label="React Native"

platform-includes/logs/options/php.laravel.mdx

@@ -0,0 +1,25 @@
+#### before_send_log
+
+To filter logs, or update them before they are sent to Sentry, you can use the `before_send_log` option.
+
+```php {filename:config/sentry.php}
+    // ...
+    'before_send_log' => function (\Sentry\Logs\Log $log): ?\Sentry\Logs\Log {
+        if ($log->getLevel() === \Sentry\Logs\LogLevel::info()) {
+            // Filter out all info logs
+            return null;
+        }
+
+        return $log;
+    },
+    // ... 
+]);
+```
+
+<Alert>
+
+Learn more in [Closures and Config Caching](/platforms/php/guides/laravel/configuration/laravel-options/#closures-and-config-caching).
+
+</Alert>
+
+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 `null` if you want to discard it.

platform-includes/logs/requirements/php.laravel.mdx

@@ -0,0 +1 @@
+Logs for Laravel are supported in Sentry Laravel SDK version `4.15.0` and above.

platform-includes/logs/setup/php.laravel.mdx

@@ -0,0 +1,33 @@
+To configure Sentry as a log channel, add the following config to the `channels` section in `config/logging.php`. If this file does not exist, run `php artisan config:publish logging` to publish it.
+
+```php {filename:config/logging.php}
+'channels' => [
+    // ...
+    'sentry' => [
+        'driver' => 'sentry',
+    ],
+],
+```
+
+After you configured the Sentry log channel, you can configure your app to both log to a log file and to Sentry by modifying the log stack:
+
+```bash {filename:.env}
+# ...
+LOG_STACK=single,sentry
+# ...
+```
+
+Optionally, you can set the logging level:
+
+```php {filename:config/logging.php}
+'channels' => [
+    // ...
+    'sentry' => [
+        'driver' => 'sentry',
+        // The minimum logging level at which this handler will be triggered
+        // Available levels: debug, info, notice, warning, error, critical, alert, emergency
+        'level' => env('LOG_LEVEL', 'error'),
+    ],
+    // ...
+],
+```

platform-includes/logs/usage/php.laravel.mdx

@@ -0,0 +1,25 @@
+Once you have configured Sentry as a log channel, you can use Laravel's built-in logging functionality to send logs to Sentry:
+
+```php
+use Illuminate\Support\Facades\Log;
+
+// Log to all channels in the stack (including Sentry)
+Log::info('This is an info message');
+Log::warning('User {id} failed to login.', ['id' => $user->id]);
+Log::error('This is an error message');
+
+// Log directly to the Sentry channel
+Log::channel('sentry')->error('This will only go to Sentry');
+```
+
+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.
+
+```php
+use Illuminate\Support\Facades\Log;
+
+Log::error('Something went wrong', [
+    'user_id' => auth()->id(),
+    'action' => 'update_profile',
+    'additional_data' => $data,
+]);
+```