Home

The Flogger Manual

How to use Flogger effectively to improve debugging and code maintainability.

• Background

  • Motivation and History
    • Why Did Google Need Flogger?
    • Benefits of a Unified Logging API
  • API Design Choices
    • Fluent API Choices
    • Instantiating Loggers
    • Platform and Initialization

• Installing Flogger

  • Maven Dependencies
  • Choosing Your Backend

• Basic Usage

  • Hello World
  • Rate Limiting
  • Tags and Metadata
    • Custom Metadata Keys

• Advanced Usage

  • Contexts and Scopes
    • Scoped Tags and Metadata
    • Log Level Control
    • Grpc Context Propagation
  • Log Aggregation Via "per()"
    • Common Use Cases
    • Scope Providers and Per Request Logging
    • Caveats and Limitations
  • Custom Formatting
  • Procedural Metadata Keys

• Writing New Backends

  • Backend API and Principles
  • Message Formatting and Metadata Handling
  • Custom Behaviour via Metadata
  • Multiple Logging Backends

• Writing New Fluent Loggers

  • Pros and Cons
  • Creating a New Format Syntax
  • Extending the API

• Advanced How To

  • Per Request Logging Configuration
  • Structured Logging