superlance

library2.0.0pypypi✓ verified 85d ago

Superlance is a collection of plugin/monitor scripts for the Supervisor process control system. Version 2.0.0 introduces a major restructuring: it now requires Python 3.6+ and Supervisor 4+, and all scripts are installed as console scripts (e.g., `memmon`, `httpok`). The library is actively maintained with a mature API.

devops observability

pip install superlance

github ↗package ↗

INSTALL

IMPORT

SIG · SUPERLANCE

superlance

devopspythonv2.0.0

Install

1.9s avg

Import

269ms

Disk

20MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.272s · 21.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.9s · import 0.266s · 22MB

20MB installed

● package 20MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Memmon

✓ from superlance.memmon import Memmon

Memmon is a class that monitors memory usage of supervised processes.

HttpOk

✓ from superlance.httpok import HttpOk

HttpOk checks HTTP endpoints and restarts processes if they are not responding.

FatalMailBatch

✓ from superlance.fatalmailbatch import FatalMailBatch

Sends email notifications for fatal process events.

Verify that Superlance is installed and importable. Superlance scripts are typically run as command-line programs, not imported as libraries.

python -c "from superlance.memmon import Memmon; print('Memmon imported successfully')"

memmon --version

Debug

Known issues

breakingSuperlance 2.0.0 drops support for Python versions before 3.6 and Supervisor versions before 4. If you are on an older environment, pin to superlance==1.0.2.

fix

Upgrade to Python 3.6+ and Supervisor 4+. Alternatively, use `pip install superlance==1.0.2`.

affects: 2.0.0

breakingIn Superlance 2.0.0, the old pattern of running scripts via `python -m superlance.memmon` no longer works. Use the console scripts directly (e.g., `memmon`).

fix

Run `memmon` instead of `python -m superlance.memmon`.

affects: 2.0.0

gotchaSuperlance scripts read Supervisor event listener configuration from the [eventlistener:...] section in supervisord.conf. Misconfiguration of the listener (e.g., missing environment variables) causes silent failures.

fix

Ensure you have properly configured the [eventlistener:xxx] section in supervisord.conf and that the script path points to the correct console script.

affects: all

Errors

Common errors & fixes

ImportError: No module named 'superlance'

Superlance is not installed, or the environment is not activated.

fix

Run `pip install superlance` in the correct Python environment.

FileNotFoundError: [Errno 2] No such file or directory: 'memmon'

Superlance scripts are not installed as executable commands; often due to missing PATH or using old import pattern.

fix

Ensure superlance is installed in the same Python environment as supervisord. Use `which memmon` to locate, or run `python -m superlance.memmon` if using superlance <2.0.0.

superlance.eventlistener: Error: listener configuration not found

The supervisord.conf does not contain the required [eventlistener:...] section for the plugin.

fix

Add an eventlistener section in supervisord.conf, e.g.:
[eventlistener:memmon]
command=memmon
events=PROCESS_STATE

Upgrade

Version history

2.0.0latest on PyPI · released Dec 27, 2021

Audit

Dependencies

supervisorrequiredSuperlance plugins run as Supervisor event listeners; supervisor must be installed and configured.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Supervisor/superlance ↗

packagehttps://pypi.org/project/superlance/ ↗