server.web.logging
==================

.. py:module:: server.web.logging

.. autoapi-nested-parse::

   Logging configuration for jobmon server applications.

   This module provides the standard logging configuration used by
   server startup and API initialization.

   The module supports both legacy dict-based configs and new template-based
   configurations. Server logs are automatically captured by OTLP when
   enabled (handled by the server configuration overrides).



Attributes
----------

.. autoapisummary::

   server.web.logging._DEFAULT_LOG_FORMAT
   server.web.logging.default_config
   server.web.logging._server_logging_configured


Functions
---------

.. autoapisummary::

   server.web.logging.configure_server_logging


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

.. py:data:: _DEFAULT_LOG_FORMAT
   :value: '%(asctime)s [%(name)-12s] %(module)s %(levelname)-8s: %(message)s'


.. py:data:: default_config
   :type:  Dict

.. py:data:: _server_logging_configured
   :value: False


.. py:function:: configure_server_logging() -> None

   Configure server logging with template and user override support.

   This is the primary interface for configuring server logging. It supports:
   1. Default template-based configuration
   2. User file overrides via logging.server_logconfig_file
   3. User section overrides via logging.server.*
   4. Environment variable overrides

   Configuration precedence:
   1. Custom file (logging.server_logconfig_file)
   2. Section overrides (logging.server.formatters/handlers/loggers)
   3. Default template (logconfig_server.yaml)
   4. Basic fallback configuration

   Note: Server OTLP is handled separately by the server OTLP manager.