Update README.md

Author: JacksonWeber

experimental/packages/sdk-logs/README.md

@@ -57,6 +57,126 @@ logger.emit({
 Logs configuration is a merge of both the user supplied configuration and the default
 configuration as specified in [config.ts](./src/config.ts)
 
+## Logger Configuration
+
+The SDK supports advanced logger configuration through the `LoggerConfigurator` API, which allows you to:
+
+- **Filter logs by minimum severity level** - Drop logs below a configured severity threshold
+- **Filter logs by trace sampling status** - Drop logs associated with unsampled traces
+- **Configure per-logger patterns** - Apply different configurations to different loggers using wildcard patterns
+
+### Minimum Severity Filtering
+
+Filter logs based on their severity level. Logs with severity below the configured minimum will be dropped before reaching the processor/exporter.
+
+```js
+const { LoggerProvider, createLoggerConfigurator } = require('@opentelemetry/sdk-logs');
+const { SeverityNumber } = require('@opentelemetry/api-logs');
+
+const loggerProvider = new LoggerProvider({
+  loggerConfigurator: createLoggerConfigurator([
+    {
+      pattern: '*', // Match all loggers
+      config: {
+        minimumSeverity: SeverityNumber.WARN // Only WARN, ERROR, and FATAL logs
+      }
+    }
+  ]),
+  processors: [new SimpleLogRecordProcessor(exporter)]
+});
+```
+
+**Behavior:**
+- Logs with `severityNumber >= minimumSeverity` are exported
+- Logs with `severityNumber = UNSPECIFIED` (0) or undefined always bypass the filter
+- Default minimum severity is `UNSPECIFIED` (no filtering)
+
+### Trace-Based Filtering
+
+Filter logs based on their associated trace's sampling status. Logs from unsampled traces can be dropped to reduce volume while keeping sampled trace logs.
+
+```js
+const loggerProvider = new LoggerProvider({
+  loggerConfigurator: createLoggerConfigurator([
+    {
+      pattern: '*',
+      config: {
+        traceBased: true // Drop logs from unsampled traces
+      }
+    }
+  ]),
+  processors: [new SimpleLogRecordProcessor(exporter)]
+});
+```
+
+**Behavior:**
+- Logs associated with **sampled traces** (TraceFlags.SAMPLED set) are exported
+- Logs associated with **unsampled traces** (TraceFlags.SAMPLED not set) are dropped
+- Logs **without trace context** bypass the filter and are exported
+- Default is `false` (no trace-based filtering)
+
+### Combined Filtering
+
+Both filters can be combined. A log must pass **both** filters to be exported.
+
+```js
+const loggerProvider = new LoggerProvider({
+  loggerConfigurator: createLoggerConfigurator([
+    {
+      pattern: '*',
+      config: {
+        minimumSeverity: SeverityNumber.WARN, // Filter by severity
+        traceBased: true // AND filter by trace sampling
+      }
+    }
+  ]),
+  processors: [new SimpleLogRecordProcessor(exporter)]
+});
+```
+
+### Per-Logger Configuration
+
+Use pattern matching to configure different loggers differently. Patterns are matched in order, and the first match is used.
+
+```js
+const loggerProvider = new LoggerProvider({
+  loggerConfigurator: createLoggerConfigurator([
+    {
+      pattern: 'critical-service', // Exact match
+      config: { minimumSeverity: SeverityNumber.ERROR }
+    },
+    {
+      pattern: 'debug-*', // Wildcard match
+      config: { minimumSeverity: SeverityNumber.DEBUG }
+    },
+    {
+      pattern: '*', // Default for all other loggers
+      config: { minimumSeverity: SeverityNumber.WARN }
+    }
+  ])
+});
+
+// Different loggers get different configurations
+const criticalLogger = loggerProvider.getLogger('critical-service'); // ERROR+
+const debugLogger = loggerProvider.getLogger('debug-api'); // DEBUG+
+const defaultLogger = loggerProvider.getLogger('my-service'); // WARN+
+```
+
+### Configuration Options
+
+```typescript
+interface LoggerConfig {
+  /** Drop logs with severity below this level (default: UNSPECIFIED = no filtering) */
+  minimumSeverity?: SeverityNumber;
+  
+  /** Drop logs from unsampled traces (default: false) */
+  traceBased?: boolean;
+  
+  /** Disable this logger completely (default: false) */
+  disabled?: boolean;
+}
+```
+
 ## Example
 
 See [examples/logs](https://github.com/open-telemetry/opentelemetry-js/tree/main/experimental/examples/logs)