14.6. Collecte de données de débogage de réglage à faible latence 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'outil must-gather
vous permet de collecter des informations de diagnostic sur votre cluster OpenShift Container Platform, y compris le réglage des nœuds, la topologie NUMA et d'autres informations nécessaires pour déboguer les problèmes de configuration à faible latence.
Pour une assistance rapide, fournissez des informations de diagnostic pour OpenShift Container Platform et pour le réglage de la faible latence.
14.6.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 pour le débogage, telles que
- Définitions des ressources
- Journaux d'audit
- Journaux de service
Vous pouvez spécifier une ou plusieurs images lorsque vous exécutez la commande en incluant l'argument --image
. Lorsque vous spécifiez une image, l'outil collecte les données relatives à cette fonctionnalité ou à ce produit. Lorsque vous exécutez la commande 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 votre répertoire de travail actuel.
14.6.2. A propos de la collecte de données de réglage à faible latence
Utilisez la commande CLI oc adm must-gather
pour collecter des informations sur votre cluster, y compris les fonctionnalités et les objets associés au réglage de la faible latence, notamment :
- Les espaces de noms et les objets enfants de l'opérateur d'optimisation des nœuds.
-
MachineConfigPool
et les objetsMachineConfig
associés. - L'opérateur d'accord de nœud et les objets accordés associés.
- Options de ligne de commande du noyau Linux.
- Topologie CPU et NUMA
- Informations de base sur les périphériques PCI et la localité NUMA.
Pour collecter des informations de débogage avec must-gather
, vous devez spécifier l'image de l'opérateur Performance Addon must-gather
:
--image=registry.redhat.io/openshift4/performance-addon-operator-must-gather-rhel8:v4.12.
--image=registry.redhat.io/openshift4/performance-addon-operator-must-gather-rhel8:v4.12.
Dans les versions antérieures d'OpenShift Container Platform, l'opérateur Performance Addon permettait de régler automatiquement les performances des applications à faible latence. Dans OpenShift Container Platform 4.11 et les versions ultérieures, cette fonctionnalité fait partie de l'opérateur Node Tuning. Cependant, vous devez toujours utiliser l'image performance-addon-operator-must-gather
lors de l'exécution de la commande must-gather
.
14.6.3. Collecte de données sur des caractéristiques spécifiques
Vous pouvez obtenir des informations de débogage sur des fonctionnalités spécifiques en utilisant la commande CLI oc adm must-gather
avec l'argument --image
ou --image-stream
. L'outil must-gather
prend en charge plusieurs images, ce qui vous permet de recueillir des données sur plus d'une fonctionnalité en exécutant une seule commande.
Pour collecter les données par défaut must-gather
en plus des données relatives à des caractéristiques spécifiques, ajoutez l'argument --image-stream=openshift/must-gather
.
Dans les versions antérieures d'OpenShift Container Platform, l'opérateur Performance Addon permettait de régler automatiquement les performances des applications à faible latence. Dans OpenShift Container Platform 4.11, ces fonctions font partie de l'opérateur Node Tuning. Cependant, vous devez toujours utiliser l'image performance-addon-operator-must-gather
lors de l'exécution de la commande must-gather
.
Conditions préalables
-
Accès au cluster en tant qu'utilisateur ayant le rôle
cluster-admin
. - Le CLI (oc) de la plateforme de conteneurs OpenShift est installé.
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
avec un ou plusieurs arguments--image
ou--image-stream
. Par exemple, la commande suivante rassemble à la fois les données par défaut de la grappe et les informations spécifiques à l'opérateur Node Tuning :oc adm must-gather \ --image-stream=openshift/must-gather \
$ oc adm must-gather \ --image-stream=openshift/must-gather \
1 --image=registry.redhat.io/openshift4/performance-addon-operator-must-gather-rhel8:v4.12
2 Copy to Clipboard Copied! Créez un fichier compressé à partir du répertoire
must-gather
qui a été créé dans votre répertoire de travail. 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.5421342344627712289/
$ tar cvaf must-gather.tar.gz must-gather.local.5421342344627712289/
1 Copy to Clipboard Copied! - 1
- Remplacez
must-gather-local.5421342344627712289/
par le nom du répertoire.
- Joignez le fichier compressé à votre demande d'assistance sur le portail client de Red Hat.