rs/zerolog
Zerolog
Zerolog is a structured logging library for Go designed for high-performance event capture and observability. It focuses on generating machine-readable JSON output while minimizing memory overhead through zero-allocation buffer encoding and strongly-typed field validation.
The library distinguishes itself by providing a chainable, context-aware interface that allows developers to bind trace identifiers and metadata directly to request lifecycles. It supports complex diagnostic workflows by enabling independent logger instances, custom output routing to multiple concurrent destinations, and event-based sampling to manage log volume and storage costs.
Beyond its core structured output, the toolkit includes features for local development, such as transforming machine-readable data into colorized, human-friendly console text. It also maintains compatibility with existing systems by providing adapters that wrap standard library logging interfaces, allowing for the integration of modern diagnostic capabilities into legacy codebases.
Features
- Go - Provides a toolkit for capturing application events and request context to simplify debugging and observability in Go.
- High-Performance Logging - Provides a logging framework optimized for minimal resource consumption and high throughput in complex applications.
- Structured Logging Frameworks - Generates high-performance, machine-readable JSON logs with strongly-typed fields for detailed observability.
- Contextual Metadata Propagation - Automatically binds trace identifiers and metadata to request lifecycles for consistent observability.
- Zero-Allocation Buffer Encoders - Serializes log events directly into reusable buffers to minimize memory allocation overhead.
- Contextual Logging - Binds trace identifiers and metadata to request contexts to ensure logs remain traceable throughout the application lifecycle.
- Logging - Zero-allocation JSON logging.
- Logging - High-performance zero-allocation logging.
- Logging Frameworks - Zero-allocation JSON logger for Go.
- Logging Libraries - Zero-allocation JSON logger.
- Distributed Tracing - Binds trace identifiers to request lifecycles to ensure logs remain traceable across distributed system components.
- Sampling Strategies - Reduces total log volume by applying sampling strategies based on frequency or burst thresholds.
- Standard Library Adapters - Provides adapters that wrap standard library logging interfaces to maintain compatibility with legacy codebases.
- Sampling Strategies - Reduces log storage overhead by applying frequency-based sampling to system events.
- Log Management - Reduces total log storage costs by applying sampling strategies based on frequency or burst thresholds.
- Logging Pipelines - Broadcasts log messages to multiple destinations simultaneously, such as standard output, files, or remote services.
- Multi-Writer Multiplexers - Broadcasts log streams to multiple concurrent destinations by delegating to registered output handlers.
- Diagnostic Compatibility Layers - Wraps existing logging interfaces to maintain compatibility with older codebases.
- Type Safety - Enforces data integrity and prevents errors through strict validation and structured type definitions during log field construction.
- Independent Logger Instances - Supports creating independent logger instances to route messages to specific destinations or apply unique configurations.
- Custom Log Writers - Executes user-defined functions before writing log events to inject dynamic fields or send data to external systems.
- Logging Compatibility Adapters - Maintains compatibility with legacy logging interfaces while providing modern diagnostic capabilities.
