Guía de inicio rápido

En esta Guía de inicio rápido se muestra cómo usar Stackdriver Debugger para inspeccionar el estado de una aplicación de Python simple que se ejecute en el entorno estándar de App Engine. Se demuestra cómo capturar la pila de llamadas y las variables locales por medio del uso de instantáneas de depuración y cómo incorporar el registro en la aplicación en ejecución mediante puntos de registro de depuración.

Antes de comenzar

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a GCP project.

    Go to the Project selector page

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Asegúrate de que el siguiente software esté instalado en tu sistema local:

Implementa en App Engine

Comienza por implementar una aplicación Python 2.7 en el entorno estándar de App Engine.

  1. Clona el proyecto a un repositorio local.

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
    
  2. Ve al directorio que contiene el código de muestra.

    cd python-docs-samples/appengine/standard/hello_world
    
  3. Inicializa SDK de Google Cloud con tu ID del proyecto.

    gcloud config set project [your-project-id]
    
  4. Implementa tu aplicación.

    gcloud app deploy --version=v1
    
  5. Envía una solicitud a la aplicación para probarla.

    gcloud app browse
    

La respuesta debe contener un mensaje de Hello World. Si tienes algún problema en estos pasos, consulta la Guía de inicio rápido para el entorno estándar de App Engine de Python.

Observa las fuentes implementadas

Una vez que implementas la aplicación de Python, puedes ver las fuentes implementadas en la página de depuración de Google Cloud Platform Console.

  1. Navega a la página de Depuración en Google Cloud Platform Console.

  2. Asegúrate de tener seleccionado el proyecto correcto.

  3. Asegúrate de que esté seleccionada la opción default - v1 (100%) en el menú en la parte superior. Esto indica qué servicio/versión de la aplicación vas a depurar.

  4. Asegúrate de que Deployed Files esté seleccionado en el menú de la izquierda. En este panel se muestra el código fuente de la aplicación de Python que implementaste.

  5. Selecciona main.py de la lista de archivos implementados para ver su contenido.

Ahora estás listo para tomar instantáneas de depuración y para incorporar puntos de registro de depuración.

Toma una instantánea de depuración

Una instantánea de depuración captura las variables locales y la pila de llamadas en una ubicación de línea específica en tu código fuente. Selecciona la pestaña Snapshot (Instantánea) en el panel de la derecha para tomar instantáneas de depuración.

  1. Haz clic en el número de la primera línea dentro de la función get en la clase MainPage. Aparecerá una flecha azul que indica que se configuró una ubicación de instantánea. En el panel de resultados a la derecha se muestra el mensaje “Waiting for snapshot to hit” (Esperando que coincida la instantánea).

    La ubicación de la instantánea se configura en la línea 20

  2. Selecciona el panel Snapshot History (Historial de instantáneas) en la parte inferior de la página para ver si la instantánea se configuró correctamente.

    Se configuró la instantánea

  3. Envía una solicitud a la aplicación para activar la instantánea.

    gcloud app browse
    
  4. En el panel de resultados se muestra la pila de llamadas y los valores de las variables locales en el alcance en ese punto del código y en ese momento.

    Panel de resultados con variables locales

  5. Agrega la siguiente expresión y configura otra instantánea.

    self.request.environ['HTTP_USER_AGENT']
    
  6. Envía una solicitud nueva para activar las instantáneas nuevas.

    gcloud app browse
    
  7. En el panel de resultados ahora también se muestra el resultado de la expresión. En este caso, el valor es el siguiente:

    Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6)
    AppleWebKit/537.36 (KHTML, like Gecko)
    Chrome/62.0.3202.94 Safari/537.36
    

Incorpora un punto de registro de depuración

Un punto de registro de depuración te permite incorporar registros a tu aplicación en ejecución sin tener que reiniciarla. Selecciona la pestaña Logpoint (Punto de registro) en el panel a la derecha para incorporar los puntos de registro de depuración.

  1. Haz clic en el número de la primera línea dentro de la función get en la clase MainPage.

  2. Aparecerá un cuadro de texto intercalado. Para incorporar un punto de registro, propágalo de la siguiente manera y presiona Intro:

    if (True) logpoint("Browser = {self.request.environ['HTTP_USER_AGENT']}")
    

    Panel de depuración con punto de registro incorporado

  3. Selecciona el panel Logpoint History (Historial de puntos de registro) en la parte inferior de la página para ver si tu punto de acceso se incorporó con éxito.

    Se configuró un punto de registro

  4. Envía una solicitud a la aplicación para activar el punto de registro.

    gcloud app browse
    
  5. Selecciona el panel Logs (Registros) en la parte inferior de la página para ver los registros impresos por tu punto de registro.

    Registros del punto de registro incorporados a la línea 20

Limpieza

Para evitar que se apliquen cargos a tu cuenta de GCP por los recursos que se utilizan en esta guía de inicio rápido, realiza los siguientes pasos:

  1. Navega a la página de Proyectos de GCP Console.

  2. Haz clic en el ícono de la papelera () al lado del proyecto.

  3. Escribe el nombre del proyecto para confirmar el cierre.

¿Qué sigue?

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

Enviar comentarios sobre...

Documentación de Stackdriver Debugger