---
id: superlance
version: "2.0.0"
license: BSD-derived (http://www.repoze.org/LICENSE.txt)
license_treatment: permissive
maintenance: aging
---

# superlance — superlance plugins for supervisord

License: permissive · Maintenance: aging · Downloads: 142.5K/mo

## What it is and what it does

Superlance is a collection of monitoring plugins designed to extend supervisor, the process control system. It runs as event listeners within supervisor's daemon and responds to process state changes by performing checks—HTTP endpoint health verification, memory usage thresholds, crash detection—and triggering actions like process restarts, email notifications, or SMS alerts.

The package is intended for system administrators running supervisor-based deployments who need automated monitoring beyond supervisor's built-in capabilities. It works by subscribing to supervisor's event system and executing checks on a schedule or in response to process state transitions. Configuration is done through supervisor's own configuration file, making it a natural extension for existing supervisor setups.

Use it for:

- Monitor HTTP endpoints of supervised processes and restart them if they stop responding.
- Track memory usage of long-running processes and restart them when they exceed a threshold.
- Detect process crashes and send email or SMS notifications to administrators.
- Batch email alerts for multiple process failures to reduce notification noise.
- Identify processes that restart too frequently and alert only when uptime falls below a threshold.

## Worth the install?

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

Superlance provides plugin utilities for monitoring and controlling processes running under supervisor, including HTTP health checks, memory monitoring, crash detection, and email/SMS alerting.

Yes, if you run supervisor and need automated process monitoring beyond its native capabilities. The package is stable (Production/Stable status) and permissively licensed, but be aware that maintenance is aging—the last release was 2021-12-27 with no recent commits. Verify compatibility with your supervisor and Python versions before deploying to production.

## Install

pip install superlance
uv add superlance
poetry add superlance

## Installing superlance

Before you install: Low install friction with a single runtime dependency on supervisor. Maintenance is aging—last release was 2021-12-27 with no commits since 2025-10-27, though the repository remains active and unarchived.

License in practice: Licensed under a BSD-derived license (permissive), so you can use, modify, and distribute the package with minimal legal restrictions.

Quickstart:

pip install superlance

After installation, configure supervisor to load superlance plugins in supervisord.conf:
[eventlistener:httpok]
command=httpok -p processname http://localhost/health
events=TICK_60

Requires supervisor to be installed and running; superlance is a plugin system for supervisor, not a standalone tool.

Verify before relying:

- Whether the aging maintenance status (last release 2021-12-27) affects compatibility with recent supervisor versions.
- Specific Python 3.10+ compatibility beyond what classifiers declare.
- Buffer size and other configuration parameters for event listeners.

## Package facts

- License: BSD-derived (http://www.repoze.org/LICENSE.txt) (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 142.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

supervisor process monitoring, HTTP health check plugin, process memory monitoring, crash detection alerting, supervisor daemon utilities, process state monitoring, supervisord plugin, supervisor-plugin, process-monitoring, sysadmin-tool

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