12.3.5. Utilisation de l’outil must-gather

Vous pouvez collecter des journaux, des métriques et des informations sur les ressources MTC personnalisées en utilisant l’outil must-gather.

Les données must-gather doivent être jointes à tous les dossiers client.

Vous pouvez collecter des données sur une période d’une heure ou de 24 heures et les visualiser à l’aide de la console Prometheus.

Conditions préalables

Vous devez être connecté au cluster OpenShift Container Platform en tant qu’utilisateur avec le rôle cluster-admin.
Il faut que la CLI OpenShift (oc) soit installée.

Procédure

Accédez au répertoire dans lequel vous souhaitez stocker les données must-gather.
Exécutez la commande oc adm must-gather pour l’une des options de collecte de données suivantes :
- Pour collecter les données relatives à l’heure écoulée :
  $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6
  Copy to Clipboard
  Les données sont enregistrées en tant que must-gather/must-gather.tar.gz. Vous pouvez envoyer ce fichier dans un dossier d’assistance sur le Portail Client de Red Hat.
- Pour collecter les données des dernières 24 heures :
  $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.6 \ -- /usr/bin/gather_metrics_dump
  Copy to Clipboard
  Cette opération peut prendre beaucoup de temps. Les données sont enregistrées sous le nom must-gather/metrics/prom_data.tar.gz.

Vous pouvez visualiser les données de métrique à l’aide de la console Prometheus.

Procédure

Décompressez le fichier prom_data.tar.gz :

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

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

Copy to Clipboard

Créez une instance Prometheus locale :
```
make prometheus-run
```
```
$ make prometheus-run
```
Copy to Clipboard
La commande produit l’URL Prometheus.
Sortie
```
Started Prometheus on http://localhost:9090
```
```
Started Prometheus on http://localhost:9090
```
Copy to Clipboard
Démarrez un navigateur Web et accédez à l’URL pour afficher les données à l’aide de la console Web Prometheus.
Après avoir consulté les données, supprimez l’instance Prometheus, ainsi que les données :
```
make prometheus-cleanup
```
```
$ make prometheus-cleanup
```
Copy to Clipboard

Retour au début