---
id: fluent-logger
version: "0.11.1"
license: Copyright (C) 2011 FURUHASHI Sadayuki Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the… (full text in the JSON record)
license_treatment: unclear
maintenance: dormant
---

# fluent-logger — A Python logging handler for Fluentd event collector

License: unclear · Maintenance: dormant · Downloads: 2.3M/mo

## 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 above — 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

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

- License: Copyright (C) 2011 FURUHASHI Sadayuki Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 2.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fluentd python logger, structured logging fluent bit, event log forwarding python, fluentd client library, centralized log collection python, fluent logger sender, python logging handler fluentd, log-aggregation, fluentd-integration, event-streaming

[View on SkillFed](https://skillfed.io/packages/fluent-logger) · [View on PyPI](https://pypi.org/project/fluent-logger/)