client.logging
==============

.. py:module:: client.logging

.. autoapi-nested-parse::

   Logging configuration for jobmon client applications.

   This module provides the standard logging configuration used by
   workflow.run(configure_logging=True).

   The module supports both legacy dict-based configs and new template-based
   configurations. Requester logs are automatically captured by OTLP when
   enabled (handled by the Requester class itself).



Attributes
----------

.. autoapisummary::

   client.logging._DEFAULT_LOG_FORMAT
   client.logging.default_config


Functions
---------

.. autoapisummary::

   client.logging.configure_client_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:function:: configure_client_logging() -> None

   Configure client logging with template and user override support.

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

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

   Note: Requester OTLP is handled separately by the Requester class.