{ "info": { "author": "Jean-Philippe Camguilhem", "author_email": "pypi@camguilhem.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Plugins", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: BSD License", "Operating System :: POSIX :: BSD :: OpenBSD", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Monitoring" ], "description": "\n\n==========================================================\nCheck OpenBGPD Nagios|Icinga|shinken|etc plugin.\n==========================================================\n\n.. image:: https://img.shields.io/pypi/l/checkopenbgpd.svg\n :target: https://pypi.python.org/pypi/checkopenbgpd/\n\n.. image:: https://img.shields.io/pypi/implementation/checkopenbgpd.svg\n :target: https://pypi.python.org/pypi/checkopenbgpd/\n\n.. image:: https://img.shields.io/pypi/pyversions/checkopenbgpd.svg\n :target: https://pypi.python.org/pypi/checkopenbgpd/\n\n.. image:: https://img.shields.io/pypi/v/checkopenbgpd.svg\n :target: https://pypi.python.org/pypi/checkopenbgpd/\n\n.. image:: https://img.shields.io/pypi/status/checkopenbgpd.svg\n :target: https://pypi.python.org/pypi/checkopenbgpd/\n\n.. image:: https://img.shields.io/coveralls/jpcw/checkopenbgpd.svg\n :target: https://coveralls.io/r/jpcw/checkopenbgpd\n\n.. image:: https://api.travis-ci.org/jpcw/checkopenbgpd.svg?branch=master\n :target: http://travis-ci.org/jpcw/checkopenbgpd\n\n\n+ Source: https://github.com/jpcw/checkopenbgpd\n\n+ Bugtracker: https://github.com/jpcw/checkopenbgpd/issues\n\n.. contents::\n\nusage\n-------\n\nThis check runs **bgpctl show** and checks that all bgp sessions are up.\n\n\nsample outputs :\n\n+ Ok\n\n::\n\n $ check_openbgpd \n CHECKBGPCTL OK - All bgp sessions in correct state | 'PEER-1'=529581;;;0 \n\nSometimes you have some peer sessions in ignore state, and it 's not critical. Typically a session which depends on a slave carp interface. You have an option '--ignore-list', the plugin will take care if the session is in this list, and returns an 'OK' state for this session.\n\n::\n\n $ check_openbgpd --ignore-list PEER-2 OTHER-PEER\n CHECKBGPCTL OK - All bgp sessions in correct state | 'PEER-1'=529581;;;0 'PEER-2'=0;;;0 'OTHER-PEER'=0;;;0\n\n\n\n+ Critical\n\nCritical state is reached with first ignore session not escaped in the optionnal '--ignore-list' \n\n::\n\n $ check_openbgpd\n CHECKBGPCTL CRITICAL - OTHER-PEER is U (outside range 0:) | 'PEER-1'=529918;;;0 'OTHER-PEER'=U;;;0\n\n\n+ Unknown\n\nif an error occured during the check, the plugin raises a check error, which returns an UNKNOWN state.\n\ntypically UNKNOWN causes\n\n + OpenBGPD is not running \n\n ::\n\n CHECKBGPCTL UNKNOWN - host.domain.tld bgpctl: connect: /var/run/bgpd.sock: No such file or directory\n\n + you're not in the wheel group, and can't read the bgpctl sosk \n\n ::\n\n CHECKBGPCTL UNKNOWN - host.domain.tld bgpctl: connect: /var/run/bgpd.sock: Permission denied \n\n doas is your friend to run this plugin with an unprivileged user. A sample config here \n\n ::\n\n permit nopass icinga as root cmd /usr/local/bin/check_openbgpd\n\n\nInstall\n------------\n\nextract the tarball and :: \n\n python setup.py install\n\nMaybe you have installed setuptools with ::\n\n pkg_add py-setuptools\n\nthen just ::\n\n easy_install checkopenbgpd\n\ncheck_openbgpd is located at /usr/local/bin/check_openbgpd\n\n\nNagios|icinga like configuration\n-----------------------------------\n\ncheck_openbgpd could be called localy or remotely via check_by_ssh or NRPE.\n\n**check_by_ssh**\n\nhere a sample definition to check remotely by ssh \n\nCommand definition ::\n\n define command{\n command_name check_ssh_bgpctl\n command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -i /var/spool/icinga/.ssh/id_rsa -C \"sudo /usr/local/bin/check_openbgpd --ignore-list $ARG1$\"\n }\n\nthe service itself ::\n\n define service{\n use my-service\n host_name hostname\n service_description bgpctl\n check_command check_ssh_bgpctl!\n }\n\nicinga2 command ::\n\n\tobject CheckCommand \"openbgpd\" {\n import \"plugin-check-command\"\n import \"ipv4-or-ipv6\"\n command = [ PluginDir + \"/check_by_ssh\" ]\n arguments = {\n \"-H\" = \"$openbgpd_address$\"\n \"-i\" = \"$ssh_id$\"\n \"-p\" = \"$ssh_port$\"\n \"-C\" = \"$ssh_command$\"\n \t }\n vars.openbgpd_address = \"$check_address$\"\n vars.ssh_id = \"/var/spool/icinga/.ssh/id_rsa\"\n vars.ssh_port = \"$vars.ssh_port$\"\n vars.ssh_command = \"sudo /usr/local/bin/check_openbgpd\"\n\t}\n\nicinga2 service ::\n\n\tapply Service \"openbgpd\" {\n \t check_command = \"openbgpd\"\n \t assign where host.name == \"hostname\"\n\t}\n\n**NRPE**\n\nadd this line to /usr/local/etc/nrpe.cfg ::\n\n ...\n command[check_openbgpd]=/usr/local/bin/check_openbgpd\n ...\n\nnagios command definition ::\n\n define command{\n command_name check_nrpe_bgpctl\n command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c check_openbgpd -a \"--ignore-list $ARGS1\"\n }\n\nthe service itself ::\n\n define service{\n use my-service\n host_name hostname\n service_description bgpctl\n check_command check_nrpe_bgpctl!\n } \n\ntesting\n---------\n::\n\n python bootstrap-buildout.py --setuptools-version=33.1.1 --buildout-version=2.5.2\n bin/buildout -N\n bin/test\n\n\n\nChangelog\n=========\n\n\n0.10 (2018-01-20)\n-----------------\n\n- replace --idle-list with a more permissive --ignore-list https://github.com/jpcw/checkopenbgpd/issues/5\n- fix broken Python3 https://github.com/jpcw/checkopenbgpd/issues/4\n\n\n0.9 (2017-03-07)\n----------------\n\n- fix session with max-prefix https://github.com/jpcw/checkopenbgpd/issues/3\n\n thanks drustan for bug report\n\n thanks Dam64 which up a session with max-prefix for tests and debug\n\n\n0.8 (2016-04-15)\n----------------\n\n- python3.5 support\n\n\n0.7 (2015-04-12)\n----------------\n\n- fix 'idle' breaks performance data rendering https://github.com/jpcw/checkopenbgpd/issues/1\n\n\n0.6 (2015-04-09)\n----------------\n\n- improve summary\n\n0.5\n----------------\n\n- Fix Cosmetics on README\n\n0.1 (2015-04-09)\n----------------\n\n- Jean-Philippe Camguilhem \n\n\nContributors\n==============\n\nJean-Philippe Camguilhem, Author\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jpcw/checkopenbgpd/", "keywords": "Nagios Icinga plugin check openbgpd openbsd monitoring", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "checkopenbgpd", "package_url": "https://pypi.org/project/checkopenbgpd/", "platform": "any", "project_url": "https://pypi.org/project/checkopenbgpd/", "project_urls": { "Homepage": "https://github.com/jpcw/checkopenbgpd/" }, "release_url": "https://pypi.org/project/checkopenbgpd/0.10/", "requires_dist": [ "nagiosplugin", "mock; extra == 'test'", "setuptools; extra == 'test'" ], "requires_python": "", "summary": "Check OpenBGPD sessions Nagios|Icinga|shinken|etc plugin", "version": "0.10" }, "last_serial": 3507226, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "57a03b1be19c6c113d9254ccdca7d76d", "sha256": "b4f570b02e3e18d58159c2abf4773e53cf10e5b0956207a20883d3c854142182" }, "downloads": -1, "filename": "checkopenbgpd-0.1.zip", "has_sig": false, "md5_digest": "57a03b1be19c6c113d9254ccdca7d76d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14200, "upload_time": "2015-04-09T17:03:35", "url": "https://files.pythonhosted.org/packages/4a/92/f15fd25027c797b01ed6a8dcff56b45fbd042580d452e034c48a557b930c/checkopenbgpd-0.1.zip" } ], "0.10": [ { "comment_text": "", "digests": { "md5": "9e47a0556a9851e278ddb4a15b71492e", "sha256": "e44a0579ecfb428f46cc03ee0009bd08822acb1f76fa6aecc95fe803fa02e16e" }, "downloads": -1, "filename": "checkopenbgpd-0.10-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9e47a0556a9851e278ddb4a15b71492e", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 9836, "upload_time": "2018-01-20T15:41:06", "url": "https://files.pythonhosted.org/packages/3e/09/c4c0d183ede44f6ef23745cbbd29d103f40b63d5edfb928f398fe65f6f8c/checkopenbgpd-0.10-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c4473041b9086833169516a9e268aa1", "sha256": "67d8cecb2d48a08ac0c9484f4cb2c76c318cca4a421a9e581e5a6a2de6308928" }, "downloads": -1, "filename": "checkopenbgpd-0.10.tar.gz", "has_sig": false, "md5_digest": "7c4473041b9086833169516a9e268aa1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9470, "upload_time": "2018-01-20T15:41:09", "url": "https://files.pythonhosted.org/packages/ca/44/b386e526b271187be4502be1c912d74fe67803541a2eaaac73eff9357eba/checkopenbgpd-0.10.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "3857b25780ed58f02f600c23a67cb81f", "sha256": "10034e33e3ae6f81d6ad2554d64a08380f1b4216d8d6f49e9d1b11529f9aeace" }, "downloads": -1, "filename": "checkopenbgpd-0.2.zip", "has_sig": false, "md5_digest": "3857b25780ed58f02f600c23a67cb81f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14253, "upload_time": "2015-04-09T17:33:06", "url": "https://files.pythonhosted.org/packages/a6/43/cd1fb112f0cf8267a21f72a578e06274f91869c8fc4326fc2649f159fd65/checkopenbgpd-0.2.zip" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "ae4df1d6887f2f6b54e4693d005e37c0", "sha256": "a0932fab4acd59b3483ca879fb01a9789576d4e5d948a1178658138a67bc1f10" }, "downloads": -1, "filename": "checkopenbgpd-0.5.zip", "has_sig": false, "md5_digest": "ae4df1d6887f2f6b54e4693d005e37c0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14307, "upload_time": "2015-04-09T17:41:31", "url": "https://files.pythonhosted.org/packages/63/ac/41586d78ae5e737741b736d29365ca6b78c15b110b24ea1946c3c83f1f5a/checkopenbgpd-0.5.zip" } ], "0.6": [ { "comment_text": "", "digests": { "md5": "6ce0605f57135d1e63ebdc3f59b71fde", "sha256": "7bd096916b767cc69932446f494502ba8a976a65ad0df76d7af7d35d889601d9" }, "downloads": -1, "filename": "checkopenbgpd-0.6.zip", "has_sig": false, "md5_digest": "6ce0605f57135d1e63ebdc3f59b71fde", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14597, "upload_time": "2015-04-09T19:43:49", "url": "https://files.pythonhosted.org/packages/7e/b5/b03a48bdeda3bd0478fb3469342a8a33fa2fa4c0bd6f75ebd37623cf496e/checkopenbgpd-0.6.zip" } ], "0.7": [ { "comment_text": "", "digests": { "md5": "40ac6fc9c89eed36241f93fcaa10b65a", "sha256": "8624057e8fb0280243ade5c5100af8bd5f0a58bbf2efaea0ec540fbd867c80ad" }, "downloads": -1, "filename": "checkopenbgpd-0.7.zip", "has_sig": false, "md5_digest": "40ac6fc9c89eed36241f93fcaa10b65a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14769, "upload_time": "2015-04-12T09:30:13", "url": "https://files.pythonhosted.org/packages/ae/8d/84c3da03fb7414572ea15e375c4dc1e4399b95deef8ae1f64f0d953d3aab/checkopenbgpd-0.7.zip" } ], "0.8": [ { "comment_text": "", "digests": { "md5": "52e5caf46cc61294abb34cb999327906", "sha256": "f54782e47fceeb7f4edd926b7769c0c696f757ebb4a6b88c028e559af2e06bde" }, "downloads": -1, "filename": "checkopenbgpd-0.8.zip", "has_sig": false, "md5_digest": "52e5caf46cc61294abb34cb999327906", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14724, "upload_time": "2016-04-15T06:02:30", "url": "https://files.pythonhosted.org/packages/e9/5e/85282a14f6aea8c660aa6d08e2d5c89461f74ba89a492aef1bb6bd00dbcf/checkopenbgpd-0.8.zip" } ], "0.9": [ { "comment_text": "", "digests": { "md5": "29a3cddcb359f4e17cc3a2410ed48cfa", "sha256": "c36cef3212648296056a05167fc2e28113c1bcf83f110a08dde4f35f2f54e9d9" }, "downloads": -1, "filename": "checkopenbgpd-0.9.tar.gz", "has_sig": false, "md5_digest": "29a3cddcb359f4e17cc3a2410ed48cfa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9968, "upload_time": "2017-03-06T23:40:51", "url": "https://files.pythonhosted.org/packages/68/33/4a3b54d44b473e6540d9120cd81cf9c8a07f99031abb2372a6e6dead7e4a/checkopenbgpd-0.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9e47a0556a9851e278ddb4a15b71492e", "sha256": "e44a0579ecfb428f46cc03ee0009bd08822acb1f76fa6aecc95fe803fa02e16e" }, "downloads": -1, "filename": "checkopenbgpd-0.10-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9e47a0556a9851e278ddb4a15b71492e", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 9836, "upload_time": "2018-01-20T15:41:06", "url": "https://files.pythonhosted.org/packages/3e/09/c4c0d183ede44f6ef23745cbbd29d103f40b63d5edfb928f398fe65f6f8c/checkopenbgpd-0.10-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c4473041b9086833169516a9e268aa1", "sha256": "67d8cecb2d48a08ac0c9484f4cb2c76c318cca4a421a9e581e5a6a2de6308928" }, "downloads": -1, "filename": "checkopenbgpd-0.10.tar.gz", "has_sig": false, "md5_digest": "7c4473041b9086833169516a9e268aa1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9470, "upload_time": "2018-01-20T15:41:09", "url": "https://files.pythonhosted.org/packages/ca/44/b386e526b271187be4502be1c912d74fe67803541a2eaaac73eff9357eba/checkopenbgpd-0.10.tar.gz" } ] }