Free Software

This package makes it possible to monitor state of running docker containers using SNMP. It consists of two programs:

• tallyman - health state collector to be run inside the container
• stevedore - container state collector and SNMP agent daemon

It is supposed that each container is responsible for certain service. Each service is assigned an ID. Multiple containers can run the same service (for example you can have several database containers).

Containers are configured to run tallyman as their healthcheck command. The utility takes two or more arguments: the ID of the service the container is responsible for and the name of the actual health-checking program with its command line arguments. Tallyman will run this command, collect its standard error and standard output, pack them along with the program exit code in a JSON packet, and send this packet to the predefined address using HTTP POST request. It will then exit with the same code as the health-checking program it ran. To the container, the effect of running tallyman is the same as if it ran the health-checking program itself: error code, standard error and standard output are all preserved. On the other hand, they are sent to the remote collector which is listening on the predefined address outside the container. This collector is the stevedore program.

The purpose of stevedore is two-fold. First, it provides a RESTful service that collects health check reports from multiple containers, and secondly it acts as SNMP subagent, delivering the collected information to the snmpd daemon.

Registration Date: Wed Feb 6 13:37:33 2019
License: GNU General Public License V3 or later
Development Status: 5 - Production/Stable