Skip to main content

A utility for triaging must-gather output

Project description


When things go wrong with OpenShift or OpenShift Container Storage, we sometimes use must-gather or ocs-must-gather to collect logfiles and other documents to diagnose issues. While those tools are useful in that they can show us a lot about the state of the system(s), they don't offer anything to help process that information.

must-triage is a very small utility to aid in identifying problems recorded in must-gather output.


Currently, must-triage knows about the following potential issues:

OpenShift (OCP)

  • Unparseable YAML files
  • Pods not in ready state

OpenShift Container Storage (OCS)

  • Empty JSON files
  • Unparseable JSON files
  • Ceph health not HEALTH_OK

Teaching it to identify new issues is not difficult; PRs warmly welcomed!


pip install must-triage


must-triage /path/to/must-gather/output

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for must-triage, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size must_triage-0.2.0.tar.gz (17.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page