12.3.5. Usare lo strumento must-gather
È possibile raccogliere registri, metriche e informazioni sulle risorse personalizzate MTC utilizzando lo strumento must-gather
.
I dati must-gather
devono essere allegati a tutti i casi dei clienti.
È possibile raccogliere dati per un'ora o un periodo di 24 ore e visualizzare i dati con la console Prometheus.
Requisiti
-
È necessario essere connessi al cluster di OpenShift Container Platform come utente con il ruolo
cluster-admin
. -
È necessario avere installato la CLI OpenShift
(oc
).
Procedura
-
Andare alla directory dove si desidera memorizzare i dati
must-gather
. Eseguire il comando
oc adm must-gather
per una delle seguenti opzioni di raccolta dati:Per raccogliere i dati dell'ultima ora:
$ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6
I dati sono salvati come
must-gather/must-gather.tar.gz.
È possibile caricare questo file in un caso di supporto sul Red Hat Customer Portal.Per raccogliere i dati delle ultime 24 ore:
$ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6 \ -- /usr/bin/gather_metrics_dump
Questa operazione può richiedere molto tempo. I dati sono salvati come
must-gather/metrics/prom_data.tar.gz.
Visualizzare i dati delle metriche con la console Prometheus
È possibile visualizzare i dati delle metriche con la console Prometheus.
Procedura
Decomprimere il file
prom_data.tar.gz
:$ tar -xvzf must-gather/metrics/prom_data.tar.gz
Creare un'istanza locale di Prometheus:
$ make prometheus-run
Il comando emette l'URL di Prometheus.
Output
Started Prometheus on http://localhost:9090
- Avviare un browser web e andare all'URL per visualizzare i dati utilizzando la console web di Prometheus.
Dopo aver visualizzato i dati, eliminare l'istanza Prometheus e i dati:
$ make prometheus-cleanup