Collecter des informations de diagnostic

Ce document explique comment collecter des informations sur une instance de machine virtuelle (VM) à l'aide d'un outil de diagnostic. Utilisez les informations collectées par les outils pour faciliter le dépannage de base avant de contacter l'assistance.

Cet outil effectue les opérations suivantes :

  • Il collecte uniquement les informations de la VM spécifiée.

  • Les informations sont stockées uniquement dans votre projet.

  • Il stocke les informations pendant 10 jours dans un bucket Cloud Storage, auquel vous seul pouvez accéder par défaut.

Avant de partager les informations recueillies à l'assistance Google, procédez comme suit :

  1. Vérifiez que les informations ne contiennent pas d'informations confidentielles personnelles.

  2. Supprimez ou masquez les informations si nécessaire.

Informations de diagnostic recueillies à partir de la VM

Cet outil de diagnostic collecte des informations sur les éléments suivants :

Pour en savoir plus sur la manière dont Compute Engine collecte ces informations, consultez le dépôt public.

Limites

  • Vous pouvez collecter des informations de diagnostic uniquement à partir de VM créées sur Windows Server.

Avant de commencer

  • Si vous souhaitez utiliser les exemples de ligne de commande de ce guide, procédez comme suit :
    1. Installez la dernière version de Google Cloud CLI ou appliquez la mise à jour correspondante.
    2. Définissez une région et une zone par défaut.
  • Si vous voulez utiliser les exemples d'API de ce guide, configurez l'accès aux API.
  • Par défaut, Compute Engine installe l'outil de diagnostic sur les versions publiques des images Windows Server dont la version est ultérieure à v20190714. Sinon, si la version de votre image Windows Server est antérieure à v20190714 ou si vous utilisez une image personnalisée, installez l'outil à l'aide de la commande googet install google-compute-engine-diagnostics.

Collecter des informations de diagnostic à partir d'une VM

Exécutez l'outil de diagnostic soit directement depuis la VM, soit à distance, à l'aide de Google Cloud CLI. Sur les VM Windows, vous trouverez l'outil de diagnostic dans le répertoire C:\Program Files\Google\Compute Engine\diagnostics.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

  • roles/iam.serviceAccountTokenCreator sur le projet

gcloud

  1. Attribuez le rôle iam.serviceAccountTokenCreator au projet :

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member user:EMAIL \
    --role roles/iam.serviceAccountTokenCreator

    Remplacez l'élément suivant :

    • PROJECT_ID : ID du projet
    • EMAIL : l'adresse e-mail pour attribuer le rôle iam.serviceAccountTokenCreator

  2. Exportez les informations de diagnostic en tant qu'objet dans un bucket Cloud Storage.

    gcloud compute diagnose export-logs VM_NAME \
  [--collect-process-traces]

    L'option facultative --collect-process-traces permet de spécifier si l'outil de diagnostic collecte une trace de 10 minutes du système en cours d'exécution, ce qui inclut l'activité du processeur, du disque, du fichier et du réseau. Sur les VM Windows, Windows Performance Recorder est utilisé.

    Remplacez l'élément suivant :

    • VM_NAME : nom de la VM à partir de laquelle collecter les informations de diagnostic

  3. Le processus d'exportation des journaux peut prendre quelques minutes. Affichez l'état à l'aide de la commande gcloud compute instances get-serial-port-output.

  4. Compute Engine formate le nom du bucket contenant les informations de diagnostic comme suit : diagnostic_logs_project_PROJECT_NUMBER. Affichez ou téléchargez le bucket à l'aide de l'outil gsutil tool ou depuis la page Cloud Storage dans Google Cloud Console :

    Accéder à Cloud Storage

Étape suivante