biz-bud/examples/succinct_logging_example.py

"""Example demonstrating the new succinct logging configuration.

This shows how the new logging filters reduce verbosity while maintaining
meaningful information in the logs.
"""

import logging
import time
from pathlib import Path

# Import the logging configuration
from biz_bud.logging import get_logger, setup_logging


def simulate_verbose_logs():
    """Simulate the verbose logs that were problematic."""
    setup_logging(level="DEBUG")
    logger = get_logger("example_app")

    # Simulate LangGraph queue stats (these will be filtered)
    for i in range(20):
        logger.info(
            f"Stats(queue_id='test-queue-{i}', worker_id='worker-1', "
            f"timestamp=datetime.datetime(2025, 1, 9, 10, 30, {i}, 123456))"
        )

    # Simulate HTTP retries (only first and last will show)
    for attempt in range(1, 6):
        logger.warning(f"Retrying HTTP request: attempt {attempt}/5")
        time.sleep(0.1)

    # Simulate timeout warnings (will be reduced)
    for i in range(10):
        logger.warning(f"Request timeout after 30 seconds - iteration {i}")

    # Simulate service initialization (only first will show)
    for service in ["auth", "database", "cache", "api"]:
        logger.info(f"Initializing {service} service...")
        logger.info(f"Service {service} initialized successfully")


def demonstrate_new_features():
    """Demonstrate the new logging features."""
    setup_logging(level="INFO")
    logger = get_logger("demo")

    logger.info("Starting demonstration of succinct logging")

    # The new filters will:
    # 1. Show only every 10th queue stat
    # 2. Show only first and last retry
    # 3. Show timeout warnings every 5th occurrence
    # 4. Show service init only once per service
    # 5. Simplify datetime formatting

    simulate_verbose_logs()

    logger.info("Verbose logs have been filtered for clarity")


def demonstrate_yaml_config():
    """Show how to use YAML configuration for fine-grained control."""
    # Try to load YAML config if available
    config_path = (
        Path(__file__).parent.parent
        / "packages"
        / "business-buddy-core"
        / "src"
        / "bb_core"
        / "logging"
        / "logging_config.yaml"
    )

    if config_path.exists():
        try:
            # YAML config loading not available in current implementation
            logger = get_logger("config")
            logger.info("Loaded YAML logging configuration")
        except Exception as e:
            logger = get_logger("config")
            logger.warning(f"Could not load YAML config: {e}")

    # Now logs will follow the YAML configuration rules


def demonstrate_custom_log_levels():
    """Show how to adjust logging levels programmatically."""
    # Set different levels for different components
    setup_logging(level="INFO")

    # You can also set specific loggers
    langgraph_logger = logging.getLogger("langgraph")
    langgraph_logger.setLevel(logging.ERROR)  # Only show errors from LangGraph

    httpx_logger = logging.getLogger("httpx")
    httpx_logger.setLevel(logging.ERROR)  # Only show errors from httpx


if __name__ == "__main__":
    print("=== Succinct Logging Configuration Demo ===\n")

    print("1. Demonstrating filtered verbose logs:")
    demonstrate_new_features()

    print("\n2. Demonstrating YAML configuration:")
    demonstrate_yaml_config()

    print("\n3. Demonstrating custom log levels:")
    demonstrate_custom_log_levels()

    print("\n=== Demo Complete ===")
    print("\nKey improvements:")
    print("- LangGraph queue stats: Shown every 10th occurrence")
    print("- HTTP retries: Only first and last attempts shown")
    print("- Timeout warnings: Shown every 5th occurrence")
    print("- Service init messages: Shown only once")
    print("- Datetime objects: Simplified to readable format")
    print("- HTTP client logs: Reduced to WARNING level by default")