Revisa registros con Stackdriver Logs Viewer

En este documento, se proporciona información sobre cómo usar el Visor de registros de Stackdriver para revisar los registros.

Antes de comenzar

  • Configura tu aplicación para usar la API de Logging Stackdriver.

  • Accede a tu cuenta para acceder a los recursos de Google Cloud Platform.

    • Selecciona Herramientas -> Herramientas de Google Cloud -> Administrar cuentas… para seleccionar tu cuenta.

Accede al Visor de registros

Para acceder al Visor de registros de Stackdriver, selecciona Herramientas -> Herramientas de Google¹Cloud -> Mostrar visor de registros de Stackdriver.

Se abrirá la pestaña Google Stackdriver Logging.

O, puedes abrir el visor de registros para un proyecto específico de Google Cloud Explorer, selecciona Herramientas -> Herramientas de Google Cloud -> Google Cloud Explorer. Haz clic derecho en el proyecto y selecciona Browse Stackdriver Logs (Examinar los registros de Stackdriver).

Imagen que muestra la vista general de la pestaña Visor de registros

Muévete por la interfaz

La interfaz de Visor de registros tiene los siguientes componentes principales:

  • Una barra de búsqueda para filtrar entradas de registro por etiqueta o búsqueda de texto.

  • Menú desplegable para filtrar la lista por recursos, registros y niveles de gravedad.

  • Menú desplegable Jump to time (Saltar a un momento específico), para ver una fecha y hora específica de registros.

  • Un botón Refresh (Actualizar) para recuperar los últimos accesos en orden descendente.

  • Secuencia de registro de carga automática que controla si mostrar o no nuevas entradas de registro a medida que llegan.

    • Cuando haces clic en Play (Reproducir) comienza la transmisión de los últimos registros. La transmisión se detendrá si te desplazas por la pantalla de registros.

    • Cuando haces clic en Pause (Pausa) detienes la secuencia de registros.

  • La tabla de resúmenes de registro en la que puedes hacer clic para ver los detalles completos de las entradas de registro individuales.

  • Una flecha desplegable Expandir todo en la esquina superior derecha del panel de entradas del registro muestra los detalles de todas las entradas del registro. Esta acción puede llevar algún tiempo si el panel tiene muchas entradas de registro.

  • Si está disponible, un vínculo de origen para ubicar el código fuente que genera la entrada de registro.

El Visor de registros te permite navegar al código fuente que genera una entrada de registro. Para habilitar esta característica, debes compilar tu proyecto a partir de un repositorio de Git local y agregar información de ubicación de origen para registrar las entradas.

Agrega la ubicación de origen a tu registro

Configura tu aplicación para proporcionar información de ubicación de código fuente en los registros:

  1. Escribe la información de ubicación para las entradas del registro, usa la siguiente muestra de GitHub.

  2. Implementa un archivo source_context.json en la raíz de la aplicación.

    Si publicas la solución a través de Cloud Tools for Visual Studio, la extensión genera y también se implementa automáticamente el archivo. O puedes generar el archivo tu mismo siguiendo las instrucciones para generar el archivo de fuente de contexto.

Después de completar estos pasos, las entradas del registro contienen un campo de ubicación de origen con información de archivo y línea. La línea de función opcional puede contener el nombre del ensamblaje, la versión o el nombre de la función.

Imagen que muestra la entrada de registro expandida y un vinculo para navegar al código fuente

Con un clic en el vínculo de origen, navegas hacia el código fuente si se puede acceder al archivo de origen.

Imagen que muestra el código fuente al que se accede desde el vinculo en la entrada de registro

Ve los registros

En la interfaz del Visor de registros, puedes filtrar las entradas del registro o buscar registros específicos para mostrar.

Filtra los registros

Puedes filtrar las entradas del registro para ver solo los registros que te interesan.

  • En el menú desplegable Instancia y tipo de recurso, puedes seleccionar todas las instancias de un tipo de recurso en particular que desees ver o ver una instancia específica. Para obtener una lista de los tipos de recursos, consulta Recursos supervisados y servicios.

  • En el menú desplegable de tipo de registro, selecciona los registros con nombre que deseas ver o selecciona Todos los registros. El menú solo muestra los registros que genera el recurso seleccionado.

  • En el menú desplegable de gravedad del registro, selecciona el nivel de gravedad que deseas ver. La selección de Todos los niveles de registro incluye entradas de registro que no tienen un nivel de gravedad.

  • En el menú desplegable Jump to time (Saltar a un momento específico), selecciona una fecha y hora. Elige si deseas ver los registros antes o después de la marca de tiempo seleccionada.

También puedes hacer clic en To Advanced Filter (Filtro avanzado) para acceder a la barra de filtro avanzado donde puedes filtrar las entradas del registro a través de consultas. Haz clic en el vínculo Advanced filter help (Ayuda de filtro avanzado) para obtener más información.

Imagen que muestra la barra de filtro avanzada

Busca los registros

En la barra de búsqueda, busca las palabras clave que aparecen en las entradas del registro.

Imagen que muestra resultados de la búsqueda

Muestra registros similares

Puedes hacer clic en el valor de un campo individual en la vista de la entrada de registro expandida y ocultar o mostrar todas las entradas de registro con el mismo valor:

Imagen que muestra cómo hacer clic para encontrar entradas de registro similares

Cuando muestras entradas de registro similares, se muestra la barra de filtro avanzada, en la que puedes editar el filtro y hacer clic en Submit Filters (Enviar filtros). Haz clic en el vínculo Advanced filter help (Ayuda de filtro avanzado) para obtener más información.