LoggingInterceptor
An OkHttp interceptor with a pretty logger for Android HTTP requests and responses, including mock support.
What is LoggingInterceptor?
LoggingInterceptor is an OkHttp3 interceptor library for Android that logs HTTP request and response details in a formatted, readable way. It solves the problem of debugging network calls by providing structured logs with configurable detail levels and built-in mock support for development.
Android developers using OkHttp for network requests who need to debug API calls, inspect HTTP traffic, or mock responses during app development.
Developers choose LoggingInterceptor for its clean, customizable logging output, mock API capabilities, and seamless integration with OkHttp, making network debugging faster and more efficient than manual logging or basic OkHttp logging.
Overview
An OkHttp interceptor which has pretty logger for request and response. +Mock support
Use Cases
Best For
- Debugging HTTP requests and responses in Android apps
- Mocking API responses during development or testing
- Formatting network logs for better readability in Logcat
- Adding custom headers or query parameters to OkHttp requests
- Avoiding log interleaving with batched logging sinks
- Controlling log detail levels (e.g., body, headers, basic) for network calls
Not Ideal For
- Projects not using OkHttp3 on Android, as it's tightly coupled to this stack and won't work with other HTTP clients or platforms.
- Production applications where minimizing logging overhead is critical, as detailed request/response logging can impact performance and expose sensitive data.
- Teams needing server-side or cross-platform logging solutions, since it relies on Android's Logcat and lacks built-in support for remote log aggregation.
Pros & Cons
Pros
Formats HTTP request and response data into structured, easy-to-read Logcat output, making network debugging faster and more intuitive.
Enables mocking API responses with custom JSON via a BufferListener, allowing development without a live backend for testing.
Supports NONE, BASIC, HEADERS, and BODY levels to control log detail, giving developers fine-grained control over what is logged.
With custom sinks like BatchingSink, logs can be batched to avoid interleaving in Logcat, improving readability in multi-threaded scenarios.
Cons
Requires excluding the 'org.json' module in Gradle to avoid conflicts, which can be cumbersome and error-prone in complex projects.
Tied to Android's Logcat, which truncates lines at ~4k characters, necessitating custom chunking for large HTTP bodies as noted in the README.
Enabling mock support requires implementing a BufferListener and managing JSON files manually, adding initial setup overhead compared to simpler tools.
Frequently Asked Questions
Related Projects
logger✔️ Simple, pretty and powerful logger for android
timberA logger with a small, extensible API which provides utility on top of Android's normal Log class.
Logback Android📄The reliable, generic, fast and flexible logging framework for Android
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.