Rechercher

14.15. Collecte de données pour Red Hat Support

download PDF

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-gather recueille 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

  1. Collectez les données must-gather pour la grappe en utilisant l'image par défaut must-gather.
  2. Recueillir les données must-gather pour Red Hat OpenShift Data Foundation, si nécessaire.
  3. Collectez les données must-gather pour OpenShift Virtualization en utilisant l'image OpenShift Virtualization must-gather.
  4. Collecter les métriques Prometheus pour le cluster.

14.15.1.1. Ressources supplémentaires

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

  1. Recueillir des données détaillées sur must-gather concernant les machines virtuelles défectueuses.
  2. Réalisez des captures d'écran des machines virtuelles qui se sont bloquées avant de les redémarrer.
  3. 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

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 CR VirtualMachine et VirtualMachineInstance sont 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 est 5.

Important

L'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-gather collecte 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 variable VM.
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 variable PROS.
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.

Tableau 14.1. Paramètres de compatibilité
Le scénarioVariable d'environnement compatible

gather_vms_details

  • Pour un espace de noms : NS=<namespace_name>
  • Pour une VM : VM=<vm_name> NS=<namespace_name>
  • PROS=<number_of_processes>

gather

  • PROS=<number_of_processes>

gather_images

  • PROS=<number_of_processes>

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 NS est obligatoire si vous utilisez la variable d'environnement VM.

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

14.15.3.2. Ressources supplémentaires

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.