Home

Welcome to the Async HTTP Logging documentation.

---

---

Sections

1. Basic usage instructions
2. Handler Class
3. HTTP Transport Class
4. Formatter Class
5. Local caching with SQLite
6. Anatomy of POST requests sent to the HTTP host
7. Adding custom HTTP headers to requests
8. Logging extra fields
9. Configuration Constants and Environment Variables

Acknowledgement

Async HTTP Logging is almost entirely based on the Python LogStash Async library.

Async HTTP Logging consists basically of three Classes (Handler, HTTP Transport, Formatter) that wrap over the ones in Python LogStash Async.

We liked the approach used in Python LogStash Async, namely:

• Keeping log messages in a local cache using a SQLite database
• Sending log messages in batches
• Controlling time-to-live and timeout settings
• Customizing log messages, taking extra fields from logging methods and enriching with LogRecord attributes

Although it's a great service, we didn't enjoy being limited to Elastic LogStash. Async HTTP Logging is a transformation to a library agnostic to backend stack. To use it, you only need an HTTP API that accepts POST requests configured at your desired hostname.