Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!


Project Description


A process monitor using an extremely limited (but still useful enough for me)
subset of the systemd watchdog protocol

"450 downloads in the last week" -- are people actually using this, or is pypi
just full of bots? o.o;; I welcome your feedback if you are actually a person :)

Usage: sdog [options] -- daemon-to-run [daemon options]

-h, --help show this help message and exit
-t N, --timeout=N Maximum seconds between pings
-r N, --respawn=N Delay between respawns
-s FILE, --socket=FILE Path to socket
-T NAME, --title=NAME Daemon name (defaults to the first param after "--")
(Requires setproctitle module)
-v, --verbose Verbose mode

For Daemons

There is the sdog.notifier module

from sdog.notifier import SDNotifier

def main():
# Create the notifier
sd = SDNotifier()

# Connect to the work queue and signal that we're ready to go
work_queue = WorkQueue("localhost:1234")

while True:
# Get some work and signal that we're working on it
item = work_queue.get()
sd.status("Processing %s" %

# Do the work then signal that we are alive and running successfully


The daemon will be launched with `NOTIFY_SOCKET=/some/path.sock` in its
environment; it should then write datagram packets into this socket:

READY=1 -- signal that the daemon has loaded, and to start monitoring
WATCHDOG=1 -- must be sent at least once every $timeout seconds
STATUS=blah -- update the current status message

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(4.0 kB) Copy SHA256 Hash SHA256
Source None Mar 18, 2014

Supported By

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 Google Google Cloud Servers