jokerman is an observation software for host status using ping & HTTP.
deadman does not have rich functionalities. It only checks host statuses using ICMP echo. We recommend using deadman for building temporary networks such as conference and event networks. This software was originally designed and implemented for Interop Tokyo ShowNet. This software is a fork of deadman, extended and renamed as jokerman. It adds support for HTTP connectivity checks in addition to the original ICMP echo functionality.
Clone this repository and then run.
$ git clone https://github.com/haturatu/jokerman.git
$ cd jokerman
$ ./jokerman jokerman.conf
To change the targets, modify or create a config file.
$ cat deadman.conf
google 173.194.117.176
googleDNS 8.8.8.8
---
kame 203.178.141.194
kame6 2001:200:dff:fff1:216:3eff:feb1:44d7
---
# If the SSL certificate has expired
failssl expired.badssl.com https=true
website1 example.com https=true
# This endpoint destination is 404
website2 example.com https=url=https://example.com/api,timeout=3,verify=false,expected_status=200
# MyWebsite :)
website3 soulminingrig.com https=true
deadman with -a or --async-mode option sends ping to targets
asynchronously.
Each line in the config file indicates a target host. Ping options, specifying source addresses and using netns, etc, are noted on the deadman.conf. For example, ping via a remote host through ssh is implemented.
google-via-ssh 173.194.117.176 relay=X.X.X.X os=Linux
This line means sending ping to a google server via the remote server X.X.X.X. username and ssh-key for the remote host can be specified by user=USER, key=KEYPATH. Other ssh attributes follow user's environment executing deadman.
You can also use --- to display the separator.
It's useful for grouping the targets.
Moreover, -s option indicates the scale of RTT bar graph. default is 10ms.
You can send deadman a SIGHUP to have it reload its configuration file. When this happens, existing entries will not lose their history.
MIT
deadman: upa@haeena.net
jokerman: taro@eyes4you.org