logging-patterns

Use when adding logging to features - structured logging with LoggerService categories

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 19, 2025

When & Why to Use This Skill

The Logging Patterns skill provides a standardized framework for implementing structured logging within Python applications using a dedicated LoggerService. It streamlines the process of adding diagnostic information by enforcing consistent categories—such as API, Database, and ModelLoad—and appropriate log levels. This ensures that application logs are organized, searchable, and actionable, which significantly reduces the time required for troubleshooting and enhances overall system observability.

Use Cases

  • Standardizing Development: Implementing a consistent logging architecture across a multi-developer project to ensure all features follow the same diagnostic patterns.
  • Targeted Troubleshooting: Using domain-specific categories like [Database] or [Socket] to isolate and resolve issues within specific layers of the application stack.
  • Production Monitoring: Utilizing structured log levels (Info, Warning, Error) to provide clear insights into system health and facilitate automated alerting based on log severity.
  • Performance Optimization: Leveraging the [ModelLoad] and [GPU] categories to track and debug resource-intensive operations in machine learning workflows.
namelogging-patterns
descriptionUse when adding logging to features - structured logging with LoggerService categories

Logging Patterns

Use this skill when implementing features that need logging or debugging.

Checklist

Setup Logger

  • Import LoggerService: from app.services import logger_service
  • Get logger with category: logger = logger_service.get_logger(__name__, category='[Category]')
  • Verify category matches feature domain (see categories below)

Select Appropriate Category

Choose the category that matches your feature domain:

  • [ModelLoad] - Model loading operations
  • [Download] - Download operations
  • [Generate] - Image generation
  • [API] - API endpoints
  • [Database] - Database operations
  • [Service] - Service layer operations
  • [Socket] - WebSocket events
  • [GPU] - GPU operations

Use Appropriate Log Level

  • .debug() - Detailed diagnostic information (only visible with LOG_LEVEL=DEBUG)
  • .info() - General informational messages (progress, status updates)
  • .warning() - Warning messages (degraded functionality, deprecated usage)
  • .error() - Error messages (failures that don't stop execution)
  • .exception() - Exceptions with full stack traces (use in except blocks)

Example Usage

from app.services import logger_service

logger = logger_service.get_logger(__name__, category='ModelLoad')

def load_model(model_path: str):
    logger.info(f'Loading model from {model_path}')
    try:
        # ... model loading logic
        logger.debug('Model loaded successfully')
    except FileNotFoundError as error:
        logger.error(f'Model file not found: {error}')
        raise

Configuration

  • Test with debug logging: LOG_LEVEL=DEBUG uv run python main.py
  • Verify logs appear with correct category prefix in output

Reference

See app/services/logger.py for LoggerService implementation.