Implement filtering logic for min_severity and trace_based parameters

Author: rads-1996

CHANGELOG.md

@@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add `rstcheck` to pre-commit to stop introducing invalid RST
   ([#4755](https://github.com/open-telemetry/opentelemetry-python/pull/4755))
+- Add `minimum_severity` and `trace_based` logger parameters to filter logs
 
 ## Version 1.37.0/0.58b0 (2025-09-11)
 

opentelemetry-sdk/src/opentelemetry/sdk/_logs/_internal/__init__.py

@@ -677,6 +677,8 @@ def __init__(
             ConcurrentMultiLogRecordProcessor,
         ],
         instrumentation_scope: InstrumentationScope,
+        min_severity_level: SeverityNumber = SeverityNumber.UNSPECIFIED,
+        trace_based: bool = False,
     ):
         super().__init__(
             instrumentation_scope.name,
@@ -687,6 +689,8 @@ def __init__(
         self._resource = resource
         self._multi_log_record_processor = multi_log_record_processor
         self._instrumentation_scope = instrumentation_scope
+        self._min_severity_level = min_severity_level
+        self._trace_based = trace_based
 
     @property
     def resource(self):
@@ -701,6 +705,10 @@ def emit(self, record: APILogRecord):
             record = LogRecord._from_api_log_record(
                 record=record, resource=self._resource
             )
+        if is_less_than_min_severity(record, self._min_severity_level):
+            return
+        if should_drop_logs_for_trace_based(record, self._trace_based):
+            return
         log_data = LogData(record, self._instrumentation_scope)
         self._multi_log_record_processor.on_emit(log_data)
 
@@ -713,6 +721,8 @@ def __init__(
         multi_log_record_processor: SynchronousMultiLogRecordProcessor
         | ConcurrentMultiLogRecordProcessor
         | None = None,
+        min_severity_level: SeverityNumber = SeverityNumber.UNSPECIFIED,
+        trace_based: bool = False,
     ):
         if resource is None:
             self._resource = Resource.create({})
@@ -728,6 +738,8 @@ def __init__(
             self._at_exit_handler = atexit.register(self.shutdown)
         self._logger_cache = {}
         self._logger_cache_lock = Lock()
+        self._min_severity_level = min_severity_level
+        self._trace_based = trace_based
 
     @property
     def resource(self):
@@ -749,6 +761,8 @@ def _get_logger_no_cache(
                 schema_url,
                 attributes,
             ),
+            self._min_severity_level,
+            self._trace_based,
         )
 
     def _get_logger_cached(
@@ -875,3 +889,18 @@ def std_to_otel(levelno: int) -> SeverityNumber:
     if levelno > 53:
         return SeverityNumber.FATAL4
     return _STD_TO_OTEL[levelno]
+
+def is_less_than_min_severity(record: LogRecord, min_severity: SeverityNumber) -> bool:
+    if record.severity_number is not None:
+        if min_severity is not None and min_severity != SeverityNumber.UNSPECIFIED and record.severity_number.value < min_severity.value:
+            return True
+    return False
+
+def should_drop_logs_for_trace_based(record: LogRecord, trace_state_enabled: bool) -> bool:
+    if trace_state_enabled:
+        if record.context is not None:
+            span = get_current_span(record.context)
+            span_context = span.get_span_context()
+            if span_context.is_valid and not span_context.trace_flags.sampled:
+                return True
+    return False

opentelemetry-sdk/tests/logs/test_logs.py

@@ -23,6 +23,9 @@
     NoOpLogger,
     SynchronousMultiLogRecordProcessor,
 )
+from opentelemetry._logs import (
+    SeverityNumber,
+)
 from opentelemetry.sdk.environment_variables import OTEL_SDK_DISABLED
 from opentelemetry.sdk.resources import Resource
 from opentelemetry.sdk.util.instrumentation import InstrumentationScope
@@ -68,6 +71,8 @@ def test_get_logger(self):
         self.assertEqual(
             logger._instrumentation_scope.attributes, {"key": "value"}
         )
+        self.assertEqual(logger._min_severity_level, SeverityNumber.UNSPECIFIED)
+        self.assertFalse(logger._trace_based)
 
     @patch.dict("os.environ", {OTEL_SDK_DISABLED: "true"})
     def test_get_logger_with_sdk_disabled(self):
@@ -77,7 +82,7 @@ def test_get_logger_with_sdk_disabled(self):
 
     @patch.object(Resource, "create")
     def test_logger_provider_init(self, resource_patch):
-        logger_provider = LoggerProvider()
+        logger_provider = LoggerProvider(min_severity_level=SeverityNumber.DEBUG4, trace_based=True)
         resource_patch.assert_called_once()
         self.assertIsNotNone(logger_provider._resource)
         self.assertTrue(
@@ -86,6 +91,8 @@ def test_logger_provider_init(self, resource_patch):
                 SynchronousMultiLogRecordProcessor,
             )
         )
+        self.assertEqual(logger_provider._min_severity_level, SeverityNumber.DEBUG4)
+        self.assertTrue(logger_provider._trace_based)
         self.assertIsNotNone(logger_provider._at_exit_handler)
 
 
@@ -127,3 +134,193 @@ def test_can_emit_api_logrecord(self):
         log_record_processor_mock.on_emit.assert_called_once()
         log_data = log_record_processor_mock.on_emit.call_args.args[0]
         self.assertTrue(isinstance(log_data.log_record, LogRecord))
+
+    def test_emit_logrecord_with_min_severity_filtering(self):
+        """Test that logs below minimum severity are filtered out"""
+        logger, log_record_processor_mock = self._get_logger()
+        logger._min_severity_level = SeverityNumber.DEBUG4
+
+        log_record_info = LogRecord(
+            observed_timestamp=0,
+            body="info log line",
+            severity_number=SeverityNumber.DEBUG,
+            severity_text="DEBUG",
+        )
+
+        logger.emit(log_record_info)
+        log_record_processor_mock.on_emit.assert_not_called()
+
+        log_record_processor_mock.reset_mock()
+
+        log_record_error = LogRecord(
+            observed_timestamp=0,
+            body="error log line",
+            severity_number=SeverityNumber.ERROR,
+            severity_text="ERROR",
+        )
+
+        logger.emit(log_record_error)
+
+        log_record_processor_mock.on_emit.assert_called_once()
+        log_data = log_record_processor_mock.on_emit.call_args.args[0]
+        self.assertTrue(isinstance(log_data.log_record, LogRecord))
+        self.assertEqual(log_data.log_record.severity_number, SeverityNumber.ERROR)
+
+    def test_emit_logrecord_with_min_severity_unspecified(self):
+        """Test that when min severity is UNSPECIFIED, all logs are emitted"""
+        logger, log_record_processor_mock = self._get_logger()
+        log_record = LogRecord(
+            observed_timestamp=0,
+            body="debug log line",
+            severity_number=SeverityNumber.DEBUG,
+            severity_text="DEBUG",
+        )
+        logger.emit(log_record)
+        log_record_processor_mock.on_emit.assert_called_once()
+
+    def test_emit_logrecord_with_trace_based_filtering(self):
+        """Test that logs are filtered based on trace sampling state"""
+        logger, log_record_processor_mock = self._get_logger()
+        logger._trace_based = True
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = True
+        mock_span_context.trace_flags.sampled = False
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+        mock_context = Mock()
+
+        with patch('opentelemetry.sdk._logs._internal.get_current_span', return_value=mock_span):
+            log_record = LogRecord(
+                observed_timestamp=0,
+                body="should be dropped",
+                severity_number=SeverityNumber.INFO,
+                severity_text="INFO",
+                context=mock_context,
+            )
+
+            logger.emit(log_record)
+            log_record_processor_mock.on_emit.assert_not_called()
+
+        log_record_processor_mock.reset_mock()
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = True
+        mock_span_context.trace_flags.sampled = True
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+    def test_emit_logrecord_trace_filtering_disabled(self):
+        """Test that when trace-based filtering is disabled, all logs are emitted"""
+        logger, log_record_processor_mock = self._get_logger()
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = False
+        mock_span_context.trace_flags.sampled = False
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+        mock_context = Mock()
+
+        with patch('opentelemetry.sdk._logs._internal.get_current_span', return_value=mock_span):
+            log_record = LogRecord(
+                observed_timestamp=0,
+                body="should be emitted when filtering disabled",
+                severity_number=SeverityNumber.INFO,
+                severity_text="INFO",
+                context=mock_context,
+            )
+
+            logger.emit(log_record)
+            log_record_processor_mock.on_emit.assert_called_once()
+
+    def test_emit_logrecord_trace_filtering_edge_cases(self):
+        """Test edge cases for trace-based filtering"""
+        logger, log_record_processor_mock = self._get_logger()
+        logger._trace_based = True
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = False
+        mock_span_context.trace_flags.sampled = True
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+        mock_context = Mock()
+
+        with patch('opentelemetry.sdk._logs._internal.get_current_span', return_value=mock_span):
+            log_record = LogRecord(
+                observed_timestamp=0,
+                body="invalid but sampled",
+                severity_number=SeverityNumber.INFO,
+                severity_text="INFO",
+                context=mock_context,
+            )
+
+            logger.emit(log_record)
+            log_record_processor_mock.on_emit.assert_called_once()
+
+        log_record_processor_mock.reset_mock()
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = True
+        mock_span_context.trace_flags.sampled = False
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+        with patch('opentelemetry.sdk._logs._internal.get_current_span', return_value=mock_span):
+            log_record = LogRecord(
+                observed_timestamp=0,
+                body="valid but not sampled",
+                severity_number=SeverityNumber.INFO,
+                severity_text="INFO",
+                context=mock_context,
+            )
+
+            logger.emit(log_record)
+            log_record_processor_mock.on_emit.assert_not_called()
+
+    def test_emit_both_min_severity_and_trace_based_filtering(self):
+        """Test that both min severity and trace-based filtering work together"""
+        logger, log_record_processor_mock = self._get_logger()
+        logger._min_severity_level = SeverityNumber.WARN
+        logger._trace_based = True
+
+        mock_span_context = Mock()
+        mock_span_context.is_valid = True
+        mock_span_context.trace_flags.sampled = True
+
+        mock_span = Mock()
+        mock_span.get_span_context.return_value = mock_span_context
+
+        mock_context = Mock()
+
+        with patch('opentelemetry.sdk._logs._internal.get_current_span', return_value=mock_span):
+            log_record_info = LogRecord(
+                observed_timestamp=0,
+                body="info log line",
+                severity_number=SeverityNumber.INFO,
+                severity_text="INFO",
+                context=mock_context,
+            )
+
+            logger.emit(log_record_info)
+            log_record_processor_mock.on_emit.assert_not_called()
+
+            log_record_processor_mock.reset_mock()
+
+            log_record_error = LogRecord(
+                observed_timestamp=0,
+                body="error log line",
+                severity_number=SeverityNumber.ERROR,
+                severity_text="ERROR",
+                context=mock_context,
+            )
+
+            logger.emit(log_record_error)
+            log_record_processor_mock.on_emit.assert_called_once()