OKD Cluster Autoscaler Must Gather Investigator

A tool for examining OKD/OpenShift must-gather records to investigate cluster autoscaler behavior and configuration.

Quickstart

1. install from PyPi with pip3 install okd-camgi --user
2. Have a must-gather ready to go in $MUST_GATHER_PATH
3. Run okd-camgi --webbrowser $MUST_GATHER_PATH

Your web browser should now show a page with a summary of the must-gather and some interactive navigation buttons. If your browser does not open, you will see the URL printed on the terminal, copy it into a new browser tab or window.

Direct from tar file

okd-camgi can also process must-gather tar files directly, using the --tar flag. for example:

$ okd-camgi --tar path/to/my/must-gather.tar.gz

Containerized Server

An alternative to running the command line tool is to start a local containerized webserver which hosts the must-gather investigation page. Follow these steps to start a local server:

1. podman run --rm -it -p 8080:8080 -v /path/to/must-gather:/must-gather:Z quay.io/elmiko/okd-camgi
2. Open you web browser to http://localhost:8080

As in the Quickstart, your web browser should now show the must-gather investigation page.