{ "info": { "author": "Ludovic Gasc", "author_email": "ludovic.gasc@eyepea.eu", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Environment :: No Input/Output (Daemon)", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU Affero General Public License v3", "Natural Language :: English", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: Implementation :: CPython", "Topic :: System :: Monitoring", "Topic :: System :: Networking :: Monitoring" ], "description": "Tanto\r\n=====\r\n\r\n- `Github repository `_\r\n- `PyPI page `_\r\n\r\nOverview\r\n--------\r\n\r\nTo monitor the servers with Shinken, Nagios or Icinga, system administrators usually configure active checks of the monitored servers.\r\nIt means the monitoring system must have a direct network access to the monitored server.\r\n\r\nWith **Tanto**, this model is reverted, it does passive checks of your monitored servers.\r\nYou don't need to open an access from your monitoring system to the monitored servers.\r\n\r\nThe 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.\r\nYou need only to open **NSCA** or **HTTP(S)** port from the monitored server to the monitoring system.\r\n\r\nMoreover, if you don't have a monitoring server, Tanto has a standalone mode.\r\nYou will receive alerts via e-mail directly.\r\n\r\nTechnical details\r\n`````````````````\r\n\r\nThe behaviour of this tool is simple:\r\n\r\n.. image:: https://raw.githubusercontent.com/Eyepea/tanto/master/docs/schema.png\r\n\r\n#. The program is started by cron.\r\n\r\n#. It retrieves monitoring data **(1)** from **nagios-plugins**.\r\n\r\n#. Finally, it pushes the data **(2)** via **NSCA** (Shinken, Nagios, Icinga), **HTTP(S)** (Shinken) to the monitoring server or via **SMTP**.\r\n\r\n#. (**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.\r\n\r\n**Warning:** WS-Shinken support isn't finished.\r\n\r\nHow to install ?\r\n----------------\r\n\r\nYou install as you wish, via sources, pip or Debian package.\r\nIf you use another distribution, you can use the Python package or contribute to publish a package for your distribution.\r\n\r\nDebian\r\n``````\r\n\r\nWe provide a Debian package source in the **debian/** folder.\r\n\r\nPython package\r\n``````````````\r\n\r\npip install tanto\r\n\r\nUsage\r\n-----\r\n\r\n- Default config files location: **/etc/tanto/**\r\n- Default cron file location: **/etc/cron.d/**\r\n\r\n#. Configure the nagios plugins you want to use in **inputs/nagios_plugins.cfg**:\r\n\r\n #. Define the nagios plugins path with the **path** option in **[default_settings]** section.\r\n\r\n #. The name of each section is the nagios plugin command.\r\n\r\n #. Each setting is a CLI option of the nagios plugin.\r\n\r\n#. Adapt the checks frequency in: **/etc/cron.d/tanto**.\r\n\r\nStandalone mode\r\n```````````````\r\n\r\n#. Configure e-mail notifications in **outputs/email.cfg**.\r\n\r\nWith a monitoring server\r\n````````````````````````\r\n\r\n#. Configure passive checks on your monitoring system:\r\n\r\n #. `Shinken `_\r\n\r\n #. (PDF) `Nagios `_\r\n\r\n #. `Icinga `_\r\n\r\n#. Fill in the credidentials for your monitoring system in **outputs/nsca.cfg** or **outputs/ws_shinken.cfg**.\r\n\r\n\r\nCLI options\r\n-----------\r\n\r\nLaunch: **tanto --help**\r\nYou can override the location of each config file with a CLI parameter.\r\n\r\nDebug\r\n-----\r\n\r\nBy default, it uses cron syslog and console for the logs.\r\nYou can customize this behaviour in **logging.ini**: http://docs.python.org/library/logging.config.html#configuration-file-format\r\n\r\nSupport\r\n-------\r\n\r\nCommunity support is provided via Github: https://github.com/Eyepea/tanto/issues\r\n\r\nYou must provide the error log with your issue.\r\n\r\nIf you need professional support, please contact Eyepea: http://www.eyepea.eu/\r\n\r\nFor general questions or contributions, you can contact me via my Github acccount: https://github.com/GMLudo\r\n\r\nSpecial thanks\r\n--------------\r\n\r\nThe **Shinken** community in general, and **Jean Gab\u00e8s** in particular for his help and support.\r\n\r\n.. :changelog:\r\n\r\nRelease History\r\n---------------\r\n\r\n1.1 (2014-05-12)\r\n````````````````\r\n\r\n- Add e-mail notifications for simple infrastructures without a monitoring server.\r\n- Move config files in **input/** and **output/** to be easier to understand.\r\n- Reduce command line arguments for config files.\r\n\r\n1.0 (2014-05-06)\r\n````````````````\r\n\r\n- Change **nagios_plugins.cfg** syntax to give directly the command line to launch.\r\n- Add **servers** list parameter in **nagios_plugins.cfg** to define the servers list that must receive configuration.\r\n- Logging improvements\r\n- Rename **eyepea_monitoring_agent** to **Tanto**, a short blade in the same family as **Shinken**.\r\n\r\n0.9 (2012-08-14)\r\n````````````````\r\n\r\nFirst public release.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Eyepea/tanto", "keywords": "", "license": "GNU Affero General Public License v3", "maintainer": "", "maintainer_email": "", "name": "tanto", "package_url": "https://pypi.org/project/tanto/", "platform": "UNIX", "project_url": "https://pypi.org/project/tanto/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/Eyepea/tanto" }, "release_url": "https://pypi.org/project/tanto/1.1/", "requires_dist": null, "requires_python": null, "summary": "Takes monitoring data from Nagios-plugins to push with NSCA (Nagios or Icinga) or WS-Shinken.", "version": "1.1" }, "last_serial": 5606317, "releases": { "1.1": [ { "comment_text": "", "digests": { "md5": "480a1549803eb96cf221847ac10c6d3b", "sha256": "c999fe241eaf9dcd402c2fb34ba0cb4f3ba6d8fe9b5f42f384d950072722c919" }, "downloads": -1, "filename": "tanto-1.1.tar.gz", "has_sig": false, "md5_digest": "480a1549803eb96cf221847ac10c6d3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26093, "upload_time": "2014-05-29T20:37:32", "url": "https://files.pythonhosted.org/packages/66/e9/29b47a6f26c5257d569ae5fd1c20f740ce914b3dff097dfb79fda0876871/tanto-1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "480a1549803eb96cf221847ac10c6d3b", "sha256": "c999fe241eaf9dcd402c2fb34ba0cb4f3ba6d8fe9b5f42f384d950072722c919" }, "downloads": -1, "filename": "tanto-1.1.tar.gz", "has_sig": false, "md5_digest": "480a1549803eb96cf221847ac10c6d3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26093, "upload_time": "2014-05-29T20:37:32", "url": "https://files.pythonhosted.org/packages/66/e9/29b47a6f26c5257d569ae5fd1c20f740ce914b3dff097dfb79fda0876871/tanto-1.1.tar.gz" } ] }