Quill

Quill is a high-performance asynchronous C++ logging library. It excels in performance-critical applications where every microsecond counts.

GitHub Repository

Getting Started

• Overview
  • Thread Safety
  • Logging types
  • Reliable Logging Mechanism
  • Manual Log Flushing
  • Synchronized Logs for Debugging
  • Handling Application Crashes
  • Log Messages Timestamp Order
  • Number of Backend Threads
  • Latency of the First Log Message
  • Configuration
  • Frontend (caller-thread)
  • Backend
  • Design
• Installing
  • Package Managers
  • CMake-Integration
• Examples
  • Simple
  • Logging to file
• Cheat Sheet
  • Introduction
  • LOGV Macros
  • Logging Built-in Types and Strings
  • Logging Arithmetic C-style Arrays
  • Logging Enums
  • Logging Strings Without Additional Copy
  • Logging STL Library Types
  • Logging Nested STL Library Types
  • Logging Wide Strings
  • Logging User Defined Types

Tutorial

• Backend Options
• Backtrace Logging
  • Store messages in the ring buffer and display them when LOG_ERROR is logged
  • Store messages in the ring buffer and display them on demand
• Basic Example
• CSV Writing
  • CSV Writing To File
  • CSV Writing To Existing Sink
• Filters
• Formatters
  • Customising the timestamp
  • Customizing Log Message Formats
• Frontend Options
• JSON Logging
  • Logging Json to Console
  • Logging Json to File
  • Combining JSON and Standard Log Patterns
• Log Tagging
• Loggers
  • Logger Creation
  • Logger Retrieval
  • Simplifying Logger Usage for Single Root Logger Applications
• Logging Macros
  • Compile-Time Log Level Filtering
  • Standard Logging Macros
  • Value-based Macros (LOGV)
  • JSON Logging Macros (LOGJ)
  • Dynamic Logging Macros
• Sinks
  • Sharing Sinks Between Loggers
  • Customizing the Library with User-Defined Sinks
• Sink Types
  • ConsoleSink
  • FileSink
  • RotatingFileSink
  • JsonFileSink/JsonConsoleSink
• Timestamp Types
  • Timestamp Recording
  • Timestamp Methods
  • Providing a Custom Timestamp
  • Getting a Synchronized Timestamp with the Backend Thread TSC Clock
• Wide Strings
  • How It Works
  • Wide String Logging Example

User API

• User’s API
  • Backend Options
  • Backend Class
  • BackendTscClock Class
  • SignalHandler Options
  • Frontend Options
  • Frontend Class
  • Log Levels
  • LoggerImpl Class
  • PatternFormatter Class
  • PatternFormatterOptions Class
  • Sink Class
  • Filter Class
  • FileSinkConfig Class
  • FileSink Class
  • RotatingFileSinkConfig Class
  • RotatingFileSink Class
  • JsonFileSink Class
  • JsonConsoleSink Class
  • CsvWriter Class