Recopilar información de diagnóstico

En este documento se describe cómo recoger información sobre una instancia de máquina virtual (VM) mediante una herramienta de diagnóstico. Usa la información que recogen las herramientas para solucionar problemas básicos antes de ponerte en contacto con el equipo de Asistencia.

La herramienta hace lo siguiente:

  • Recoge información solo de la máquina virtual que especifiques.

  • Almacena la información solo en tu proyecto.

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

Antes de compartir la información recogida con el equipo de Asistencia de Google, haz lo siguiente:

  1. Revisa la información confidencial o de identificación personal (IPI).

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

Información de diagnóstico recogida de la VM

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

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

Limitaciones

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

Antes de empezar

  • Compute Engine instala la herramienta de diagnóstico de forma predeterminada en las versiones públicas de las imágenes de Windows Server posteriores a v20190714. De lo contrario, si la versión de tu imagen de Windows Server es anterior a v20190714 o utilizas una imagen personalizada, instala la herramienta con el comando googet install google-compute-engine-diagnostics.
  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

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

      Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

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

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

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

  • roles/iam.serviceAccountTokenCreator en el proyecto

gcloud

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

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

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto
    • EMAIL: la dirección de correo a la que se le asignará el rol iam.serviceAccountTokenCreator

  2. Exporta la información de diagnóstico como un objeto a un segmento 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 recoge un registro de 10 minutos del sistema en ejecución, que incluye la actividad de la CPU, el disco, los archivos y la red. En las máquinas virtuales basadas en Windows, se usa Windows Performance Recorder.

    Haz los cambios siguientes:

    • VM_NAME: nombre de la VM de la que se va a recoger información de diagnóstico

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

  4. Compute Engine da formato al nombre del segmento que contiene la información de diagnóstico como diagnostic_logs_project_PROJECT_NUMBER. Para ver o descargar el segmento, usa la CLI de gcloud o, en laGoogle Cloud consola, ve a la página Cloud Storage:

    Ir a Almacenamiento

Siguientes pasos