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

  • 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.
  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

    gcloud

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. Définissez une région et une zone par défaut.

    REST

    Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

      Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init

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