maintallyman - Summary

Show feedback again
Membership Info
Project Admin:
1 active member

Group identification
Id: #279
System Name: tallyman
Name: tallyman
Group Type: Software

Search in this Group


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


Latest News 
Version 1.4
     posted by gray, Mon Nov 22 08:24:42 2021 - 0 replies

Version 1.4 is available for download.

New in this version: tallyman won't attempt to contact the collector if service ID is an empty string. This feature is intended to facilitate creation of general-purpose docker images.

Version 1.3
     posted by gray, Fri Feb 5 11:12:37 2021 - 0 replies

Version 1.3 is available for download. This version introduces new statement "snmp-client-config", which defines the file with SNMP client configuration, and improves interaction with hostproc. Namely, hostproc is notified when the container ID of an instance has changed. ...

[Read more]
Version 1.2
     posted by gray, Sat Oct 10 07:18:21 2020 - 0 replies

Version 1.2 is available for download. This version provides an interface with hostproc.

Version 1.1
     posted by gray, Wed Aug 14 07:25:20 2019 - 0 replies

Tallyman version 1.1 is available for download.

[Submit News]
[4 news in archive]
Show feedback again

Back to the top

Powered by Savane 3.1-cleanup+gray