Recopilación de información de diagnóstico

Este documento describe cómo recopilar información sobre una instancia de máquina virtual (VM) mediante una herramienta de diagnóstico. Utilice la información que recopilan las herramientas para ayudar con la solución de problemas básicos antes de comunicarse con el Soporte .

La herramienta hace lo siguiente:

  • Recopila información únicamente de la máquina virtual que usted especifique.

  • Almacena la información sólo en su proyecto.

  • Almacena la información durante 10 días en un depósito de Cloud Storage , al que, de forma predeterminada, solo tú puedes acceder.

Antes de compartir la información recopilada con el Soporte de Google, haga lo siguiente:

  1. Revise la información en busca de información confidencial o de identificación personal (PII).

  2. Elimine o enmascare la información según sea necesario.

Información de diagnóstico recopilada de la VM

Esta herramienta de diagnóstico recopila información sobre lo siguiente:

Para obtener información detallada sobre cómo Compute Engine recopila esta información, consulta el repositorio público .

Limitaciones

  • Solo puede recopilar información de diagnóstico de máquinas virtuales creadas en función de Windows Server.

Antes de comenzar

  • Compute Engine instala la herramienta de diagnóstico de forma predeterminada en versiones públicas de imágenes de Windows Server posteriores a v20190714 . De lo contrario, si la versión de su imagen de Windows Server es anterior a v20190714 o está utilizando una imagen personalizada, instale la herramienta usando el comando googet install google-compute-engine-diagnostics .
  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

      Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Recopilación de información de diagnóstico de una máquina virtual

Ejecute la herramienta de diagnóstico directamente desde la máquina virtual o de forma remota mediante la CLI de Google Cloud. En máquinas virtuales basadas en Windows, busque la herramienta de diagnóstico en el directorio C:\Program Files\Google\Compute Engine\diagnostics .

Permisos necesarios para esta tarea

Para realizar esta tarea, debe tener los siguientes permisos :

  • roles/iam.serviceAccountTokenCreator en el proyecto

nube de gcloud

  1. Otorgue el rol iam.serviceAccountTokenCreator en el proyecto:

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

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto
    • EMAIL : la dirección de correo electrónico para otorgar el rol iam.serviceAccountTokenCreator

  2. Exporte la información de diagnóstico como un objeto a un depósito de Cloud Storage.

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

    El indicador opcional --collect-process-traces especifica si la herramienta de diagnóstico recopila un seguimiento de 10 minutos del sistema en ejecución, que incluye actividad de CPU, disco, archivos y red. En máquinas virtuales basadas en Windows, esto utiliza Windows Performance Recorder .

    Reemplace lo siguiente:

    • VM_NAME : nombre de la VM para recopilar información de diagnóstico

  3. El proceso de exportación de registros puede tardar unos minutos en completarse. Vea el estado mediante el comando gcloud compute instances get-serial-port-output .

  4. Compute Engine formatea el nombre del depósito que contiene la información de diagnóstico como diagnostic_logs_project_ PROJECT_NUMBER . Vea o descargue el depósito mediante la CLI de gcloud o, en la consola de Google Cloud, desde la página de Cloud Storage :

    Ir al almacenamiento

¿Qué sigue?