server.web.log_config
=====================

.. py:module:: server.web.log_config

.. autoapi-nested-parse::

   Configure Logging for structlog, OpenTelemetry, etc.



Functions
---------

.. autoapisummary::

   server.web.log_config.configure_structlog
   server.web.log_config.configure_logging
   server.web.log_config._apply_logging_config
   server.web.log_config._validate_otlp_configuration


Module Contents
---------------

.. py:function:: configure_structlog(extra_processors: Optional[List] = None) -> None

   Configure structlog processors.


.. py:function:: configure_logging(dict_config: Optional[Dict] = None, file_config: str = '') -> None

   Configure logging for the server.

   :param dict_config: Logging configuration as a dictionary (highest precedence)
   :param file_config: Path to logging configuration file (second precedence)

   The configuration is selected in the following order:
   1. dict_config parameter (if provided)
   2. file_config parameter (if provided and file exists)
   3. JobmonConfig logging.server_logconfig_file setting
   4. Auto-selected template based on telemetry configuration


.. py:function:: _apply_logging_config(logging_config: Dict, source_description: str) -> None

   Apply logging configuration with validation and error reporting.

   :param logging_config: The logging configuration dictionary
   :param source_description: Description of where the config came from for error reporting


.. py:function:: _validate_otlp_configuration(logging_config: Dict, source_description: str) -> None

   Validate OTLP configuration and log any issues found.

   :param logging_config: The logging configuration dictionary
   :param source_description: Description of where the config came from