Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Stream supervisor events to a logstash instance

Project Description

[![Build Status](](

This is a port of the [Supervisor-logging]( project. Rather than capture loglines, as Supervisor-logging does it's intended to capture the [`PROCESS_STATE`]( events that Supervisor emits.


A [supervisor]( plugin to stream events to a Logstash instance (for example, Logstash).


Python 2.7 or Python 3.2+ is required.

pip install supervisor-logstash-notifier

Note that Supervisor itself does not yet work on Python 3, though it can be
installed in a separate environment (because supervisor-logstash-notifier is a separate


The Logstash instance to send the events to is configured with the environment


Add the plugin as an event listener:

command = logstash_notifier

If you don't wish to define the environment variables for the entire shell, you can pass them in via Supervisor's


Running with Logstash

Logstash can be simply configured to receive events:

input {
tcp {
port => 12201
codec => json

output {
stdout {
codec => rubydebug

Release History

This version
History Node


Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting