feat(config): Add LoggerProvider support for declarative config (#4990)

* config: add resource and propagator creation from declarative config

Implements create_resource() and create_propagator()/configure_propagator()
for the declarative file configuration. Resource creation does not read
OTEL_RESOURCE_ATTRIBUTES or run any detectors (matches Java/JS SDK behavior).
Propagator configuration always calls set_global_textmap to override Python's
default tracecontext+baggage, setting a noop CompositePropagator when no
propagator is configured.

Assisted-by: Claude Sonnet 4.6

* update changelog with PR number

Assisted-by: Claude Sonnet 4.6

* fix pylint, pyright and ruff errors in resource/propagator config

- _resource.py: refactor _coerce_attribute_value to dispatch table to
  avoid too-many-return-statements; fix short variable names k/v ->
  attr_key/attr_val; fix return type of _sdk_default_attributes to
  dict[str, str] to satisfy pyright
- _propagator.py: rename short variable names e -> exc, p -> propagator
- test_resource.py: move imports to top level; split TestCreateResource
  (25 methods) into three focused classes to satisfy too-many-public-methods
- test_propagator.py: add pylint disable for protected-access

Assisted-by: Claude Sonnet 4.6

* address review feedback: use _DEFAULT_RESOURCE, fix bool_array coercion

- replace _sdk_default_attributes() with _DEFAULT_RESOURCE from resources module
- move _coerce_bool into dispatch tables for both scalar and array bool types,
  fixing a bug where bool_array with string values like "false" would coerce
  incorrectly via plain bool() (non-empty string -> True)
- add test for bool_array with string values to cover the bug

Assisted-by: Claude Sonnet 4.6

* fix linter

* address review feedback: single coercion table, simplify attributes merge

- collapse _SCALAR_COERCIONS and _ARRAY_COERCIONS into a single _COERCIONS
  dict using an _array() factory, reducing _coerce_attribute_value to two lines
- process attributes_list before attributes so explicit attributes naturally
  overwrite list entries without needing an explicit guard

Assisted-by: Claude Sonnet 4.6

* use Callable type annotation on _array helper

Assisted-by: Claude Sonnet 4.6

* add detection infrastructure foundations for resource detectors

Adds _run_detectors() stub and _filter_attributes() to create_resource(),
providing the shared scaffolding for detector PRs to build on. Detectors
are opt-in: nothing runs unless explicitly listed under
detection_development.detectors in the config. The include/exclude
attribute filter mirrors other SDK behaviour.

Assisted-by: Claude Sonnet 4.6

* move service.name default into base resource

Merges service.name=unknown_service into base before running detectors,
so detectors (e.g. service) can override it. Previously it was added to
config_attrs and merged last, which would have silently overridden any
detector-provided service.name.

Assisted-by: Claude Sonnet 4.6

* remove unused logging import from _propagator.py

Assisted-by: Claude Sonnet 4.6

* add create_logger_provider/configure_logger_provider for declarative config

Implements LoggerProvider instantiation from declarative config files,
following the same env-var-suppression pattern as create_meter_provider.
BatchLogRecordProcessor defaults use spec values (1000ms schedule_delay),
overriding the Python SDK's incorrect 5000ms env-var default.

Assisted-by: Claude Sonnet 4.6

* add changelog entry for logger provider declarative config (#4990)

Assisted-by: Claude Sonnet 4.6

* fix linter errors

* add test verifying OTEL_PROPAGATORS env var is ignored by configure_propagator

Assisted-by: Claude Sonnet 4.6

* remove backwards compat re-export of ConfigurationError from _loader.py

Import directly from _exceptions.py since this is new code with no existing
dependents on the _loader module path.

Assisted-by: Claude Sonnet 4.6

* address review feedback: simplify resource filter and propagator loading

Assisted-by: Claude Sonnet 4.6

* fix ruff formatting

Assisted-by: Claude Sonnet 4.6

* fix pyright: wrap EntryPoints in iter() for next() compatibility

Assisted-by: Claude Sonnet 4.6

* remove stale SDK bug note fixed in v1.41.0

Assisted-by: Claude Sonnet 4.6

---------

Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com>
Co-authored-by: Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>

Author: 3 people

CHANGELOG.md

@@ -12,6 +12,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+- `opentelemetry-sdk`: Add `create_logger_provider`/`configure_logger_provider` to declarative file configuration, enabling LoggerProvider instantiation from config files without reading env vars
+  ([#4990](https://github.com/open-telemetry/opentelemetry-python/pull/4990))
 - `opentelemetry-sdk`: Add `service` resource detector support to declarative file configuration via `detection_development.detectors[].service`
   ([#5003](https://github.com/open-telemetry/opentelemetry-python/pull/5003))
 - logs: add exception support to Logger emit and LogRecord attributes
@@ -22,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version 1.41.0/0.62b0 (2026-04-09)
 
+
 - `opentelemetry-sdk`: Add `host` resource detector support to declarative file configuration via `detection_development.detectors[].host`
   ([#5002](https://github.com/open-telemetry/opentelemetry-python/pull/5002))
 - `opentelemetry-sdk`: Add `container` resource detector support to declarative file configuration via `detection_development.detectors[].container`, using entry point loading of the `opentelemetry-resource-detector-containerid` contrib package

opentelemetry-sdk/src/opentelemetry/sdk/_configuration/_logger_provider.py

@@ -0,0 +1,268 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from opentelemetry._logs import set_logger_provider
+from opentelemetry.sdk._configuration._common import _parse_headers
+from opentelemetry.sdk._configuration._exceptions import ConfigurationError
+from opentelemetry.sdk._configuration.models import (
+    BatchLogRecordProcessor as BatchLogRecordProcessorConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    LoggerProvider as LoggerProviderConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    LogRecordExporter as LogRecordExporterConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    LogRecordProcessor as LogRecordProcessorConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    OtlpGrpcExporter as OtlpGrpcExporterConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    OtlpHttpExporter as OtlpHttpExporterConfig,
+)
+from opentelemetry.sdk._configuration.models import (
+    SimpleLogRecordProcessor as SimpleLogRecordProcessorConfig,
+)
+from opentelemetry.sdk._logs import LoggerProvider
+from opentelemetry.sdk._logs._internal.export import (
+    BatchLogRecordProcessor,
+    ConsoleLogRecordExporter,
+    LogRecordExporter,
+    SimpleLogRecordProcessor,
+)
+from opentelemetry.sdk.resources import Resource
+
+_logger = logging.getLogger(__name__)
+
+# BatchLogRecordProcessor defaults per OTel spec (milliseconds).
+_DEFAULT_SCHEDULE_DELAY_MILLIS = 1000
+_DEFAULT_EXPORT_TIMEOUT_MILLIS = 30000
+_DEFAULT_MAX_QUEUE_SIZE = 2048
+_DEFAULT_MAX_EXPORT_BATCH_SIZE = 512
+
+
+def _map_compression(
+    value: Optional[str], compression_enum: type
+) -> Optional[object]:
+    """Map a compression string to the given Compression enum value."""
+    if value is None or value.lower() == "none":
+        return None
+    if value.lower() == "gzip":
+        return compression_enum.Gzip  # type: ignore[attr-defined]
+    raise ConfigurationError(
+        f"Unsupported compression value '{value}'. Supported values: 'gzip', 'none'."
+    )
+
+
+def _create_console_log_exporter() -> ConsoleLogRecordExporter:
+    """Create a ConsoleLogRecordExporter."""
+    return ConsoleLogRecordExporter()
+
+
+def _create_otlp_http_log_exporter(
+    config: OtlpHttpExporterConfig,
+) -> LogRecordExporter:
+    """Create an OTLP HTTP log exporter from config."""
+    try:
+        # pylint: disable=import-outside-toplevel,no-name-in-module
+        from opentelemetry.exporter.otlp.proto.http import (  # type: ignore[import-untyped]  # noqa: PLC0415
+            Compression,
+        )
+        from opentelemetry.exporter.otlp.proto.http._log_exporter import (  # type: ignore[import-untyped]  # noqa: PLC0415
+            OTLPLogExporter,
+        )
+    except ImportError as exc:
+        raise ConfigurationError(
+            "otlp_http log exporter requires 'opentelemetry-exporter-otlp-proto-http'. "
+            "Install it with: pip install opentelemetry-exporter-otlp-proto-http"
+        ) from exc
+
+    compression = _map_compression(config.compression, Compression)
+    headers = _parse_headers(config.headers, config.headers_list)
+    timeout = (config.timeout / 1000.0) if config.timeout is not None else None
+
+    return OTLPLogExporter(  # type: ignore[return-value]
+        endpoint=config.endpoint,
+        headers=headers,
+        timeout=timeout,
+        compression=compression,  # type: ignore[arg-type]
+    )
+
+
+def _create_otlp_grpc_log_exporter(
+    config: OtlpGrpcExporterConfig,
+) -> LogRecordExporter:
+    """Create an OTLP gRPC log exporter from config."""
+    try:
+        # pylint: disable=import-outside-toplevel,no-name-in-module
+        import grpc  # type: ignore[import-untyped]  # noqa: PLC0415
+
+        from opentelemetry.exporter.otlp.proto.grpc._log_exporter import (  # type: ignore[import-untyped]  # noqa: PLC0415
+            OTLPLogExporter,
+        )
+    except ImportError as exc:
+        raise ConfigurationError(
+            "otlp_grpc log exporter requires 'opentelemetry-exporter-otlp-proto-grpc'. "
+            "Install it with: pip install opentelemetry-exporter-otlp-proto-grpc"
+        ) from exc
+
+    compression = _map_compression(config.compression, grpc.Compression)
+    headers = _parse_headers(config.headers, config.headers_list)
+    timeout = (config.timeout / 1000.0) if config.timeout is not None else None
+
+    return OTLPLogExporter(  # type: ignore[return-value]
+        endpoint=config.endpoint,
+        headers=headers,
+        timeout=timeout,
+        compression=compression,  # type: ignore[arg-type]
+    )
+
+
+def _create_log_record_exporter(
+    config: LogRecordExporterConfig,
+) -> LogRecordExporter:
+    """Create a log record exporter from config."""
+    if config.console is not None:
+        return _create_console_log_exporter()
+    if config.otlp_http is not None:
+        return _create_otlp_http_log_exporter(config.otlp_http)
+    if config.otlp_grpc is not None:
+        return _create_otlp_grpc_log_exporter(config.otlp_grpc)
+    if config.otlp_file_development is not None:
+        raise ConfigurationError(
+            "otlp_file_development log exporter is experimental and not yet supported."
+        )
+    raise ConfigurationError(
+        "No exporter type specified in log record exporter config. "
+        "Supported types: console, otlp_http, otlp_grpc."
+    )
+
+
+def _create_batch_log_record_processor(
+    config: BatchLogRecordProcessorConfig,
+) -> BatchLogRecordProcessor:
+    """Create a BatchLogRecordProcessor from config.
+
+    Passes explicit defaults to suppress OTEL_BLRP_* env var reading.
+    """
+    exporter = _create_log_record_exporter(config.exporter)
+    schedule_delay = (
+        config.schedule_delay
+        if config.schedule_delay is not None
+        else _DEFAULT_SCHEDULE_DELAY_MILLIS
+    )
+    export_timeout = (
+        config.export_timeout
+        if config.export_timeout is not None
+        else _DEFAULT_EXPORT_TIMEOUT_MILLIS
+    )
+    max_queue_size = (
+        config.max_queue_size
+        if config.max_queue_size is not None
+        else _DEFAULT_MAX_QUEUE_SIZE
+    )
+    max_export_batch_size = (
+        config.max_export_batch_size
+        if config.max_export_batch_size is not None
+        else _DEFAULT_MAX_EXPORT_BATCH_SIZE
+    )
+    return BatchLogRecordProcessor(
+        exporter=exporter,
+        schedule_delay_millis=float(schedule_delay),
+        export_timeout_millis=float(export_timeout),
+        max_queue_size=max_queue_size,
+        max_export_batch_size=max_export_batch_size,
+    )
+
+
+def _create_simple_log_record_processor(
+    config: SimpleLogRecordProcessorConfig,
+) -> SimpleLogRecordProcessor:
+    """Create a SimpleLogRecordProcessor from config."""
+    exporter = _create_log_record_exporter(config.exporter)
+    return SimpleLogRecordProcessor(exporter)
+
+
+def _create_log_record_processor(
+    config: LogRecordProcessorConfig,
+) -> BatchLogRecordProcessor | SimpleLogRecordProcessor:
+    """Create a log record processor from config."""
+    if config.batch is not None:
+        return _create_batch_log_record_processor(config.batch)
+    if config.simple is not None:
+        return _create_simple_log_record_processor(config.simple)
+    raise ConfigurationError(
+        "No processor type specified in log record processor config. "
+        "Supported types: batch, simple."
+    )
+
+
+def create_logger_provider(
+    config: Optional[LoggerProviderConfig],
+    resource: Optional[Resource] = None,
+) -> LoggerProvider:
+    """Create an SDK LoggerProvider from declarative config.
+
+    Does NOT read OTEL_BLRP_* or other env vars for values explicitly
+    controlled by the config. Absent config values use OTel spec defaults.
+
+    Args:
+        config: LoggerProvider config from the parsed config file, or None.
+        resource: Resource to attach to the provider.
+
+    Returns:
+        A configured LoggerProvider.
+    """
+    provider = LoggerProvider(resource=resource)
+
+    if config is None:
+        return provider
+
+    if config.limits is not None:
+        _logger.warning(
+            "log_record_limits are specified in config but are not supported "
+            "by the Python SDK LoggerProvider constructor; limits will be ignored."
+        )
+
+    for processor_config in config.processors:
+        provider.add_log_record_processor(
+            _create_log_record_processor(processor_config)
+        )
+
+    return provider
+
+
+def configure_logger_provider(
+    config: Optional[LoggerProviderConfig],
+    resource: Optional[Resource] = None,
+) -> None:
+    """Configure the global LoggerProvider from declarative config.
+
+    When config is None (logger_provider section absent from config file),
+    the global is not set — matching Java/JS SDK behavior.
+
+    Args:
+        config: LoggerProvider config from the parsed config file, or None.
+        resource: Resource to attach to the provider.
+    """
+    if config is None:
+        return
+    set_logger_provider(create_logger_provider(config, resource))

opentelemetry-sdk/src/opentelemetry/sdk/_configuration/file/__init__.py

@@ -25,6 +25,10 @@
 """
 
 from opentelemetry.sdk._configuration._exceptions import ConfigurationError
+from opentelemetry.sdk._configuration._logger_provider import (
+    configure_logger_provider,
+    create_logger_provider,
+)
 from opentelemetry.sdk._configuration._meter_provider import (
     configure_meter_provider,
     create_meter_provider,
@@ -52,6 +56,8 @@
     "create_resource",
     "create_propagator",
     "configure_propagator",
+    "create_logger_provider",
+    "configure_logger_provider",
     "create_tracer_provider",
     "configure_tracer_provider",
     "create_meter_provider",