Configura Stackdriver Debugger para Node.js

En esta página se describe cómo configurar el entorno y la aplicación de Node.js para usar Stackdriver Debugger. Para algunos entornos, debes especificar de forma explícita el nivel de acceso a fin de permitir que el agente de Stackdriver Debugger envíe datos. Recomendamos configurar el nivel de acceso más amplio posible y luego usar Cloud Identity and Access Management para restringir el acceso. De acuerdo con estas recomendaciones, configura el nivel de acceso para que sean todas las API de Cloud con la opción cloud-platform.

App Engine

  1. Usa npm para instalar el paquete:

    npm install --save @google-cloud/debug-agent
    
  2. Habilita el agente en la parte superior de la secuencia de comandos o punto de entrada principal de tu aplicación (pero después de @google/cloud-trace si también lo estás usando):

    require('@google-cloud/debug-agent').start();
    

Ahora puedes usar el depurador con tu aplicación.

Para que la página de Depuración en GCP Console muestre automáticamente el código fuente que coincide con la aplicación implementada, consulta Selecciona el código fuente de forma automática.

GKE

  1. Asegúrate de que se creó el clúster con uno de los siguientes niveles de acceso:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger

    Ejemplo:

    gcloud container clusters create EXAMPLE-CLUSTER-NAME \
        --scopes https://www.googleapis.com/auth/cloud-platform
    
  2. Sigue las instrucciones para Compute Engine.

Compute Engine

  1. Asegúrate de que tus instancias de Compute Engine se creen con la opción de nivel de acceso Permitir acceso completo a todas las API de Cloud, o que tengan uno de los siguientes niveles de acceso:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger
  2. Usa npm para instalar el paquete:

    npm install --save @google-cloud/debug-agent
    
  3. Habilita el agente en la parte superior de la secuencia de comandos o punto de entrada principal de tu aplicación (pero después de @google/cloud-trace si también lo estás usando):

    require('@google-cloud/debug-agent').start({
      serviceContext: {
        service: 'SERVICE',
        version: 'VERSION'
      }
    });
    

    Leyenda:

    • SERVICE es un nombre para tu aplicación, como MyApp, Backend o Frontend.
    • VERSION es una versión, como v1.0, build_147 o v20170714.

    Recomendamos configurarlas desde las variables de entorno para que no tengas que cambiar el código fuente con cada implementación.

Ahora puedes usar el depurador con tu aplicación.

Para que la página de Depuración en GCP Console muestre automáticamente el código fuente que coincide con la aplicación implementada, consulta Selecciona el código fuente de forma automática.

En el entorno local y en otros lugares

  1. Usa npm para instalar el paquete:

    npm install --save @google-cloud/debug-agent
    
  2. Descarga las credenciales de la cuenta de servicio.

    Con el propósito de usar el agente de Stackdriver Debugger para Node.js en máquinas no alojadas en Google Cloud Platform, el agente debe usar las credenciales de una cuenta de servicio de GCP a fin de autenticarse con el Servicio de Stackdriver Debugger.

    Usa la página de Cuentas de servicio de GCP Console a fin de crear un archivo de credenciales para una cuenta de servicio nueva o existente. La cuenta de servicio debe tener al menos la función Stackdriver Debugger Agent.

  3. Configura y habilita al agente con las credenciales descargadas:

    require('@google-cloud/debug-agent').start({
      projectId: 'your-project-id',
      keyFilename: '/path/to/key.json',
      serviceContext: {
        service: 'SERVICE',
        version: 'VERSION'
      }
    });
    

    Leyenda:

    • SERVICE es un nombre para tu aplicación, como MyApp, Backend o Frontend.
    • VERSION es una versión, como v1.0, build_147 o v20170714.

    Recomendamos configurarlas desde las variables de entorno para que no tengas que cambiar el código fuente con cada implementación.

Ahora puedes usar el depurador con tu aplicación.

En la página de Depuración de GCP Console, se pueden mostrar los archivos de origen local, sin subir, para el desarrollo local. Consulta Selecciona el código fuente de forma manual.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Stackdriver Debugger