Repository navigation
v1.1.0
π structured-logger v1.1.0 - Advanced Logging Features
This major feature release introduces enterprise-grade logging capabilities while maintaining full backward compatibility.
β¨ New Advanced Features
π Async Logging
- High-performance non-blocking logging operations
- Queue-based buffering with automatic overflow handling
- Perfect for high-throughput applications
π‘οΈ Log Validation & Schema Enforcement
- Define required fields, types, and custom validators
- Automatic validation with graceful failure handling
- Ensure data quality and consistency across your application
β±οΈ Rate Limiting & Sampling
- Prevent log flooding with configurable burst limits
- Smart sampling with time-window controls
- Automatic cleanup of old tracking data
π Built-in Metrics Collection
- Track log counts, performance, and error patterns
- Background metrics reporting with configurable intervals
- Monitor application health through logging metrics
ποΈ File Rotation
- Automatic log file management
- Size-based and time-based rotation strategies
- Configurable backup retention policies
π Correlation ID Management
- Automatic request/trace correlation for distributed systems
- Context managers for easy correlation tracking
- Built-in web framework integration examples
π New Files Added
- structured_logger/advanced.py - Core advanced features module
- ADVANCED_FEATURES.md - Comprehensive documentation
- examples/advanced_features.py - All features demonstration
- examples/flask_advanced.py - Flask integration example
- examples/fastapi_advanced.py - FastAPI integration example
- examples/test_all_features.py - Complete test suite
π§ Enhanced Core Features
- Extended LoggerConfig with 6 new advanced feature toggles
- Improved StructuredLogger with async support and validation
- Enhanced initialization with advanced feature detection
- Backward-compatible API - existing code works unchanged
π― Key Benefits
- Zero Dependencies - All features built with Python standard library
- High Performance - Minimal overhead with smart optimizations
- Production Ready - Comprehensive error handling and graceful degradation
- Developer Friendly - Rich examples and detailed documentation
π Stats
- 1,960+ lines added across 10 files
- 6 major new features with full configuration options
- 5 working examples for quick integration
- 400+ lines of documentation with troubleshooting guide
π¦ Getting Started
from structured_logger import get_logger, LoggerConfig
from structured_logger.advanced import LogSchema, SamplingConfig
Enable advanced features
config = LoggerConfig(
enable_async=True,
enable_validation=True,
enable_metrics=True,
force_json=True
)
logger = get_logger(name, config=config)
π Migration
Existing code continues to work without any changes. Simply update imports to access new advanced features.
π Documentation
See ADVANCED_FEATURES.md for complete documentation, examples, and integration guides for Flask, FastAPI, and more.
Full Changelog: v1.0.2...v1.1.0