SDog
Project description
sdog
====
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]
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")
sd.ready()
while True:
# Get some work and signal that we're working on it
item = work_queue.get()
sd.status("Processing %s" % item.name)
# Do the work then signal that we are alive and running successfully
do_some_work(item)
sd.watchdog()
```
Protocol
========
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
```
====
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]
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")
sd.ready()
while True:
# Get some work and signal that we're working on it
item = work_queue.get()
sd.status("Processing %s" % item.name)
# Do the work then signal that we are alive and running successfully
do_some_work(item)
sd.watchdog()
```
Protocol
========
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
```
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
SDog-0.2.2.tar.gz
(4.0 kB
view hashes)