{"id":13586615,"url":"https://github.com/ossobv/proxtop","last_synced_at":"2025-05-05T18:32:39.101Z","repository":{"id":28097903,"uuid":"31596049","full_name":"ossobv/proxtop","owner":"ossobv","description":"Proxmox resource monitor -- list top resource users of your proxmox VM platform","archived":false,"fork":false,"pushed_at":"2023-12-20T16:11:09.000Z","size":390,"stargazers_count":27,"open_issues_count":11,"forks_count":7,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-18T08:41:20.585Z","etag":null,"topics":["cli","proxmox"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ossobv.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-03-03T11:56:50.000Z","updated_at":"2024-08-29T09:05:57.000Z","dependencies_parsed_at":"2024-08-01T16:42:43.502Z","dependency_job_id":null,"html_url":"https://github.com/ossobv/proxtop","commit_stats":{"total_commits":54,"total_committers":2,"mean_commits":27.0,"dds":0.07407407407407407,"last_synced_commit":"e690c99b5a20b232bfa09624681cb172ca5ff05a"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossobv%2Fproxtop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossobv%2Fproxtop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossobv%2Fproxtop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ossobv%2Fproxtop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ossobv","download_url":"https://codeload.github.com/ossobv/proxtop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252553175,"owners_count":21766841,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","proxmox"],"created_at":"2024-08-01T15:05:40.935Z","updated_at":"2025-05-05T18:32:38.783Z","avatar_url":"https://github.com/ossobv.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"|proxtop|\n=========\n\n*Proxmox resource monitor*\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:\u003center password\u003e\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\n\n.. |proxtop| image:: assets/proxtop_head.png\n    :alt: proxtop\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fossobv%2Fproxtop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fossobv%2Fproxtop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fossobv%2Fproxtop/lists"}