Package: tanto
Github repositoryPyPI pageOverviewTo monitor the servers with Shinken, Nagios or Icinga, system administrators usually configure active checks of the monitored servers.
It means the monitoring system must have a direct network access to the monitored server.WithTanto, this model is reverted, it does passive checks of your monitored servers.
You don’t need to open an access from your monitoring system to the monitored servers.The main use case of this tool is to monitor distant servers in a complex network where you can’t connect directly for security reasons, typically with a large client.
You need only to openNSCAorHTTP(S)port from the monitored server to the monitoring system.Moreover, if you don’t have a monitoring server, Tanto has a standalone mode.
You will receive alerts via e-mail directly.Technical detailsThe behaviour of this tool is simple:The program is started by cron.It retrieves monitoring data(1)fromnagios-plugins.Finally, it pushes the data(2)viaNSCA(Shinken, Nagios, Icinga),HTTP(S)(Shinken) to the monitoring server or viaSMTP.(WS-Shinken only) If the connexion between the monitored server and the monitoring system is broken, data is kept in a cache file, to be re-send the next run.Warning:WS-Shinken support isn’t finished.How to install ?You install as you wish, via sources, pip or Debian package.
If you use another distribution, you can use the Python package or contribute to publish a package for your distribution.DebianWe provide a Debian package source in thedebian/folder.Python packagepip install tantoUsageDefault config files location:/etc/tanto/Default cron file location:/etc/cron.d/Configure the nagios plugins you want to use ininputs/nagios_plugins.cfg:Define the nagios plugins path with thepathoption in[default_settings]section.The name of each section is the nagios plugin command.Each setting is a CLI option of the nagios plugin.Adapt the checks frequency in:/etc/cron.d/tanto.Standalone modeConfigure e-mail notifications inoutputs/email.cfg.With a monitoring serverConfigure passive checks on your monitoring system:Shinken(PDF)NagiosIcingaFill in the credidentials for your monitoring system inoutputs/nsca.cfgoroutputs/ws_shinken.cfg.CLI optionsLaunch:tanto –helpYou can override the location of each config file with a CLI parameter.DebugBy default, it uses cron syslog and console for the logs.
You can customize this behaviour inlogging.ini:http://docs.python.org/library/logging.config.html#configuration-file-formatSupportCommunity support is provided via Github:https://github.com/Eyepea/tanto/issuesYou must provide the error log with your issue.If you need professional support, please contact Eyepea:http://www.eyepea.eu/For general questions or contributions, you can contact me via my Github acccount:https://github.com/GMLudoSpecial thanksTheShinkencommunity in general, andJean Gabèsin particular for his help and support.Release History1.1 (2014-05-12)Add e-mail notifications for simple infrastructures without a monitoring server.Move config files ininput/andoutput/to be easier to understand.Reduce command line arguments for config files.1.0 (2014-05-06)Changenagios_plugins.cfgsyntax to give directly the command line to launch.Addserverslist parameter innagios_plugins.cfgto define the servers list that must receive configuration.Logging improvementsRenameeyepea_monitoring_agenttoTanto, a short blade in the same family asShinken.0.9 (2012-08-14)First public release.