Revisa registros con el Explorador de registros de Cloud Logging

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

Antes de comenzar

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

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

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

Accede al Explorador de registros

Para acceder al Explorador de registros de Cloud Logging, selecciona Herramientas -> Herramientas de Google Cloud -> Mostrar explorador de registros de Stackdriver.

Se abrirá la pestaña Google Stackdriver Logging.

O, puedes abrir el Explorador de registros de un proyecto específico desde 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 descripción general de la pestaña Explorador de registros

Muévete por la interfaz

La interfaz del Explorador 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 Explorador 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.

Después de completar estos pasos, las entradas del registro contienen un campo de sourceLocation con información de sourceLocation y sourceLocation. 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 Explorador 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.