Skip to content
A top(1)-like tool for Kubernetes.
Branch: master
Clone or download
exarkun Merge pull request #63 from rodrigc/travis-no-fail-py3
Do not allow test failures on Python 3
Latest commit d7c9038 Aug 20, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/kubetop Replace filter() with generator + join() Apr 20, 2018
.coveragerc
.dockerignore Early attempt at building a Docker image for this May 17, 2017
.travis.yml Do not allow test failures on Python 3 Apr 24, 2018
Dockerfile
LICENSE
README.rst
setup.py

README.rst

kubetop

PyPI Package CI status Coverage

What is this?

kubetop is a top(1)-like tool for Kubernetes.

Usage Sample

$ kubetop

Output Sample

kubetop - 13:02:57
Node 0 CPU%   9.80 MEM% 57.97 (   2 GiB/   4 GiB)  POD%  7.27 (  8/110) Ready
Node 1 CPU%  21.20 MEM% 59.36 (   2 GiB/   4 GiB)  POD%  3.64 (  4/110) Ready
Node 2 CPU%  99.90 MEM% 58.11 (   2 GiB/   4 GiB)  POD%  7.27 (  8/110) Ready
Pods:       20 total        0 running        0 terminating        0 pending
                 POD               (CONTAINER)        %CPU         MEM   %MEM
s4-infrastructure-3073578190-2k2vw                    75.5  782.05 MiB  20.76
                      (subscription-converger)        72.7  459.11 MiB
                                 (grid-router)         2.7   98.07 MiB
                                         (web)         0.1   67.61 MiB
                        (subscription-manager)         0.0   91.62 MiB
                       (foolscap-log-gatherer)         0.0   21.98 MiB
                                       (flapp)         0.0   21.46 MiB
                              (wormhole-relay)         0.0   22.19 MiB

Installing

Pip / Pipsi

To install the latest version of kubetop using pip or pipsi:

$ pipsi install kubetop

Docker

A Docker image containing a kubetop installation is also available. You can run it like this:

$ docker run -it --rm --volume ~/.kube/:/root/.kube/:ro exarkun/kubetop

Testing

kubetop uses pyunit-style tests. After installing the development dependencies, you can run the test suite with trial:

$ pip install kubetop[dev]
$ trial kubetop

Version

kubetop uses the CalVer versioning convention. The first three segments of a kubetop version tell you the year (two digit), month, and day that version was released. The fourth segment of a kubetop version is a bugfix release counter. It is present if a new release is made that diffs from a previous release only by including one or more bug fixes. For each bug fix release, the fourth segment is incremented.

License

txkube is open source software released under the MIT License. See the LICENSE file for more details.

You can’t perform that action at this time.