{ "info": { "author": "Branko Toic", "author_email": "branko@toic.org", "bugtrack_url": null, "classifiers": [], "description": "ApTop\n=====\n\nApTop ia a top(1) alike monitoring utility for Apache.\n\nBeing daily involved in monitoring system load in shared environment I find it lacking proper tool for monitoring Apache behavior in real time. Granted there are some tools for this job, they are usually of limited options for some monitoring needs.\n\nApTop was written as a hobby project in python for debugging purposes while investigating several system load situations caused by web applications in shared hosting environment.\n\nApTop is still an early beta release with some known bugs, nevertheless it still provides a great starting point in monitoring Apache. Every feedback and feature request at this point is more than welcomed.\n\n\nDescription\n-----------\n\nApTop will show near real time Apache active working proceses and virtual host connections. By default sleeping / waiting for connections slots will be filtered out. \n\nApTop is also displaying several screens \n\n************************\nDashboard or Home screen\n************************\n\nThis screen displays some relevant informations gathered from `apache-status `_ page.\nIt is by default sorted by shortest last apache access time \"SS\" and it displays only active connections. Displayed fields are the same as in server-status page, so you can find detailed explanation for their meaning at the bottom of server-status page.\n\nDisplayed fields are:\n\nPID - OS process ID\nM - Mode of operation\nCPU - CPU usage, number of seconds\nSS - Seconds since beginning of most recent request<\nReq - Milliseconds required to process most recent request\nConn - Kilobytes transferred this connection\nAcc - Number of accesses this connection / this child / this slot\nClient - Remote client\nVHost - Local virtualhost\nRequest - Request method and partial URL\n\n**********************\nCount by vhosts screen\n**********************\n\nThis screen displays virtualhosts in order by highest count of active connections along with connection count.\n\nVery useful for detecting high traffic sites.\n\n***********************\nCount by clients screen\n***********************\n\nThis screen displays clients in order by highest count of active connections along with connection count.\n\nVery useful for detecting resource exhausters.\n\n\nRequirements\n------------\nApTop should work just fine on any unix based system with python standard\npackages and lxml.\n\nMake sure you have libxml2 libxslt libxslt-devel libxml2-devel packages instaleld\nprior to building lxml:\n\nFor RHEL based distro you can install those with\n\n::\n\n yum install libxml2 libxslt libxslt-devel libxml2-devel\n\nAfter that you can install lxml python package with **easy_install lxml** or **pip install lxml**\n\nApTop is using Apaches **mod_status** with **ExtendedStatus On** for gathering data.\nPlease ensure that **mod_status** is enabled and proper status url is defined in **aptop.conf**\nThere are some concernes regarding enabled ExtendedStatus On, but I think `this links `_ covers this nicely.\n\nInstalation\n-----------\n\nThese installation options are for RHEL based distros, adjust accordingly.\n\nyum install libxml2 libxslt libxslt-devel libxml2-devel python-setuptools\n\neasy_install ApTop\n\nor\n\neasy_install https://bitbucket.org/btoic/aptop/get/master.tar.gz\n\nYou can now run aptop.py\n\nConfiguration\n-------------\n\nApTop has some built in default configuration directives, but it will also look first in ~/.aptop.conf and than /etc/aptop.conf for overrides.\n\nApTop uses .ini style configuration files and main cofniguration options should be\nplaced after **[aptop]** section.\n\nBy default ApTop will use http://localhost/server-status url for grabbing \ndata to display, and with default refresh rate of 5 seconds.\n\n********************************\nAvailable configuration options:\n********************************\n\n status_url = URL\n\nThis configuration option will require you to enter valid mod_status status url\nfor server you wish to monitor.\nThis defaults to http://localhost/server-status\nNote that Apache should have ExtendedStatus conf option set to On\n\n refresh = seconds\n\nThis option will control ApTop default refresh interval. It defaults \nto 5 seconds and can't be lower than 1 second.\n\nYou can even monitor the remote systems if they granted you access rights to theirs server-status URL.\nIn the future ApTop will provide options to save remote monitored servers to its configuration.\n\nRuntime options\n---------------\n\nWhile running ApTop responds to following options:\n\n**H** - display main screen\n\n**V** - display vhosts by conn. count\n\n**C** - display clients by conn. count\n\n**U** - display count by url\n\n**R** - reverse the current sort order\n\n**I** - toggle active/inactive slots\n\n**D** - change the refresh rate\n\n**O** - change sort field\n\n**M** - filter methods\n\nAditional links\n---------------\n\nhttp://toic.org\n\nhttps://bitbucket.org/btoic/aptop\n", "description_content_type": null, "docs_url": "https://pythonhosted.org/aptop/", "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://bitbucket.org/btoic/aptop/get/master.tar.gz", "keywords": null, "license": "GPLv2", "maintainer": null, "maintainer_email": null, "name": "aptop", "package_url": "https://pypi.org/project/aptop/", "platform": "unix", "project_url": "https://pypi.org/project/aptop/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://bitbucket.org/btoic/aptop/get/master.tar.gz" }, "release_url": "https://pypi.org/project/aptop/0.3.2b/", "requires_dist": null, "requires_python": null, "summary": "ApTop is top like clone for apaache geting info from apache mod_status", "version": "0.3.2b" }, "last_serial": 1153281, "releases": { "0.2.1b": [ { "comment_text": "", "digests": { "md5": "483fc339abc5a57c8daaa1448739194f", "sha256": "110e9ae986cd3a3bdc4a90391f7b628e97b009b0750adf94703625f75f27fa52" }, "downloads": -1, "filename": "aptop-0.2.1b.tar.gz", "has_sig": false, "md5_digest": "483fc339abc5a57c8daaa1448739194f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4226, "upload_time": "2012-12-12T22:32:30", "url": "https://files.pythonhosted.org/packages/58/67/fea102df85e72b09eada3d560ecf7e249d04b89976bdafbf92f7e36aa1e1/aptop-0.2.1b.tar.gz" } ], "0.2.3b": [ { "comment_text": "", "digests": { "md5": "d31bcc2c1760a2a56b94581e10212968", "sha256": "05da944396cb4eabb8aa60419e3c8a017b9dbeb780bef6a3fc4522c28b21130e" }, "downloads": -1, "filename": "aptop-0.2.3b.tar.gz", "has_sig": false, "md5_digest": "d31bcc2c1760a2a56b94581e10212968", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4975, "upload_time": "2012-12-23T23:14:01", "url": "https://files.pythonhosted.org/packages/43/1f/fd5b64f0c4f34bdda24e8c128b1a98cf74c942ff59ea0d5ed8b7c1a3972e/aptop-0.2.3b.tar.gz" } ], "0.2.4b": [ { "comment_text": "", "digests": { "md5": "0c2bfdab19a523a0d59c7849fe2810a0", "sha256": "658bdcd7d66fe01d389a2a4407280afe3590d9ccd7f72d59929d774b7b1448bf" }, "downloads": -1, "filename": "aptop-0.2.4b.tar.gz", "has_sig": false, "md5_digest": "0c2bfdab19a523a0d59c7849fe2810a0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7096, "upload_time": "2014-02-28T15:21:18", "url": "https://files.pythonhosted.org/packages/30/c4/69770ed8233558c48535adfda2357ba4eea8aaea0bbbd664350934cd903b/aptop-0.2.4b.tar.gz" } ], "0.3.0b": [ { "comment_text": "", "digests": { "md5": "2c1d3b42cd39b65d7ca1a7b33cf6e91d", "sha256": "33d973a63592afe792b0e22d5fbb630befad93bac77cc9716348d5ef9ceb2996" }, "downloads": -1, "filename": "aptop-0.3.0b.tar.gz", "has_sig": false, "md5_digest": "2c1d3b42cd39b65d7ca1a7b33cf6e91d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8246, "upload_time": "2014-03-06T12:50:02", "url": "https://files.pythonhosted.org/packages/a4/08/249883758094c2fff75f33f018d231ca0f37140259bb22dca92eef5659d3/aptop-0.3.0b.tar.gz" } ], "0.3.1b": [ { "comment_text": "", "digests": { "md5": "c47a417bb50176922c89591fb9c78c1b", "sha256": "4b164c06543aed95860d4d9c988a1969ff99597594429b3fd790a5cab9ce735b" }, "downloads": -1, "filename": "aptop-0.3.1b.tar.gz", "has_sig": true, "md5_digest": "c47a417bb50176922c89591fb9c78c1b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8230, "upload_time": "2014-03-06T13:28:46", "url": "https://files.pythonhosted.org/packages/b4/4a/afb6d315177e2d990a6a2bedd868bd575bda209a6b055c5328df0968ccd8/aptop-0.3.1b.tar.gz" } ], "0.3.2b": [ { "comment_text": "", "digests": { "md5": "a683f70c3182304d29408a2354bc2f93", "sha256": "e3bc7cadf2d6fcb30a5bb6317d682c409eb7cd9019a12e66289bda0e04869a09" }, "downloads": -1, "filename": "aptop-0.3.2b.tar.gz", "has_sig": false, "md5_digest": "a683f70c3182304d29408a2354bc2f93", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8987, "upload_time": "2014-07-10T10:43:48", "url": "https://files.pythonhosted.org/packages/1d/ee/418df7b2cbd6350a397076ed019afbfc438edc66196ddf7c99dc2a066f5b/aptop-0.3.2b.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a683f70c3182304d29408a2354bc2f93", "sha256": "e3bc7cadf2d6fcb30a5bb6317d682c409eb7cd9019a12e66289bda0e04869a09" }, "downloads": -1, "filename": "aptop-0.3.2b.tar.gz", "has_sig": false, "md5_digest": "a683f70c3182304d29408a2354bc2f93", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8987, "upload_time": "2014-07-10T10:43:48", "url": "https://files.pythonhosted.org/packages/1d/ee/418df7b2cbd6350a397076ed019afbfc438edc66196ddf7c99dc2a066f5b/aptop-0.3.2b.tar.gz" } ] }