{ "info": { "author": "Andrew Mleczko", "author_email": "andrew.mleczko@redturtle.it", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Framework :: Plone", "Framework :: ZODB", "Framework :: Zope2", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License (GPL)", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Networking :: Monitoring" ], "description": "History\n-------\n\nThis package was originally started as `redturtle.munin`_ by RedTurtle Technology.\nFrom 1.1a1 we have move development to `munin.zope`_ leaving some free place \nfor other munin plugins.\n \n \nIntroduction\n------------\n\nThis package provides munin plugins for monitoring various aspects of a Zope\ninstance.\n\nIt uses `gocept.munin`_ for plugin registration. Please refer to its\ndocumentation if you want to write new plugins.\n\nBits of the code is based on plugins found at `munin exchange`_ (many thanks\nto Gaute Amundsen and Arthur Lutz).\n\n\nPlugins\n-------\n\nCurrently there are 4 plugins available:\n\n* \"zopethreads\" - reports free Zope threads\n* \"zopecache\" - reports database cache parameters\n* \"zodbactivity\" - reports ZODB activity\n* \"zopememory\" - reports Zope memory usage (only works on Linux)\n\n\nHow to use it\n-------------\n\n* First include the package in your buildout `instance` slot::\n\n [instance]\n ...\n eggs =\n ...\n munin.zope\n zcml =\n ...\n munin.zope\n\n* If you use z3c.autoinclude and plone (default from Plone 3.3.x),\n you need only eggs stuff::\n\n [instance]\n ...\n eggs =\n ...\n munin.zope\n\n* To create the pluging helper script you'll also need to include the\n following, additional section and extend your `parts` definition::\n\n [buildout]\n parts =\n ...\n munin\n\n [munin]\n recipe = zc.recipe.egg\n eggs = munin.zope\n arguments = http_address='${instance:http-address}', user='${instance:user}'\n\n The `arguments` option is used to pass configuration values to the generated\n helper script, which is then used as the actual munin plugin (see below).\n Any settings for `ip-address`, `http-address`, `port-base` and `user` given\n in the `instance` section should be repeated here, separated by commas.\n\n .. |---| unicode:: U+2014 .. em dash\n\n Please be aware, that the variable names use underscores instead of dashes\n here |---| the following list shows all supported settings and their\n respective default values:\n\n * ip_address='' ['localhost']\n * http_address= [8080]\n * port_base= [0]\n * user= [n.a.]\n\n Either literal values or references to the `instance` part can be used here,\n i.e. \"http_address='${instance:http-address}', user='${instance:user}'\".\n Please note that the resulting line will be verbosely copied into the\n generated `bin/munin` script, so the extra quoting is required.\n\n* When monitoring more than one Zope instance, i.e. in a ZEO setup, separate\n helper scripts need to be generated. In order to do so the `scripts`\n option of `zc.recipe.egg` can be used like so::\n\n [buildout]\n parts =\n ...\n munin1\n munin2\n\n [munin1]\n recipe = zc.recipe.egg\n eggs = munin.zope\n scripts = munin=munin1\n arguments = http_address='${instance1:http-address}', user='${instance1:user}'\n\n [munin2]\n recipe = zc.recipe.egg\n eggs = munin.zope\n scripts = munin=munin2\n arguments = http_address='${instance2:http-address}', user='${instance2:user}'\n\n The necessary symlinks can then be created with each of the scripts in turn\n (see below). Please note, that in this case you should explicitly provide\n at least a differing `prefix` argument.\n\n* Now you should be able to call the plugins as follow::\n\n http://localhost:8080/@@munin.zope.plugins/zopethreads\n\n Where `zopethreads` is you plugin name.\n\n* Next you need to make symlinks from the helper script inside your\n buildout's `bin/` to the munin plugin directory. The helper script itself\n can assist you with this::\n\n $ bin/munin install /opt/munin/etc/plugins [] []\n\n This will install the necessary symlinks in the given directory using\n either the provided prefix and suffix or else the hostname and current\n directory to assemble their names (see below).\n\n Alternatively, you may also install the desired symlinks yourself::\n\n $ cd /opt/munin/etc/plugins\n $ ln -s ~/zope/bin/munin company_zodbactivity_site1\n\n Here `/opt/munin/etc/plugins` is your munin directory, `~/zope/` is the\n root directory of your buildout, `zodb_activity` the name of the plugin\n you want to enable, `company` a placeholder for an arbitrary prefix and\n `site1` the name which will be shown in munin.\n\n* Finally configure the plugin in munin (this step can be skipped if you have\n correctly set up the `arguments` option as described in step 2 above)::\n\n $ cd /opt/munin/etc/plugin-conf.d/\n $ vi munin.zope.conf\n ... [company_*_site1]\n ... env.AUTH myuser:myuser\n ... env.URL http://localhost:8080/@@munin.zope.plugins/%s\n\n Here `myuser:myuser` are your Zope user credentials and `localhost:8080`\n your site url. Please check `munin`_ for more information about plugin\n configuration.\n\nMultiple zodb storage\n---------------------\n\nIf you have multiple zodb storage, you can manage it adding ``filestorage`` parameter\nto the scripts using ``initFilestorages`` helper function, like so::\n\n [munin]\n recipe = zc.recipe.egg\n eggs = munin.zope\n initialization =\n from munin.zope.plugins import initFilestorages\n initFilestorages(['catalog', 'other'])\n\nOr whith c.r.filestorage::\n\n [filestorage]\n recipe = collective.recipe.filestorage\n parts =\n catalog\n other\n\n [munin]\n recipe = zc.recipe.egg\n eggs = munin.zope\n initialization =\n from munin.zope.plugins import initFilestorages\n initFilestorages(\"\"\"${filestorage:parts}\"\"\".split())\n arguments = http_address='${instance:http-address}', user='${instance:user}'\n\nSecurity\n--------\nFor security reasons the views requires the `View management screens` permission...\n\n... or you can use a shared secret on the request, you must configure the shared key on\nzope.conf adding a stanza like::\n\n \n secret yoursecrethere\n \n\nOn your buildout `instance` slot::\n\n zope-conf-additional +=\n \n secret yoursecrethere\n \n\nSo you can make a request without authentication, using the secret, like::\n\n http://localhost:8080/@@munin.zope.plugins/zopethreads?secret=yoursecrethere\n\nYou can also pass in the secret in the munin helper script::\n\n [munin3]\n recipe = zc.recipe.egg\n eggs = munin.zope\n scripts = munin=munin3\n arguments = http_address='${instance2:http-address}', secret='mylittlesecret'\n\nPlease note that, for `zopethreads`, you need to use the `secret` approach.\n\nReferences\n----------\n\n* `munin.zope`_ at pypi\n* `gocept.munin`_ at pypi\n* `redturtle.munin`_ at pypi\n* `munin`_ project\n* `munin exchange`_\n\n .. _munin.zope: http://pypi.python.org/pypi/munin.zope/\n .. _gocept.munin: http://pypi.python.org/pypi/gocept.munin/\n .. _munin exchange: http://muninexchange.projects.linpro.no/\n .. _munin: http://munin.projects.linpro.no/\n .. _redturtle.munin: http://pypi.python.org/pypi/redturtle.munin/\n\nContact\n-------\n\n.. image:: http://www.redturtle.it/redturtle_banner.png\n\n* | Andrew Mleczko <``andrew.mleczko at redturtle.net``>\n | **RedTurtle Technology**, http://www.redturtle.net/\n\n* | Andreas Zeidler <``az at zitc.de``>\n | **ZITC**, http://zitc.de/\n\n* | Mauro Amico <``mauro at biodec.com``>\n | **Biodec**, http://www.biodec.com/\n\n* | Leonardo Rochael Almeida <``leorochael@gmail.com``>\n | **Simples Consultoria**, http://www.simplesconsultoria.com.br/\n\nChangelog\n=========\n\n2.1 (2014-09-17)\n----------------\n\n- Added helper function initFilestorages for manage multiple zodb storages\n (zodbactivity, zopecache plugins) [mauro]\n\n\n2.0 (2013-02-05)\n----------------\n\n- Fix `zopethreads` count, and make it not skew its own count of free threads.\n Bumping version, as `zopethreads` is no longer accessible through\n authenticated access, only through \"secret\" configuration. [leorochael]\n\n\n1.3.3 (2012-12-17)\n------------------\n\n- fix totalthread for zeo client/server setup [mauro]\n\n1.3.2 (2012-08-07)\n------------------\n\n- Allow passing the secret in the bin/munin script as well [fredvd]\n\n- Added testrunner for Plone 4.2 [fredvd]\n\n- updated bootstrap.py for distribute compat. [fredvd]\n\n- Manage multiple filestorage (zodbactvity, zopecache plugins) [mauro]\n\n1.3.1 (2012-03-15)\n------------------\n- Fixed egg build: was missing ZCML & docs [mitchellrj]\n\n1.3 (2012-03-08)\n----------------\n* z3c.autoinclude with plone target [mamico]\n* Make use of shared secret for authentication [mamico]\n\n1.2 - 2011/04/28\n----------------\n* Remove threadframe dependency on python >= 2.5 [amleczko]\n\n1.1 - 2010/02/25\n----------------\n\n* Change restrictedTraverse to unrestrictedTraverse in data fetching.\n [amleczko]\n\n\n1.1a1 - 2009/08/13\n------------------\n\n* Change the package name to munin.zope [amleczko]\n\n\n1.0a2 - 2009/07/27\n------------------\n\n* Fix dimension for memory usage plugin.\n [witsch]\n\n* Add info about monitoring more than one instance, e.g. a ZEO setup.\n [witsch]\n\n* Allow overriding the default prefix/suffix when setting up plugin links.\n [witsch]\n\n\n1.0a1 - 2009/07/17\n------------------\n\n* Add script option to automatically setup symlinks for all available\n plugins in the munin plugin directory.\n [witsch]\n\n* Add plugin to track zope's memory usage (only available on Linux).\n [witsch]\n\n* Add logging of slow plugin execution as a safety net.\n [witsch]\n\n* Allow setting of necessary configuration values directly in buildout.\n [witsch]\n\n* Refactor and try to simplify things.\n [witsch]\n\n\n0.0.3 - 2009/03/30\n------------------\n\n* Add documentation.\n [amleczko]\n\n* Refactor plugin registration.\n [amleczko]\n\n\n0.0.2 - 2009/03/26\n------------------\n\n* Small refactoring.\n [amleczko]\n\n\n0.0.1 - 2009/03/24\n------------------\n\n* Initial release.\n [amleczko]", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://plone.org/products/munin.zope", "keywords": "plone zope munin monitoring", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "munin.zope", "package_url": "https://pypi.org/project/munin.zope/", "platform": "Any", "project_url": "https://pypi.org/project/munin.zope/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://plone.org/products/munin.zope" }, "release_url": "https://pypi.org/project/munin.zope/2.1/", "requires_dist": null, "requires_python": null, "summary": "Munin plugins for Zope/Plone.", "version": "2.1" }, "last_serial": 1227910, "releases": { "1.1": [ { "comment_text": "", "digests": { "md5": "9a729a3f79fc8ba282596094cc39991a", "sha256": "701ca3090a1861bdd2a833143b45f7303a57c60931305e97584347e17f9d2e60" }, "downloads": -1, "filename": "munin.zope-1.1.tar.gz", "has_sig": false, "md5_digest": "9a729a3f79fc8ba282596094cc39991a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12098, "upload_time": "2011-05-31T17:51:25", "url": "https://files.pythonhosted.org/packages/32/78/1a4b7495fedbd639c4bb10ffab904718beb56f5b027637e802443106a4b2/munin.zope-1.1.tar.gz" } ], "1.1a1": [ { "comment_text": "", "digests": { "md5": "ce8bd6ca2629261e903430e5f85b3198", "sha256": "28174ecd9c397dfba9b8948f9c9f3b055e89cf7026f7aadfa8bf2deeb5d4f251" }, "downloads": -1, "filename": "munin.zope-1.1a1.tar.gz", "has_sig": false, "md5_digest": "ce8bd6ca2629261e903430e5f85b3198", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12033, "upload_time": "2011-09-15T15:42:12", "url": "https://files.pythonhosted.org/packages/54/f2/f62495d8d3acbe109fe199a48b66c8872c9339ee06052150d5851a622e2d/munin.zope-1.1a1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "76a0291bc623ef66a2774eab937fe0a7", "sha256": "d87d55b6a8c0f2a479a41c2104b67b01b73f68761771d1ea7032ecb2f86b5089" }, "downloads": -1, "filename": "munin.zope-1.2.tar.gz", "has_sig": false, "md5_digest": "76a0291bc623ef66a2774eab937fe0a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11578, "upload_time": "2011-04-28T11:18:17", "url": "https://files.pythonhosted.org/packages/f7/2a/778ac1713ef01d5506137cde03644255acea62779d2f29ed1455f6c0eb3e/munin.zope-1.2.tar.gz" } ], "1.3": [ { "comment_text": "", "digests": { "md5": "00abb11388e68a1a87cc52eedc3f0c58", "sha256": "1686c9b243315f8aeb1323fcaefb048d8765aed5b512ef35e4c6fdba771d1200" }, "downloads": -1, "filename": "munin.zope-1.3.tar.gz", "has_sig": false, "md5_digest": "00abb11388e68a1a87cc52eedc3f0c58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7908, "upload_time": "2012-03-08T14:32:52", "url": "https://files.pythonhosted.org/packages/9c/e9/bf3f21c135662e602ddbdf7e1674f41f98e00a2e6c0cb7443da8a4e5487f/munin.zope-1.3.tar.gz" } ], "1.3.1": [ { "comment_text": "", "digests": { "md5": "35fca27b82d364370f831372fcec054f", "sha256": "500a66426743c10f0ad30ced256670b73c3038c7f26351c529e448d429766a7d" }, "downloads": -1, "filename": "munin.zope-1.3.1.tar.gz", "has_sig": false, "md5_digest": "35fca27b82d364370f831372fcec054f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10140, "upload_time": "2012-03-15T21:09:40", "url": "https://files.pythonhosted.org/packages/ef/1f/6f9b18567bd2c830966e60a11704809c8581ddb0a3abe88fb66010571508/munin.zope-1.3.1.tar.gz" } ], "1.3.2": [ { "comment_text": "", "digests": { "md5": "886210974defa70f976f5954db622def", "sha256": "b407d264349c4234de0f3cfd4a96f52ec146d6ce7f0d6ca3b17b43672d42c824" }, "downloads": -1, "filename": "munin.zope-1.3.2.zip", "has_sig": false, "md5_digest": "886210974defa70f976f5954db622def", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19210, "upload_time": "2012-08-07T18:46:41", "url": "https://files.pythonhosted.org/packages/aa/b6/1c1f919004c9fb62e8229ef3bee37f3902127e0e737340363a7698768bfa/munin.zope-1.3.2.zip" } ], "1.3.3": [ { "comment_text": "", "digests": { "md5": "8d375c10e058051558e2fdbc5f1e4763", "sha256": "6eedd6d3f872944419724368582c71391a9eb0807a3ee2d83367c1da81ae3761" }, "downloads": -1, "filename": "munin.zope-1.3.3.zip", "has_sig": false, "md5_digest": "8d375c10e058051558e2fdbc5f1e4763", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19318, "upload_time": "2012-12-17T08:32:03", "url": "https://files.pythonhosted.org/packages/3c/27/e0fba18f13330eaea7087d16e390a6bbe97c250b1d32319c7689229e8724/munin.zope-1.3.3.zip" } ], "2.0": [ { "comment_text": "", "digests": { "md5": "ebd8d5304a630ab7ae46a75d01465971", "sha256": "699949ee62a0f38e3334eb7d314acfa17fe28eca4079afa452f0a6f30f09c16c" }, "downloads": -1, "filename": "munin.zope-2.0.zip", "has_sig": false, "md5_digest": "ebd8d5304a630ab7ae46a75d01465971", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21547, "upload_time": "2013-02-05T12:10:36", "url": "https://files.pythonhosted.org/packages/b3/0c/18ee0452146a5d6bdea97012b4db1c8013c329c3cae81d27d687a222fe36/munin.zope-2.0.zip" } ], "2.1": [ { "comment_text": "", "digests": { "md5": "986cfc9285cf5cdc7475c4f8221e1712", "sha256": "f41908b88f9bef8b0f2bcb1816217f7c659398526ef6f90c54e45f02e75fde49" }, "downloads": -1, "filename": "munin.zope-2.1.zip", "has_sig": false, "md5_digest": "986cfc9285cf5cdc7475c4f8221e1712", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22512, "upload_time": "2014-09-17T12:05:15", "url": "https://files.pythonhosted.org/packages/57/e3/0e6aa4f95fd02be2538b9a1397379909fe950e1d477f779089b4798e3380/munin.zope-2.1.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "986cfc9285cf5cdc7475c4f8221e1712", "sha256": "f41908b88f9bef8b0f2bcb1816217f7c659398526ef6f90c54e45f02e75fde49" }, "downloads": -1, "filename": "munin.zope-2.1.zip", "has_sig": false, "md5_digest": "986cfc9285cf5cdc7475c4f8221e1712", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22512, "upload_time": "2014-09-17T12:05:15", "url": "https://files.pythonhosted.org/packages/57/e3/0e6aa4f95fd02be2538b9a1397379909fe950e1d477f779089b4798e3380/munin.zope-2.1.zip" } ] }