Skip to main content

A utility for triaging must-gather output

Project description

must-triage

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.

Features

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!

Installation

pip install must-triage

Usage

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.

Source Distribution

must_triage-0.3.3.tar.gz (23.4 kB view details)

Uploaded Source

Built Distribution

must_triage-0.3.3-py3-none-any.whl (20.0 kB view details)

Uploaded Python 3

File details

Details for the file must_triage-0.3.3.tar.gz.

File metadata

  • Download URL: must_triage-0.3.3.tar.gz
  • Upload date:
  • Size: 23.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for must_triage-0.3.3.tar.gz
Algorithm Hash digest
SHA256 15b7d692c7863a84dde640bdbc68df337308b78f33987b4f6c048175343c57d6
MD5 b92338dbaef4b3bee30c7dbcab908385
BLAKE2b-256 c6d5a754b3fa478bf5d172c8b7551405ba2829f27b923f3958751c06097e97a6

See more details on using hashes here.

File details

Details for the file must_triage-0.3.3-py3-none-any.whl.

File metadata

  • Download URL: must_triage-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 20.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for must_triage-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f9ae783e1387616e70ec2037765083d8026eaa26a05e6a652a224da1e8e0186f
MD5 608fa2301ace3a9ae3da6460577c26db
BLAKE2b-256 6101d45dcd97dc2e75a29dfc7c314d7da3bd21b1c9d3702bdd8aef31682b9e1a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page