15.4. Collecte de données de journalisation pour Red Hat Support
Lorsque vous ouvrez un dossier d'assistance, il est utile de fournir des informations de débogage sur votre cluster à l'équipe d'assistance de Red Hat.
L'outilmust-gather vous permet de collecter des informations de diagnostic pour les ressources au niveau du projet, les ressources au niveau du cluster et chacun des composants du sous-système de journalisation.
Pour une assistance rapide, fournissez des informations de diagnostic pour OpenShift Container Platform et OpenShift Logging.
N'utilisez pas le script hack/logging-dump.sh. Ce script n'est plus pris en charge et ne collecte pas de données.
15.4.1. À propos de l'outil de collecte obligatoire
La commande CLI oc adm must-gather recueille les informations de votre cluster les plus susceptibles d'être nécessaires au débogage des problèmes.
Pour votre sous-système de journalisation, must-gather collecte les informations suivantes :
- Ressources au niveau du projet, y compris les pods, les cartes de configuration, les comptes de service, les rôles, les liaisons de rôles et les événements au niveau du projet
- Ressources au niveau du cluster, y compris les nœuds, les rôles et les liaisons de rôles au niveau du cluster
-
Ressources OpenShift Logging dans les espaces de noms
openshift-loggingetopenshift-operators-redhat, y compris l'état de santé du collecteur de logs, du magasin de logs et du visualiseur de logs
Lorsque vous exécutez oc adm must-gather, un nouveau module est créé sur le cluster. Les données sont collectées sur ce module et enregistrées dans un nouveau répertoire commençant par must-gather.local. Ce répertoire est créé dans le répertoire de travail actuel.
15.4.2. Conditions préalables
- Le sous-système de journalisation et Elasticsearch doivent être installés.
15.4.3. Collecte des données de journalisation d'OpenShift
Vous pouvez utiliser la commande CLI oc adm must-gather pour collecter des informations sur votre sous-système de journalisation.
Procédure
Pour collecter des informations sur le sous-système de journalisation à l'aide de must-gather:
-
Naviguez jusqu'au répertoire dans lequel vous souhaitez stocker les informations de
must-gather. Exécutez la commande
oc adm must-gathercontre l'image OpenShift Logging :$ oc adm must-gather --image=$(oc -n openshift-logging get deployment.apps/cluster-logging-operator -o jsonpath='{.spec.template.spec.containers[?(@.name == "cluster-logging-operator")].image}')L'outil
must-gathercrée un nouveau répertoire commençant parmust-gather.localdans le répertoire actuel. Par exemple :must-gather.local.4157245944708210408.Créez un fichier compressé à partir du répertoire
must-gatherqui vient d'être créé. Par exemple, sur un ordinateur utilisant un système d'exploitation Linux, exécutez la commande suivante :$ tar -cvaf must-gather.tar.gz must-gather.local.4157245944708210408
- Joignez le fichier compressé à votre demande d'assistance sur le portail client de Red Hat.
