fluent-logger

What it is and what it does

fluent-logger is a Python client library that sends structured event logs to Fluentd or Fluent Bit, which then handle reliable buffering, log forwarding, and centralized collection. It provides three interfaces: a direct FluentSender API for explicit event emission, an event-based wrapper for global sender setup, and a Python logging.Handler integration for use with the standard logging module. The library serializes events using msgpack and communicates over TCP to a Fluentd/Fluent Bit daemon, supporting both second and nanosecond timestamp precision.

The package is designed for applications generating high volumes of event logs (login, logout, purchase, follow events, etc.) where centralized analysis is valuable. It handles connection failures gracefully with optional buffer overflow handlers, allows custom log formatting, and supports asynchronous communication. The library requires Python 3.7 or later and depends only on msgpack for serialization.

Use it for:

• Send application events (logins, purchases, user actions) to Fluentd for real-time analysis and dashboarding.
• Integrate Python logging output with Fluentd using the standard logging.Handler interface for structured log aggregation.
• Implement custom event buffering and overflow handling when Fluentd is temporarily unavailable.
• Collect nanosecond-precision timestamped events from Python services for high-resolution timing analysis.
• Forward application metrics and events to Fluent Bit on edge devices or resource-constrained environments.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Sends structured event logs from Python applications to Fluentd or Fluent Bit for centralized collection and analysis.

Yes, if you are already running Fluentd or Fluent Bit and need a straightforward Python client to send structured events. The package is stable, has low install friction, and integrates cleanly with Python's logging module. The dormant maintenance status is not a blocker for stable use, but verify compatibility with your Fluentd/Fluent Bit version and monitor the repository for security updates.

Install

fluent-logger on PyPI

pip install fluent-logger

uv add fluent-logger

poetry add fluent-logger

Installing fluent-logger

Before you install

Low friction installation with a single runtime dependency (msgpack). Maintenance is dormant—last release was 2024-06-06 and no commits since 2024-06-17—but the package is marked Production/Stable and has been actively maintained since 2011.

License in practice

Licensed under Apache License 2.0 per the raw license text. License treatment is marked unclear, so verify the SPDX classification matches your compliance requirements before use in proprietary or restricted contexts.

Quickstart

pip install fluent-logger

from fluent import sender
logger = sender.FluentSender('app', host='localhost', port=24224)
logger.emit('follow', {'from': 'userA', 'to': 'userB'})
logger.close()

Requires a running Fluentd or Fluent Bit daemon listening on the configured host and port (default localhost:24224).

Verify before relying

• Whether the dormant maintenance status (no commits since June 2024) affects long-term compatibility with current Fluentd/Fluent Bit versions.
• Performance characteristics and throughput limits under high-volume event logging scenarios.

Package facts

Evidence: fluent_logger-0.11.1-py3-none-any.whl

Tags

More Logging packages