12.3.5. Verwendung des Tools „must-gather“

Sie können Protokolle, Metriken und Informationen über benutzerdefinierte MTC-Ressourcen mit dem Tool must-gather sammeln.

Die must-gather-Daten müssen allen Kundenfällen beigefügt werden.

Sie können Daten für einen Zeitraum von einer Stunde oder von 24 Stunden sammeln und die Daten mit der Prometheus-Konsole anzeigen.

Voraussetzungen

Sie müssen am OpenShift Container Platform-Cluster als Benutzer mit der Rolle cluster-admin angemeldet sein.
Sie müssen die OpenShift CLI (oc) installiert haben.

Vorgehensweise

Navigieren Sie zu dem Verzeichnis, in dem Sie die must-gather-Daten speichern möchten.
Führen Sie den Befehl oc adm must-gather für eine der folgenden Datensammlungsoptionen aus:
- So sammeln Sie die Daten der letzten Stunde:
  $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6
  Die Daten werden als must-gather/must-gather.tar.gz gespeichert. Sie können diese Datei in einen Support-Fall im Red Hat Customer Portal hochladen.
- So sammeln Sie die Daten der letzten 24 Stunden:
  $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6 \ -- /usr/bin/gather_metrics_dump
  Dieser Vorgang kann viel Zeit in Anspruch nehmen. Die Daten werden als must-gather/metrics/prom_data.tar.gz gespeichert.

Sie können die Metrikdaten über die Prometheus-Konsole anzeigen.

Vorgehensweise

Dekomprimieren Sie die Datei prom_data.tar.gz:

$ tar -xvzf must-gather/metrics/prom_data.tar.gz

Erstellen Sie eine lokale Prometheus-Instanz:
```
$ make prometheus-run
```
Der Befehl gibt die Prometheus-URL aus.
Ausgabe
```
Started Prometheus on http://localhost:9090
```
Starten Sie einen Webbrowser und navigieren Sie zu der URL, um die Daten mithilfe der Prometheus-Webkonsole anzuzeigen.
Nachdem Sie die Daten angesehen haben, löschen Sie die Prometheus-Instanz und die Daten:
```
$ make prometheus-cleanup
```