Recopila información de diagnóstico

En este documento, se describe cómo recopilar información sobre una instancia de máquina virtual (VM) mediante una herramienta de diagnóstico. Usa la información que recopila la herramienta para ayudar a solucionar problemas básicos antes de comunicarte con el equipo de Asistencia.

La herramienta hace lo siguiente:

  • Recopila información solo de la VM que especifiques.

  • Almacena la información solo en tu proyecto.

  • Almacena la información durante 10 días en un bucket de Cloud Storage cuya configuración predeterminada solo permite que tú accedas.

Antes de compartir la información recopilada con el servicio de Atención al cliente de Google, sigue estos pasos:

  1. Revisa los datos en busca de información confidencial o de identificación personal (PII).

  2. Borra o enmascara la información según sea necesario.

Información de diagnóstico recopilada de la VM

Esta herramienta de diagnóstico recopila la siguiente información:

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

Limitaciones

  • Solo puedes recopilar información de diagnóstico de las VM creadas basadas en 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 la v20190714. De lo contrario, si tu versión de imagen de Windows Server es anterior a v20190714 o si usas una imagen personalizada, instala la herramienta con el comando googet install google-compute-engine-diagnostics.
  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    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. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init
    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.

        Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

        gcloud init

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

Recopila información de diagnóstico de una VM

Ejecuta la herramienta de diagnóstico directamente desde la VM o de forma remota mediante Google Cloud CLI. En las VM basadas en Windows, busca la herramienta de diagnóstico en el directorio C:\Program Files\Google\Compute Engine\diagnostics.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

  • roles/iam.serviceAccountTokenCreator en el proyecto

gcloud

  1. Otorga la función iam.serviceAccountTokenCreator al proyecto:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto
    • EMAIL: Dirección de correo electrónico para otorgar la función iam.serviceAccountTokenCreator

  2. Exporta la información de diagnóstico como un objeto a un bucket de Cloud Storage:

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

    La marca opcional --collect-process-traces especifica si la herramienta de diagnóstico recopila un seguimiento de 10 minutos del sistema en ejecución, que incluye la actividad de la CPU, los discos, los archivos y la red. En las VM basadas en Windows, se usa Windows Performance Recorder.

    Reemplaza lo siguiente:

    • VM_NAME: Nombre de la VM de la que se recopila la información de diagnóstico

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

  4. Compute Engine da el formato diagnostic_logs_project_PROJECT_NUMBER al nombre del bucket que contiene la información de diagnóstico. Visualiza o descarga el bucket mediante gsutil tool o, en la consola de Google Cloud, desde la página de Cloud Storage:

    Ir a Almacenamiento

¿Qué sigue?