---
id: python3-logstash
version: "0.4.80"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# python3-logstash — Python logging handler for Logstash.

License: permissive · Maintenance: abandoned · Downloads: 811.8K/mo

## What it is and what it does

python3-logstash is a Python logging handler that bridges Python's standard logging module to Logstash, a log aggregation and processing platform. It captures log records and ships them to a Logstash instance via UDP or TCP, optionally supporting AMQP transport. The handler integrates seamlessly with Django and Gunicorn through standard Python logging configuration, allowing you to attach structured log data as extra fields and forward everything to a centralized Logstash pipeline.

The package has no runtime dependencies and installs as a pure Python wheel, making setup friction minimal. However, it has been abandoned since 2018—the last release predates major Python and Logstash evolution—so it will not adapt to schema changes or modern Python versions without external maintenance.

Use it for:

- Forward Django application logs to Logstash for centralized monitoring and analysis across multiple instances.
- Ship Gunicorn access and error logs to Logstash using TCP or UDP handlers configured in logging.conf.
- Aggregate Python application logs with custom extra fields (strings, booleans, dicts, lists) into a Logstash index.
- Route exception stack traces and application errors to Logstash for alerting and debugging workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python logging handler that forwards log messages to Logstash via UDP or TCP, integrating Python's standard logging framework with Logstash for centralized log aggregation.

Yes, if you are already running Logstash and need a lightweight Python logging bridge on a stable, unchanging codebase. No, if you require active maintenance, compatibility with recent Python versions, or support for modern Logstash schema versions—consider a maintained alternative or direct HTTP/JSON logging instead.

## Install

pip install python3-logstash
uv add python3-logstash
poetry add python3-logstash

## Installing python3-logstash

Before you install: Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 2018-07-12 and last commit 2023-05-12—so it will not receive updates for Python or Logstash schema changes.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install python3-logstash

import logging
import logstash

test_logger = logging.getLogger('python-logstash-logger')
test_logger.setLevel(logging.INFO)
test_logger.addHandler(logstash.LogstashHandler('localhost', 5959, version=1))
test_logger.info('test message')

Logstash must be running and listening on the specified host and port; optional AMQP support requires pika to be installed separately.

Verify before relying:

- Whether the package works with current Logstash versions and modern Python releases beyond those it was originally tested against.
- Whether UDP/TCP message format remains compatible with contemporary Logstash event schema versions.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 811.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

logstash logging handler, python logging to logstash, centralized log aggregation, udp tcp log forwarding, logstash integration python, structured logging handler, log shipping to logstash, log-aggregation, logstash-integration, abandoned-maintenance

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