docs(ruby): add sections for std_lib_logger_filter opt

Author: solnic

docs/platforms/ruby/common/configuration/options.mdx

@@ -362,6 +362,32 @@ Provides a lambda or proc that's called with an SDK-specific log object, and can
 
 </SdkOption>
 
+<SdkOption name="std_lib_logger_filter" type="lambda | proc">
+
+Provides a lambda or proc that's called to filter log messages from Ruby's standard library logger before they are sent to Sentry. This option is only used when the `:logger` patch is enabled via `config.enabled_patches`.
+
+The callback receives three arguments:
+- `logger` - The logger instance
+- `message` - The log message string
+- `severity` - The log severity level (`:debug`, `:info`, `:warn`, `:error`, `:fatal`)
+
+Return `true` to send the log to Sentry, or `false` to skip it.
+
+```ruby
+Sentry.init do |config|
+  config.dsn = "___PUBLIC_DSN___"
+  config.enable_logs = true
+  config.enabled_patches << :logger
+
+  # Only send ERROR and FATAL logs to Sentry
+  config.std_lib_logger_filter = proc do |logger, message, severity|
+    [:error, :fatal].include?(severity)
+  end
+end
+```
+
+</SdkOption>
+
 <SdkOption name="before_send_check_in" type="lambda | proc">
 
 Provides a lambda or proc that's called with a check-in event object, and can return a modified check-in event object, or `nil` to skip reporting the event.

docs/platforms/ruby/logs/index.mdx

@@ -25,6 +25,10 @@ With Sentry Structured Logs, you can send text-based log information from your a
 
 <PlatformContent includePath="logs/integrations" />
 
+## Options
+
+<PlatformContent includePath="logs/options" />
+
 ## Default Attributes
 
 <PlatformContent includePath="logs/default-attributes" />

platform-includes/logs/integrations/ruby.mdx

@@ -18,6 +18,30 @@ logger.info("Hello from stdlib logger")
 logger.error("Hello from stdlib logger")
 ```
 
+### Filtering Logs
+
+You can filter logs before they are sent to Sentry using the `std_lib_logger_filter` configuration option. This allows you to control which log messages are sent based on severity, content, or logger instance.
+
+```ruby
+Sentry.init do |config|
+  config.dsn = "___PUBLIC_DSN___"
+  config.enable_logs = true
+  config.enabled_patches << :logger
+
+  # Only send ERROR and FATAL logs to Sentry
+  config.std_lib_logger_filter = proc do |logger, message, severity|
+    [:error, :fatal].include?(severity)
+  end
+end
+```
+
+The filter proc receives three arguments:
+- `logger` - The logger instance
+- `message` - The log message string
+- `severity` - The log severity level (`:debug`, `:info`, `:warn`, `:error`, `:fatal`)
+
+Return `true` to send the log to Sentry, or `false` to skip it.
+
 <Alert level="info" title="Note on structured logging">
 Ruby's stdlib logger does not support structured logging, that's why logs are sent to Sentry as plain messages with default attributes added automatically by the SDK.
 </Alert>

platform-includes/logs/options/ruby.mdx

@@ -0,0 +1,55 @@
+### before_send_log
+
+To filter logs before they are sent to Sentry, use the `before_send_log` callback. Return `nil` to skip a log, or return the log object to send it.
+
+<PlatformContent includePath="configuration/before-send-log" />
+
+### std_lib_logger_filter
+
+When using Ruby's standard library logger integration (enabled with `config.enabled_patches << :logger`), you can filter log messages before they are sent to Sentry using the `std_lib_logger_filter` configuration option.
+
+```ruby
+Sentry.init do |config|
+  config.dsn = "___PUBLIC_DSN___"
+  config.enable_logs = true
+  config.enabled_patches << :logger
+
+  # Only send ERROR and FATAL logs to Sentry
+  config.std_lib_logger_filter = proc do |logger, message, severity|
+    [:error, :fatal].include?(severity)
+  end
+end
+```
+
+The filter proc receives three arguments:
+- `logger` - The logger instance
+- `message` - The log message string
+- `severity` - The log severity level (`:debug`, `:info`, `:warn`, `:error`, `:fatal`)
+
+Return `true` to send the log to Sentry, or `false` to skip it.
+
+**Examples:**
+
+Filter by severity:
+
+```ruby
+config.std_lib_logger_filter = proc do |logger, message, severity|
+  [:error, :fatal].include?(severity)
+end
+```
+
+Filter by message content:
+
+```ruby
+config.std_lib_logger_filter = proc do |logger, message, severity|
+  !message.include?("SKIP")
+end
+```
+
+Filter by logger instance:
+
+```ruby
+config.std_lib_logger_filter = proc do |logger, message, severity|
+  !logger.instance_variable_get(:@logdev).nil?
+end
+```