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 recopilan las herramientas para solucionar problemas básicos antes de comunicarte con la Atención al cliente de Cloud.

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 al que, de forma predeterminada, solo tú puedes acceder.

Antes de compartir la información recopilada con el equipo de Atención al cliente, haz lo siguiente:

  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.

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 verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña según cómo planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

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

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

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 Compute Engine recopila estos datos, consulta el repositorio público de GitHub.

Limitaciones

  • Solo puedes recopilar información de diagnóstico de las VM creadas basadas en Windows Server.

Roles obligatorios

Para obtener los permisos que necesitas para ejecutar la herramienta de diagnóstico con Google Cloud CLI, pídele a tu administrador que te otorgue el rol de IAM de Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para adjuntar información de diagnóstico a un caso de asistencia, también necesitas el rol de Editor de asistencia técnica (roles/cloudsupport.techSupportEditor).

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.

gcloud

  1. Si aún no lo hiciste, otorga el rol iam.serviceAccountTokenCreator en el proyecto a la cuenta de usuario o de servicio que ejecutará el comando gcloud compute diagnose export-logs:

    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 con el comando diagnose export-logs.

    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, el disco, los archivos y la actividad de red. En las VMs basadas en Windows, se usa la Grabadora de rendimiento de Windows.

    Reemplaza VM_NAME por el nombre de la VM de la que deseas recopilar información de diagnóstico.

  3. El proceso de exportación de registros puede tomar unos minutos en completarse. Para ver el estado, usa 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 con la gcloud CLI o, en la consola deGoogle Cloud , desde la página de Cloud Storage:

    Ir a Almacenamiento

De forma local (solo para Windows)

Para ejecutar la herramienta de diagnóstico desde una VM de Windows, haz lo siguiente:

  1. Conéctate a la VM de Windows.

  2. Abre una ventana del símbolo del sistema o de PowerShell con privilegios de administrador.

  3. Navega al directorio que contiene la herramienta de diagnóstico:

    cd "C:\Program Files\Google\Compute Engine\diagnostics"

  4. Ejecuta la herramienta de diagnóstico:

    .\diagnostics.exe

    Después de que la herramienta termine de ejecutarse, guardará la información de diagnóstico recopilada en el archivo comprimido logs.zip en tu directorio de trabajo actual.

Marcas opcionales:

  • -trace: Captura información de seguimiento adicional. La herramienta captura un seguimiento de 10 minutos del sistema con la Grabadora de rendimiento de Windows, que incluye la actividad de la CPU, el disco, los archivos y la red.

Adjunta información de diagnóstico a un caso de asistencia

Si tienes un caso abierto con la Atención al cliente de Cloud, puedes adjuntar información de diagnóstico directamente al caso cuando la recopiles. Esta opción te evita tener que descargar el archivo de Cloud Storage y adjuntarlo al caso por tu cuenta.

La información de diagnóstico se adjunta al caso sin un paso de revisión. Si necesitas revisar la información o quitar la información confidencial o de identificación personal (IIP) antes de compartirla, no uses esta opción. En su lugar, recopila la información como se describe en Recopila información de diagnóstico de una VM, revisa el archivo en Cloud Storage y, luego, adjúntalo al caso.

Antes de adjuntar información de diagnóstico a un caso de asistencia, asegúrate de lo siguiente:

  • Tu organización tiene un plan de Atención al cliente que te permite crear casos de asistencia técnica (Asistencia estándar, mejorada o premium).
  • Tienes el rol de Editor de asistencia técnica (roles/cloudsupport.techSupportEditor). Si el caso pertenece a una organización, necesitas el rol en la organización.
  • La API de Cloud Support está habilitada en el proyecto.
  • El estuche está abierto.

Para adjuntar información de diagnóstico a un caso de asistencia, haz lo siguiente:

  1. Asegúrate de haber instalado el componente de comandos alfa:

    gcloud components install alpha

  2. Sigue los pasos que se indican a continuación para ejecutar el comando gcloud alpha compute diagnose export-logs con la marca --support-case:

    gcloud alpha compute diagnose export-logs INSTANCE_NAME \
    --zone=ZONE \
    --support-case=CASE_NUMBER

    Reemplaza lo siguiente:

    • INSTANCE_NAME: Es el nombre de la instancia de procesamiento de Windows Server.
    • ZONE: La zona de la instancia.
    • CASE_NUMBER: Es el número de un caso de asistencia abierto.

    El comando verifica que el caso exista y que puedas agregarle archivos adjuntos antes de que comience a recopilar información. Luego, espera a que la instancia termine de recopilar la información de diagnóstico, lo que puede tardar unos minutos, y sube el archivo al caso. El archivo también permanece en el bucket de Cloud Storage, al igual que cuando omites la marca --support-case.

¿Qué sigue?