Cómo filtrar logs con Stackdriver Logging

Clase 27 de 29Curso de Google App Engine

Contenido del curso

Resumen

Los equipos que dominan sus registros entienden mejor el estado de sus sistemas. Con Stackdriver Logging en Google Cloud Platform (GCP), puedes centralizar, filtrar y analizar logs con rapidez, crear alertas y conectar datos con BigQuery para análisis profundo. Todo en un flujo simple, estable y económico.

¿Qué es Stackdriver Logging y por qué importa?

Stackdriver Logging es el servicio de registro de actividades y eventos operativos de GCP. Te permite ver la secuencia de acciones que ocurren en tus servicios para detectar falencias, rastrear actividades ejecutadas y entender hacia dónde va tu aplicación.

  • Integración nativa con GCP: funciona con App Engine, máquinas virtuales, Cloud Storage, cuentas de servicio y más.
  • Retención de registros: guarda tus logs hasta por noventa días.
  • Alertas y búsquedas detalladas: configura condiciones y filtra con precisión.
  • Conexión con BigQuery: exporta para análisis de datos a gran escala.
  • Experiencia unificada: evita búsquedas manuales en archivos y rutas del sistema.

¿Cómo acceder y filtrar logs en Google Cloud Platform?

Desde el menú de GCP, busca Stackdriver y entra a Logging. La consola ofrece logs, logs basados en métricas, exportaciones y más opciones para gestionar tus registros.

¿Qué recursos y periodos se pueden seleccionar?

Puedes filtrar por el recurso que quieras observar.

  • Selecciona una versión en App Engine (por ejemplo, la versión con el 100% del tráfico).
  • Elige un bucket de Cloud Storage, el proyecto completo, un service account o Cloud debugger.
  • Ajusta el rango temporal: por ejemplo, ver la última hora y reproducir con play.

Además, define el tipo de log:

  • Actividad: acciones ejecutadas por usuarios o procesos internos.
  • Peticiones: solicitudes HTTP procesadas por tu aplicación.

Controla el nivel de severidad: debug, información, warning, error o errores críticos. Puedes verlos todos o filtrar solo los que importan.

¿Qué verás al expandir un registro?

Al abrir un log, no solo ves texto: aparece un objeto con metadatos y detalles técnicos. Esto facilita el diagnóstico.

  • Observa el registro de la aplicación con la secuencia de la actividad.
  • Ejemplo real: intento de actualización de un token de acceso para un API, mensajes de debug y el punto de log con los resultados.
  • Se detalla qué se consultó (por ejemplo, una lista de objetos y el tamaño obtenido).
  • Metadatos clave: proyecto, versión dos en App Engine y zona Estados Unidos dos.

¿Cómo ajustar rangos de tiempo y zona horaria?

Puedes filtrar por fecha de inicio y fecha de fin, además de seleccionar la zona horaria. Esto permite aislar incidentes y correlacionar eventos de forma precisa.

¿Cómo depurar errores y conectar con análisis avanzado?

Cuando ocurre un problema, puedes ver un detalle general marcado como error y revisar el stack trace completo. En un caso práctico, el fallo era por no importar Flask, un error de back end fácil de detectar al inspeccionar el trazo.

  • Revisa el stack trace para identificar líneas y causas probables.
  • Cambia de versión y compara comportamientos para aislar regresiones.
  • Instala agentes en máquinas virtuales para unificar los registros.

Para sacar mayor provecho:

  • Crea alertas con condiciones sobre tus logs o con métricas basadas en logs.
  • Configura exportaciones a BigQuery y otros destinos para explorar datos a escala.
  • Centraliza registros de múltiples servicios y recursos en un mismo panel.

Habilidades que te llevas:

  • Filtrar por recurso y versión en App Engine y otros servicios.
  • Elegir tipo de log y nivel de severidad según la necesidad.
  • Leer metadatos y objetos de log para entender cada evento.
  • Interpretar un stack trace y localizar errores como un import faltante en Flask.
  • Ajustar rangos de fechas y zona horaria para análisis contextual.
  • Instalar agentes en VM y exportar a BigQuery para análisis avanzado.

¿Ya probaste estos filtros y alertas en tus servicios de GCP? Comparte tus dudas o casos: será un gusto ayudarte a optimizar tus registros.