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

Uploaded Source

Built Distribution

must_triage-0.3.1-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: must_triage-0.3.1.tar.gz
  • Upload date:
  • Size: 24.0 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.1.tar.gz
Algorithm Hash digest
SHA256 02ebd3f3d3329eafc1cd946a6eae1226f4b39c2653a3eaf5214908932ae92333
MD5 5362e9705aed389185694f9e0c8c5ea0
BLAKE2b-256 e850a04df63074b2db37c382ad23162fd32ae5d2d15d74afa06c44b39adf4e24

See more details on using hashes here.

File details

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

File metadata

  • Download URL: must_triage-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 19.9 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e23667002989bec4c9d89c861e7c0169e4e41fa41a32c6ba8c4cc1ff94f5e9ac
MD5 73014becca3e2a5c934445decc26a7e1
BLAKE2b-256 5e043226d4729c8f36383592fd493813ace4e3ad08878f69809b24ac2a46a819

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