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.0.tar.gz (23.9 kB view details)

Uploaded Source

Built Distribution

must_triage-0.3.0-py3-none-any.whl (19.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: must_triage-0.3.0.tar.gz
  • Upload date:
  • Size: 23.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for must_triage-0.3.0.tar.gz
Algorithm Hash digest
SHA256 12bca22c2facbf40368239d42e3be57884342ff72161114890583c5d8a77fb0e
MD5 035e5f21ae85ea64a0e1f6b36e9eca3a
BLAKE2b-256 c5768849072c43a11687e76040bcc6cf61dfb3eb6183e9b94692d329c573724f

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: must_triage-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 19.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for must_triage-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eb8319ab7ae6617ae21ead15df1f1a619ee21f6d94f60fa12efc75f56f457f09
MD5 2eaa39b9abe4b037df7c43f8448db308
BLAKE2b-256 14dc861c647fac2b0f09918f280e2bb3c5ad3ac0b9f4919e1102ded6b5fb5561

See more details on using hashes here.

Provenance

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