log312

log312 is a cross-platform logging library designed for software developers who require fast, structured logging with pluggable output targets. It provides a compact API and supports multiple sinks, including console, files, and network backends. The library emphasizes low overhead and thread safety, making it suitable for client and server applications.

History: The project originated in 2019 as a lightweight micro-library, with its first public release in 2020. Development focuses on minimal dependencies, high performance, and language bindings. Subsequent releases added support for structured data, asynchronous logging, and JSON-formatted output.

Features: Core concepts are log levels, records, and formatters. Log messages can carry structured fields (key-value pairs) in addition to free-form text. Output can be plain text or JSON. The backend system is modular: sinks implement a common interface and can be combined or replaced at runtime. The library supports asynchronous logging, log rotation, and cross-language bindings for C++, Python, and JavaScript. It is designed to be thread-safe and portable across Windows, macOS, and Linux.

Architecture: The system splits concerns into log records, formatters, sinks, and a logger registry. A global or named logger emits records, which are formatted and dispatched to configured sinks. Backends can include console, file, network, or syslog transports.

Usage: Developers create or obtain a logger, configure one or more sinks, and emit messages at various levels. Structured fields can be attached to logs to facilitate filtering, searching, and correlation in centralized log management systems.

See also: Logging library, Structured logging, Log management, Syslog.