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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: must_triage-0.3.4.tar.gz
  • Upload date:
  • Size: 23.5 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.4.tar.gz
Algorithm Hash digest
SHA256 d88d0830518fd508926a9d69ff153de8342bd4010a0f58d5e8abb63a165f5b01
MD5 6d5c7bd4d9921ae0afe1b1a61047b834
BLAKE2b-256 74c340bcf19a58b85e0ab69827b09e7f50efe0517d90f1ba7293dfd513f70752

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: must_triage-0.3.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 c3e266a1352636ccbdd08a724342bc3767b19c9778a234db0af86a948a94242f
MD5 76f1f31d0c69c089b986771b963917f3
BLAKE2b-256 3cd82a83f2d217ac3255c260e4427634c0dfa8ae6f9666311bff0ef3a0c3e145

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