{"id":18974146,"url":"https://github.com/eht16/kube-cargo-load","last_synced_at":"2025-04-19T16:39:58.412Z","repository":{"id":62574759,"uuid":"255174909","full_name":"eht16/kube-cargo-load","owner":"eht16","description":"Kubernetes POD memory limits and usage overview","archived":false,"fork":false,"pushed_at":"2025-02-23T18:09:51.000Z","size":94,"stargazers_count":9,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T00:38:13.481Z","etag":null,"topics":["kubernetes","memory","pod","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eht16.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2020-04-12T21:39:01.000Z","updated_at":"2025-03-22T07:40:21.000Z","dependencies_parsed_at":"2025-02-23T18:25:58.010Z","dependency_job_id":"acc9a6e2-425d-44a0-9b70-bf1f64449e0e","html_url":"https://github.com/eht16/kube-cargo-load","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eht16%2Fkube-cargo-load","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eht16%2Fkube-cargo-load/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eht16%2Fkube-cargo-load/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eht16%2Fkube-cargo-load/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eht16","download_url":"https://codeload.github.com/eht16/kube-cargo-load/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249223935,"owners_count":21232833,"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":["kubernetes","memory","pod","python"],"created_at":"2024-11-08T15:14:14.135Z","updated_at":"2025-04-16T09:33:52.792Z","avatar_url":"https://github.com/eht16.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"kube-cargo-load\n===============\n\n[![CI Tests](https://github.com/eht16/kube-cargo-load/actions/workflows/tests.yml/badge.svg)](https://github.com/eht16/kube-cargo-load/actions/workflows/tests.yml)\n[![PyPI](https://img.shields.io/pypi/v/kube-cargo-load.svg)](https://pypi.org/project/kube-cargo-load/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/kube-cargo-load.svg)](https://pypi.org/project/kube-cargo-load/)\n[![License](https://img.shields.io/pypi/l/kube-cargo-load.svg)](https://pypi.org/project/kube-cargo-load/)\n\n\nList Kubernetes PODs of a specific namespace or all namespaces with their\nconfigured memory or cpu requests, limits and the current memory or cpu usage.\n\n\nFeatures\n--------\n\n  * Overview of PODs and their memory or cpu requests, limits and actual usage\n  * Provides an easy inspection of the cluster utilization in terms of memory or cpu\n  * Uses `kubectl` under the hood and reuses its config\n  * Supports `--namespace` and `--all-namespaces` command line arguments\n  * Supports `--context` command line argument\n    filters and column setup\n\nExample:\n\n    [15:09:58] enrico@host (0): ~% kubecargoload.py --all-namespaces\n    Namespace   Name                                          Requests       Limits        Usage            %\n    ----------------------------------------------------------------------------------------------------------\n    default     kube-web-view-7c67ddb647-pvjvs                100.0 Mi     100.0 Mi      29.0 Mi      29.00 %\n    jitsi       jitsi-57d5888c88-vzrzl                          0.0  B       0.0  B     137.0 Mi       0.00 %\n    kube-system coredns-66bff467f8-qn4pq                       70.0 Mi     170.0 Mi      13.0 Mi       7.65 %\n    kube-system coredns-66bff467f8-znpxv                       70.0 Mi     170.0 Mi      11.0 Mi       6.47 %\n    kube-system etcd-minikube                                   0.0  B       0.0  B      58.0 Mi       0.00 %\n    kube-system kindnet-ptgnz                                  50.0 Mi      50.0 Mi      13.0 Mi      26.00 %\n    kube-system kube-apiserver-minikube                         0.0  B       0.0  B     257.0 Mi       0.00 %\n    kube-system kube-controller-manager-minikube                0.0  B       0.0  B      50.0 Mi       0.00 %\n    kube-system kube-proxy-s7bl8                                0.0  B       0.0  B      16.0 Mi       0.00 %\n    kube-system kube-scheduler-minikube                         0.0  B       0.0  B      19.0 Mi       0.00 %\n    kube-system metrics-server-7bc6d75975-d6sgr                 0.0  B       0.0  B      13.0 Mi       0.00 %\n    kube-system nginx-ingress-controller-6d57c87cb9-tgwwm       0.0  B       0.0  B       0.0  B       0.00 %\n    kube-system storage-provisioner                             0.0  B       0.0  B      15.0 Mi       0.00 %\n    ----------------------------------------------------------------------------------------------------------\n    Summary     (PODs without configured limits ignored)      290.0 Mi     490.0 Mi      66.0 Mi      13.47 %\n\n\nSetup\n-----\n\n### Requirements\n\nIn order to use kube-cargo-load, you will need:\n\n- A Kubernetes cluster to connect to\n- Kubernetes Metrics Server must be installed and running in Kubernetes\n  (\u003chttps://github.com/kubernetes-sigs/metrics-server\u003e)\n- kubectl (it must be configured for your Kubernetes cluster)\n- Python 3.6 or newer\n\n\n### Installation\n\nThe easiest method is to install directly from pypi using pip:\n\n    pip install kube-cargo-load\n\n\nIf you prefer, you can download kube-cargo-load and install it\ndirectly from source:\n\n    python setup.py install\n\n\n### Download\n\nAlternatively, you can download just the script and execute it:\n\n    wget https://raw.githubusercontent.com/eht16/kube-cargo-load/master/kubecargoload.py\n    chmod +x kubecargoload.py\n    ./kubecargoload.py\n\n\nCommand line options\n--------------------\n\n    usage: kubecargoload.py [-h] [-A] [--context CONTEXT] [-d] [-n NAMESPACE] [-H] [-s SORT] [-V]\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      -A, --all-namespaces  list the requested object(s) across all namespaces (default: False)\n      -c, --cpu             show cpu instead of memory (default: False)\n      --context CONTEXT     the name of the kubeconfig context to use (default: None)\n      -d, --debug           enable tracebacks (default: False)\n      -n NAMESPACE, --namespace NAMESPACE\n                            namespace to use (default: default)\n      -H, --no-headers      do not print header line before the output (default: False)\n      -s SORT, --sort SORT  sort by column(s), to sort by multiple columns seperate them with comma. Valid options: namespace,name,requests,limits,usage,ratio (default: namespace,name)\n      -V, --version         show version and exit (default: False)\n\n\nGet the Source\n--------------\n\nThe source code is available at https://github.com/eht16/kube-cargo-load/.\n\n\nChangeLog\n---------\n\n### 1.2 / 2020-05-24\n\n    * Add support for -c/--cpu flag (#3, Kurounin)\n    * Round humanized usage values to have more accurate numbers\n    * Add unit tests\n\n### 1.1 / 2020-04-15\n\n    * Fix Python 3.6 compability (#1, Adrian Gajan)\n    * Improve docs\n    * Fix display units (KB -\u003e Ki)\n    * Consider only PODs with configured limits in the summary\n\n### 1.0 / 2020-04-12\n\n    * Initial release\n\n\nContributing\n------------\n\nFound a bug or got a feature request? Please report it at\nhttps://github.com/eht16/kube-cargo-load/issues.\n\n\nAuthor\n------\n\nEnrico Tröger \u003cenrico.troeger@uvena.de\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feht16%2Fkube-cargo-load","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feht16%2Fkube-cargo-load","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feht16%2Fkube-cargo-load/lists"}