14.15. Collecte de données pour Red Hat Support
Lorsque vous soumettez un cas d'assistance à Red Hat Support, il est utile de fournir des informations de débogage pour OpenShift Container Platform et OpenShift Virtualization en utilisant les outils suivants :
- outil indispensable
-
L'outil
must-gatherrecueille des informations de diagnostic, notamment des définitions de ressources et des journaux de service. - Prometheus
- Prometheus est une base de données de séries temporelles et un moteur d'évaluation de règles pour les métriques. Prometheus envoie des alertes à Alertmanager pour traitement.
- Gestionnaire d'alerte
- Le service Alertmanager gère les alertes reçues de Prometheus. Il est également chargé d'envoyer les alertes aux systèmes de notification externes.
14.15.1. Collecte de données sur votre environnement
La collecte de données sur votre environnement réduit le temps nécessaire à l'analyse et à la détermination de la cause première.
Conditions préalables
- Fixez la durée de conservation des données de métrologie Prometheus à un minimum de sept jours.
- Configurer l'Alertmanager pour qu'il capture les alertes pertinentes et les envoie à une boîte aux lettres dédiée afin qu'elles puissent être consultées et conservées en dehors du cluster.
- Enregistrez le nombre exact de nœuds et de machines virtuelles affectés.
Procédure
-
Collectez les données
must-gatherpour la grappe en utilisant l'image par défautmust-gather. -
Recueillir les données
must-gatherpour Red Hat OpenShift Data Foundation, si nécessaire. -
Collectez les données
must-gatherpour OpenShift Virtualization en utilisant l'image OpenShift Virtualizationmust-gather. - Collecter les métriques Prometheus pour le cluster.
14.15.1.1. Ressources supplémentaires
- Configuration de la durée de conservation des données de métrologie de Prometheus
- Configuration de l'Alertmanager pour l'envoi de notifications d'alerte à des systèmes externes
-
Collecte des données
must-gatherpour OpenShift Container Platform -
Collecte des données
must-gatherpour Red Hat OpenShift Data Foundation -
Collecte des données
must-gatherpour OpenShift Virtualization - Collecte des métriques Prometheus pour tous les projets en tant qu'administrateur de cluster
14.15.2. Collecte de données sur les machines virtuelles
La collecte de données sur les machines virtuelles (VM) qui fonctionnent mal réduit le temps nécessaire à l'analyse et à la détermination de la cause première.
Conditions préalables
VM Windows :
- Enregistrez les détails de la mise à jour des correctifs Windows pour Red Hat Support.
- Installer la dernière version des pilotes VirtIO. Les pilotes VirtIO incluent l'agent invité QEMU.
- Si le protocole Remote Desktop Protocol (RDP) est activé, essayez de vous connecter aux machines virtuelles avec RDP pour déterminer s'il y a un problème avec le logiciel de connexion.
Procédure
-
Recueillir des données détaillées sur
must-gatherconcernant les machines virtuelles défectueuses. - Réalisez des captures d'écran des machines virtuelles qui se sont bloquées avant de les redémarrer.
- Enregistrez les facteurs que les machines virtuelles défectueuses ont en commun. Par exemple, les VM ont le même hôte ou le même réseau.
14.15.2.1. Ressources supplémentaires
- Installation des pilotes VirtIO sur les VM Windows
- Téléchargement et installation des pilotes VirtIO sur les VM Windows sans accès à l'hôte
- Connexion aux machines virtuelles Windows avec RDP en utilisant la console web ou la ligne de commande
-
Collecte de données
must-gathersur les machines virtuelles
14.15.3. Utilisation de l'outil must-gather pour OpenShift Virtualization
Vous pouvez collecter des données sur les ressources d'OpenShift Virtualization en exécutant la commande must-gather avec l'image d'OpenShift Virtualization.
La collecte de données par défaut comprend des informations sur les ressources suivantes :
- Espaces de noms de l'opérateur de virtualisation OpenShift, y compris les objets enfants
- Définitions de ressources personnalisées pour OpenShift Virtualization
- Espaces de noms contenant des machines virtuelles
- Définitions de base des machines virtuelles
Procédure
Exécutez la commande suivante pour collecter des données sur OpenShift Virtualization :
$ oc adm must-gather --image-stream=openshift/must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v{HCOVersion}
14.15.3.1. options d'outils indispensables
Vous pouvez spécifier une combinaison de scripts et de variables d'environnement pour les options suivantes :
- Collecte d'informations détaillées sur les machines virtuelles (VM) à partir d'un espace de noms
- Collecte d'informations détaillées sur les machines virtuelles spécifiées
- Collecte d'informations sur les images et les flux d'images
-
Limiter le nombre maximum de processus parallèles utilisés par l'outil
must-gather
14.15.3.1.1. Parameters
Variables d’environnement
Vous pouvez spécifier des variables d'environnement pour un script compatible.
NS=<namespace_name>-
Collecte des informations sur les machines virtuelles, y compris les détails du pod
virt-launcher, à partir de l'espace de noms que vous avez spécifié. Les données CRVirtualMachineetVirtualMachineInstancesont collectées pour tous les espaces de noms. VM=<vm_name>-
Collecter des informations sur une machine virtuelle particulière. Pour utiliser cette option, vous devez également spécifier un espace de noms en utilisant la variable d'environnement
NS. PROS=<number_of_processes>Modifier le nombre maximum de processus parallèles utilisés par l'outil
must-gather. La valeur par défaut est5.ImportantL'utilisation d'un trop grand nombre de processus parallèles peut entraîner des problèmes de performance. Il n'est pas recommandé d'augmenter le nombre maximal de processus parallèles.
Scripts
Chaque script n'est compatible qu'avec certaines combinaisons de variables d'environnement.
gather_vms_details-
Collecter les fichiers journaux de VM, les définitions de VM et les espaces de noms (et leurs objets enfants) qui appartiennent aux ressources OpenShift Virtualization. Si vous utilisez ce paramètre sans spécifier d'espace de noms ou de VM, l'outil
must-gathercollecte ces données pour toutes les VM du cluster. Ce script est compatible avec toutes les variables d'environnement, mais vous devez spécifier un espace de noms si vous utilisez la variableVM. gather-
Utilisez le script par défaut
must-gather, qui collecte les données de cluster de tous les espaces de noms et n'inclut que des informations de base sur les machines virtuelles. Ce script n'est compatible qu'avec la variablePROS. gather_images-
Collecte des informations sur les ressources personnalisées des images et des flux d'images. Ce script n'est compatible qu'avec la variable
PROS.
14.15.3.1.2. Utilisation et exemples
Les variables d'environnement sont facultatives. Vous pouvez exécuter un script seul ou avec une ou plusieurs variables d'environnement compatibles.
| Le scénario | Variable d'environnement compatible |
|---|---|
|
|
|
|
|
|
|
|
|
Pour personnaliser les données collectées par must-gather, vous devez ajouter un double tiret (--) à la commande, suivi d'un espace et d'un ou plusieurs paramètres compatibles.
Syntaxe
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.2 \ -- <environment_variable_1> <environment_variable_2> <script_name>
Informations détaillées sur les machines virtuelles
La commande suivante recueille des informations détaillées sur la VM my-vm dans l'espace de noms mynamespace:
$ oc adm must-gather \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.2 \
-- NS=mynamespace VM=my-vm gather_vms_details 1- 1
- La variable d'environnement
NSest obligatoire si vous utilisez la variable d'environnementVM.
Collecte de données par défaut limitée à trois processus parallèles
La commande suivante recueille des informations sur le site must-gather par défaut en utilisant un maximum de trois processus parallèles :
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.2 \ -- PROS=3 gather
Informations sur les images et les flux d'images
La commande suivante permet de collecter des informations sur les images et les flux d'images de la grappe :
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.2 \ -- gather_images
