{ "info": { "author": "Walter Doekes, OSSO B.V.", "author_email": "wjdoekes+proxtop@osso.nl", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Topic :: System :: Monitoring" ], "description": "proxtop :: Proxmox resource monitor\n===================================\n\n|pypi_version| |pypi_downloads|\n\nProxtop lists the top resource consumers of your Proxmox VM platform.\n\nIt will list columns of the top users of these resources:\n * cpu\n * diskread\n * diskwrite\n * netin\n * netout\n\n*IMPORTANT CHANGES IN proxtop 0.3.0:*\n\n* Shows only one of AVERAGE, MEDIAN, MAX now. See the -g option.\n* The --partial-match option has been removed in favor of globbing\n (e.g. ``*server-name*``).\n* The default output is now MEDIAN.\n\n*IMPORTANT CHANGES IN proxtop 0.2.0:*\n\n* The default port is now 443. This was tested with Proxmox 4.0-57.\n If you want the old default port 8006 back, you may append \":8006\"\n to the hostname.\n* The VM container type is now used in the REST path: i.e. ``/qemu/``\n (or lxc) instead of ``/openvz/``.\n\n\nQuick jump\n----------\n\n* `Installation`_\n* `Example`_\n* `License`_\n* `Future`_\n\n\n\nInstallation\n------------\n\nVia pip:\n\n.. code-block:: console\n\n $ pip install proxtop\n\nVia git:\n\n.. code-block:: console\n\n $ pip install proxmoxer # tested with 0.1.7 and 0.2.0\n $ pip install requests # tested with 2.2.1 and 2.5.3\n $ git clone https://github.com/ossobv/proxtop.git\n $ cd proxtop\n $ python setup.py install\n\n\n\nExample\n-------\n\n.. code-block:: console\n\n $ ./proxtop -t day proxmox.example.com:8006 monitor@pve\n Password:\n SORTED BY: diskread, avg\n ------------------\n #0: 3.1 MiB/s pve10 (acme-bugs-bunny)\n #1: 1.3 MiB/s pve07 (customerX-private)\n #2: 992.3 KiB/s pve10 (acme-road-runner)\n ...\n SORTED BY: cpu, max\n ------------------\n #0: 91 % pve07 (customerX-private)\n #1: 89 % pve10 (acme-bugs-bunny)\n #2: 66 % pve10 (acme-elmer-fudd)\n\n\nSee the help for more options:\n\n.. code-block:: console\n\n usage: proxtop [-h] [-T TOP] [-t TIMEFRAME] [-g AGGREGATION]\n [--only-storage ONLY_STORAGE]\n hostname username [only_vms [only_vms ...]]\n\n proxtop lists the top resource consumers on your Proxmox VM platform.\n\n positional arguments:\n hostname Use this API hostname (e.g. proxmox.example.com[:443])\n username Use this API username (e.g. monitor@pve)\n only_vms Limit results to these VM names (globbing is allowed)\n\n optional arguments:\n -h, --help show this help message and exit\n -T TOP, --top TOP Limit results to TOP VMs\n -t TIMEFRAME, --timeframe TIMEFRAME\n Timeframe, can be one of: hour* | day | week | month |\n year\n -g AGGREGATION, --aggregation AGGREGATION\n RRD aggregation, can be one of: AVERAGE | MAX |\n MEDIAN*\n --only-storage ONLY_STORAGE\n Filter VMs by storage glob (e.g. \"nfs03*\")\n\n Default values may be placed in ~/.proxtoprc. Lines should look like:\n hostname=HOSTNAME, username=USERNAME, password=PASSWORD\n\n\nLicense\n-------\n\nproxtop is free software: you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the Free\nSoftware Foundation, version 3 or any later version.\n\n\n\nFuture\n------\n\nPossible future enhancements:\n\n* Explain how server-side AGGREGATION affects the values\n (or perhaps remove the AVG/MAX subtypes and show only one, based\n on -g).\n* Add alternate modes of output?\n* Limit results to only one item (cpu, diskread, ...)?\n\n\n.. |pypi_version| image:: https://img.shields.io/pypi/v/proxtop.svg\n :target: https://pypi.python.org/pypi/proxtop\n\n.. |pypi_downloads| image:: https://img.shields.io/pypi/dm/proxtop.svg\n :target: https://pypi.python.org/pypi/proxtop", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ossobv/proxtop", "keywords": "", "license": "GPLv3+", "maintainer": "", "maintainer_email": "", "name": "proxtop", "package_url": "https://pypi.org/project/proxtop/", "platform": "linux", "project_url": "https://pypi.org/project/proxtop/", "project_urls": { "Homepage": "https://github.com/ossobv/proxtop" }, "release_url": "https://pypi.org/project/proxtop/0.3.1/", "requires_dist": null, "requires_python": "", "summary": "Proxmox resource monitor", "version": "0.3.1" }, "last_serial": 5425853, "releases": { "0.0.9": [ { "comment_text": "", "digests": { "md5": "b6d9eaef930a98a188ddd1fa4ea5f7bc", "sha256": "6559529385e28ed817f5aa8faf4b78a55f07446bf33e27af3d028d04adace62a" }, "downloads": -1, "filename": "proxtop-0.0.9.tar.gz", "has_sig": false, "md5_digest": "b6d9eaef930a98a188ddd1fa4ea5f7bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18092, "upload_time": "2015-03-24T08:44:24", "url": "https://files.pythonhosted.org/packages/01/0c/3c8e19a71f06d3386d123283ca90aff3b0104cc4998f10a4c3f4bbbf9c90/proxtop-0.0.9.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "a20b12881ccb85ce7b0f8622ee9b6b83", "sha256": "5dcb6a8c979fd782fe54fc74113981972f897c19adc9b9c903dafcb8d77c54da" }, "downloads": -1, "filename": "proxtop-0.1.0.tar.gz", "has_sig": false, "md5_digest": "a20b12881ccb85ce7b0f8622ee9b6b83", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18303, "upload_time": "2015-03-24T09:09:06", "url": "https://files.pythonhosted.org/packages/bc/4a/22269315556339469d3b5a4e628cbf5eabdeb6eeb04cfa5d77baa4e24d94/proxtop-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "9af241906dc6964786824e52fc464cb0", "sha256": "a5b85e7abdcddfbd42d84deb801cd3fee997e6ed17c940a326f46417df6b2435" }, "downloads": -1, "filename": "proxtop-0.1.1.tar.gz", "has_sig": false, "md5_digest": "9af241906dc6964786824e52fc464cb0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18553, "upload_time": "2015-04-10T12:14:47", "url": "https://files.pythonhosted.org/packages/e5/21/1bb48d695e2e8b1e07250f78c074e1c5a20ee50fdaf3b86a1afd6797613f/proxtop-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "16f75c8b8adf104b3b00b9e4267624fc", "sha256": "cccfb48a394c8d5be8fdd5a4b8422c7638fc17e305c197589c253aedd3d3478c" }, "downloads": -1, "filename": "proxtop-0.2.0.tar.gz", "has_sig": false, "md5_digest": "16f75c8b8adf104b3b00b9e4267624fc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19479, "upload_time": "2016-03-11T09:23:32", "url": "https://files.pythonhosted.org/packages/1b/bb/f9dccfd77806126f0997aa94c4025fa8f46eeefc0fe86657165f1a251ec7/proxtop-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "cc491d8e2b98f000acae565b23051326", "sha256": "7598ed1ee19ad419cae035766b41d68b648ab4ede83d65eb453bc1a9990c2cb9" }, "downloads": -1, "filename": "proxtop-0.2.1.tar.gz", "has_sig": false, "md5_digest": "cc491d8e2b98f000acae565b23051326", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20216, "upload_time": "2016-08-31T14:03:34", "url": "https://files.pythonhosted.org/packages/d7/fd/c5e6573d01fca410c200e90f83e23248328ae0e83f8314bd84b0eaa1e363/proxtop-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "7b85fec2601932df5226ac4798b63985", "sha256": "07be367e20fe0979d5ed46a9a7386de96607f6a77e62fdc9f1247524171973aa" }, "downloads": -1, "filename": "proxtop-0.2.2.tar.gz", "has_sig": false, "md5_digest": "7b85fec2601932df5226ac4798b63985", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20212, "upload_time": "2016-11-09T15:23:36", "url": "https://files.pythonhosted.org/packages/37/b6/ce84ffe99718b213ba1bcbc4cb0eec524f23e0ade95fb0e67f15a9c372fd/proxtop-0.2.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "7695933c4731541f61506c62e27cac56", "sha256": "0ddcf113dfff75b99dda0b0eb57d09b98c8a014f7291ef3ebc11e2297ddc7191" }, "downloads": -1, "filename": "proxtop-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7695933c4731541f61506c62e27cac56", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20954, "upload_time": "2019-03-05T15:30:35", "url": "https://files.pythonhosted.org/packages/8f/a1/69d36ccb83878b4122e5aebcf6597a83ea5ec3a9bd45831dcb0d98971090/proxtop-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "0eaeb358b078de69f3aca6949ecf721a", "sha256": "ac93b9559ab6c915127a1831a6419719668d1b78de5b7629ceb862b35821924f" }, "downloads": -1, "filename": "proxtop-0.3.1.tar.gz", "has_sig": false, "md5_digest": "0eaeb358b078de69f3aca6949ecf721a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21434, "upload_time": "2019-06-20T13:05:39", "url": "https://files.pythonhosted.org/packages/ac/d5/0c7be9306fc30901254dda0f61d7d8a2ee2e34b660ea2c802ee8594e36b5/proxtop-0.3.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0eaeb358b078de69f3aca6949ecf721a", "sha256": "ac93b9559ab6c915127a1831a6419719668d1b78de5b7629ceb862b35821924f" }, "downloads": -1, "filename": "proxtop-0.3.1.tar.gz", "has_sig": false, "md5_digest": "0eaeb358b078de69f3aca6949ecf721a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21434, "upload_time": "2019-06-20T13:05:39", "url": "https://files.pythonhosted.org/packages/ac/d5/0c7be9306fc30901254dda0f61d7d8a2ee2e34b660ea2c802ee8594e36b5/proxtop-0.3.1.tar.gz" } ] }