JakeWharton/timber
Timber
Timber is an extensible logging framework and wrapper for Android applications. It provides an interface that extends the standard Android logging class to enable customizable output destinations and routing logic.
The system uses a tree-based dispatch model and a plugin system to direct log messages to multiple external handlers. This allows for custom log routing to external services or files based on the current environment or specific criteria.
The project includes tools for monitoring and observability, specifically a performance validator that analyzes logging calls to detect inefficient string patterns or incorrect argument counts. It also supports runtime handler registration to manage active logging destinations during app execution.
Features
- Android Log Management - Provides a comprehensive framework for managing and routing system logs within Android applications.
- Logging Frameworks - Provides an extensible system for capturing, formatting, and routing application log events to multiple handlers.
- Logging Destination Plugins - Implements an interface-based system allowing custom log destinations to be plugged into the logging pipeline.
- Application Log Routing - Directs internal application log messages to multiple external destinations based on specific criteria.
- Custom Log Writers - Enables the creation of custom writers to intercept and route diagnostic messages to external logging systems.
- Log Handler Registrations - Maintains a dynamic list of active logging destinations that can be added or removed during app execution.
- Log Call Validators - Analyzes logging calls to detect inefficient string patterns or incorrect argument counts in Android code.
- Logging Performance Optimization - Reduces logging overhead by validating string patterns and argument counts during development.
- Centralized Dispatchers - Uses a central coordinator to route log messages to one or more registered handler implementations.
- Logging Call Analysis - Provides build-time checks to detect inefficient string patterns and incorrect argument counts in logging calls.
- Logging Call Validations - Analyzes code to detect incorrect argument counts or inefficient string patterns to ensure performant logging.
- Logging Frameworks - Extensible logging API built on top of standard Android logs.
- Logging Utilities - Extensible logger utility.
- Mobile UI & Components - A logger with a small, extensible API which provides utility on top of Android's normal Log class.
