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
  • Operators who haven't reported success
  • YAML files which contain a top-level error field

OpenShift Container Storage (OCS)

  • Empty JSON files
  • Unparseable JSON files
  • Ceph health not HEALTH_OK
  • Logfiles which mention a panic

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.3.1
Filename, size File type Python version Upload date Hashes
Filename, size must_triage-0.3.1-py3-none-any.whl (19.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size must_triage-0.3.1.tar.gz (24.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page