Usa el Explorador de registros

Antes de comenzar

No necesitas un lugar de trabajo para usar Logging, a menos que envíes registros de Amazon Web Services (AWS) a Logging.

Si usas un lugar de trabajo, Logging no combina los registros de los proyectos de Google Cloud supervisados. Debes seleccionar un proyecto de Cloud específico para ver sus registros.

Si usas AWS y un lugar de trabajo, selecciona el proyecto del conector de AWS para ver los registros de AWS.

Comenzar

Para navegar al Explorador de registros, haz lo siguiente:

  1. Ve al menú de navegación de Google Cloud y selecciona Logging > Explorador de registros:
    Ir al Explorador de registros
  2. Selecciona un proyecto de Google Cloud.
  3. En el menú Actualizar (Upgrade), cambia del Visor de registros heredados a Explorador de registros.

Ahora estás en el Explorador de registros.

Interfaz del Explorador de registros

La interfaz del Explorador de registros te permite recuperar registros, analizar datos de registros, y definir mejor tus parámetros de consulta.

Interfaz de usuario para el Explorador de registros

  1. Página del Explorador de registros: te permite compilar, analizar y definir mejor las consultas.
  2. Organización y selector de proyectos: Te permite ver los registros a nivel de organización o proyecto.
  3. Query builder (Compilador de consultas): Te permite compilar consultas mediante los menús desplegables o el lenguaje del compilador de consultas. También incluye pestañas para ver las consultas guardadas y recientes.
  4. Campos de registro (Beta): te permite ver resultados basados en la agregación para resource.type, resource.labels, logName y severity, y proporciona una forma más eficiente de definir mejor una consulta.
  5. Histogram (Histograma): Te permite visualizar la frecuencia de los datos de registros.
  6. Query results (Resultados de consultas): Te permite ver los registros recuperados de tu consulta.
  7. Entradas de registro: Te permite ver las entradas de registro en el formato JSON estructurado.
  8. Zona horaria: Te permite cambiar la zona horaria en la que se muestran los registros.
  9. Page layout (Diseño de página): Te permite habilitar o inhabilitar los paneles Histogram (Histograma) y Logs field explorer (Explorador del campo de registro).
  10. Selector de intervalo de tiempo: Te permite restringir los resultados por intervalo de tiempo. El intervalo de tiempo predeterminado es de una hora.
  11. Run query (Ejecutar consulta): Te permite ejecutar tus consultas después de haberlas creado en el panel de compilador de consulta.
  12. Jump to now (Pasar a los más recientes): Te permite realizar una actualización forzada para incluir la hora actual. Si el selector de intervalo de tiempo usa un intervalo personalizado y se establece una hora de finalización, ejecuta la consulta con un intervalo de tiempo predeterminado de una hora. De lo contrario, se actualiza con la fecha de inicio o la duración actuales y ejecuta la consulta.
  13. Acciones: Te permite configurar una métrica basada en registros, crear un destino del receptor o descargar tus registros.
  14. Configure (Configuración): Te permite agregar el valor de un campo de registro a la línea de resumen al comienzo o al final de la entrada de registro. También te permite optar por mostrar los registros más recientes ya sea el primero o el último.
  15. Hide log summary (Ocultar resumen del registro): Te permite ocultar la línea de resumen de registro de los resultados de la consulta.
  16. Expandir o contraer los campos de registro anidados: Te permite expandir o contraer los campos anidados.
  17. Copy to clipboard (Copiar en el portapapeles): Te permite copiar la entrada de registro en su formato JSON.
  18. Guardar: te permite guardar las consultas que se pueden ver y ejecutar desde la pestaña Guardados.
  19. Datos de seguimiento: Te permite ver los detalles de seguimiento y definir mejor tu consulta en función del seguimiento.
  20. Expandir y contraer los resultados de la consulta: Te permite expandir el panel de resultados de consultas para ver más entradas de registro.
  21. Ajustar el intervalo de tiempo: Te permite cambiar el intervalo de tiempo que se usa para las consultas mediante el ajuste de los controladores. Después de ajustar los controladores, haz clic en Ejecutar para actualizar el intervalo de tiempo usado en la consulta.
  22. Definir mejor el alcance: Te permite definir el alcance de la búsqueda según los registros del proyecto actual o solo una o más vistas de almacenamiento.

  23. Fijar la entrada de registro: Te permite fijar una entrada de registro en los paneles Histograma y Resultados de la consulta. Según cómo esté configurado el panel Resultados de la consulta, Logging fijará el registro en la parte superior o inferior del panel Resultados de la consulta.

  24. Copiar vínculo a una entrada de registro: Te permite compartir un vínculo a una entrada de registro.

  25. Ventana de visualización del histograma: Te permite ver el período de los registros que se muestran actualmente en el panel Resultados de la consulta.

Dentro del panel de resultados de la consulta, puedes hacer clic en los valores de un campo para realizar alguna de las siguientes acciones:

  1. Show matching entries (Mostrar las entradas coincidentes): Te permite consultar entradas de registro coincidentes.
  2. Hide matching entries (Ocultar entradas coincidentes): Te permite consultar entradas de registro que no coinciden con la expresión seleccionada.
  3. Add field to summary line (Agregar campo a línea de resumen): Te permite agregar el campo como una línea de resumen para registrar entradas.

Opciones después de seleccionar el valor del campo

Define mejor el permiso

Puedes definir mejor el alcance de los registros que se muestran en el Explorador de registros a través del panel Define mejor el permiso. Puedes buscar solo registros dentro del proyecto actual o buscar registros en función de una o más vistas de almacenamiento.

Para definir mejor el alcance del Explorador de registros, completa los siguientes pasos.

  1. En el menú de Logging, selecciona Explorador de registros.

    Ir al Explorador de registros

  2. Selecciona Define mejor el permiso.

  3. En el panel Definir mejor el alcance, selecciona la opción Alcance por.

    El panel define mejor el alcance

    • Alcance por proyecto: Te permite buscar registros que genera el proyecto actual.

    • Alcance por almacenamiento Te permite buscar registros en función de una o más vistas de almacenamiento.

  4. Si seleccionas Alcance por almacenamiento, selecciona uno o más depósitos que desees ver.

    El panel muestra vistas de almacenamiento que cumplen las siguientes condiciones:

    • El usuario tiene acceso a la vista de almacenamiento.
    • Los depósitos pertenecen al proyecto seleccionado o el proyecto seleccionado enruta registros a los depósitos de almacenamiento.
  5. Haga clic en Apply.

Agrega campos de resumen

Los campos de resumen te ayudan a detectar patrones en tus registros con mayor rapidez. Por ejemplo, en la siguiente imagen, se muestra el valor del campo de resumen resource.labels.pod_name agregado antes de los registros que contienen ese valor.

El Explorador de registros muestra registros precedidos por texto verde que muestra los nombres de pod.

Agrega un campo de resumen a partir de una entrada de registro

Para agregar un campo de resumen a una entrada de registro, completa los siguientes pasos:

  1. Haz clic en el botón expandir  para expandir una entrada de registro.

  2. Haz clic en el valor de un campo y, luego, selecciona Agregar campo a la línea de resumen.

    El campo de resumen ahora aparece antes de las entradas de registro que contienen ese campo.

Agrega un campo de resumen mediante el botón Configurar.

Para agregar un campo de resumen mediante el botón Configurar, completa los siguientes pasos:

  1. Haz clic en Configure (Configurar) y selecciona Manage Summary Fields (Administrar campos de resumen).

    Administrar campos de resumen se selecciona en el menú desplegable configurar

  2. Agrega campos.

    La selección del campo de resumen tiene las siguientes características:

    • Completar automáticamente mediante los registros que se muestran en el momento
    • Corrección de campos para caracteres legales entre comillas

      Por ejemplo, si escribes jsonPayload.id-field, se cambiará a jsonPayload."id-field".

  3. Haz clic en Truncar los campos de resumen para acortar la vista de los valores del campo de resumen. Luego, elige cuántos caracteres mostrar antes de que se trunque el campo y si debe mostrarse el principio o el final del campo.

  4. Haz clic en Aplicar.

    El campo de resumen ahora aparece antes de las entradas de registro que contienen ese campo.

Panel de campos de registro

El panel Campos de registro (Log fields) ofrece un resumen de alto nivel de los datos de los registros y proporciona una forma más eficiente para definir mejor una consulta. Muestra el recuento de entradas de registro, ordenadas de forma descendente, para el campo de registro dado. Los recuentos de campos de registro corresponden al intervalo de tiempo que usa el panel Histograma.

El panel Campos de registro (Log fields) se propaga y actualiza en función de una consulta ejecutada. Cuando hay una consulta vacía, el panel Campos de registro (Log fields) muestra los recuentos de entradas de registro por tipo de recurso y campos de gravedad de registro.

El panel de campos de registro muestra los datos del campo de registro.

Usa el panel de campos de registro

Puedes agregar campos del panel Campos de registro al Compilador de consultas para reducir y definir mejor una consulta. Para ello, haz clic en el valor de un campo en el panel Campos de registro (Log fields). Esto agrega el campo de registro al Compilador de consultas y ejecuta la consulta de forma automática; para ello, la agrega como una expresión a la consulta original mediante el operador AND.

Cuando se ejecuta una consulta, los recuentos de campos de registro se cargan de forma incremental a medida que se analizan las entradas de registro de forma progresiva. Una vez que se completa la consulta (cuando termina la barra de progreso azul), se muestran los recuentos totales de todos los campos de registro.

Panel de histograma

El panel de histograma te permite visualizar la distribución de los registros a lo largo del tiempo. Esto facilita la visualización de tendencias en los datos de tus registros y la solución de problemas.

Habilita el panel de histograma

Para habilitar el panel de histograma, selecciona Page Layout (Diseño de página) y, luego, marca la casilla de verificación Histogram (Histograma). Aparecerá el panel Histogram (Histograma).

Está abierto el diseño de la página y seleccionado histograma

Para inhabilitar el panel de histograma, desmarca la casilla de verificación Histogram (Histograma).

Usa el panel de histograma

Un histograma se genera cuando ejecutas una consulta. Muestra la frecuencia de las entradas de registro coincidentes para el intervalo de tiempo seleccionado.

Analiza registros

Para analizar tus datos de registro, coloca el cursor sobre una barra en el panel Histograma y selecciona Jump to time (Saltar a un momento específico) para explorar un intervalo de tiempo más reducido. Esto ejecuta una nueva consulta con esa restricción de intervalo de tiempo.

Registra los histogramas que muestran el cuadro de diálogo emergente para saltar a un momento específico

En el panel Histograma, se muestra una ventana de visualización que refleja el intervalo de tiempo de los registros que se muestran en el panel Resultados de la consulta. El viewport te ayuda a orientar los registros que ves dentro del período más amplio de la consulta.

El tamaño de viewport se basa en la duración entre el timestamp máximo y el mínimo de las entradas de registro que se muestran en el panel Resultados de la consulta.

El panel de histograma muestra la viewport.

Datos de seguimiento

Cuando una entrada de registro contiene trace y el campo relacionado con la latencia, aparecen los íconos de latencia y de seguimiento.

Pantalla de entrada de registro que contiene datos de seguimiento

Cuando una entrada de registro contiene solo el campo trace, solo aparecerá el ícono de seguimiento.

Pantalla de entrada de registro que contiene solo el campo de seguimiento, tiene el ícono de seguimiento.

Para ver los datos de seguimiento relacionados con la entrada de registro, haz clic en el ícono de seguimiento. Tienes las siguientes opciones:

  • Ver detalles de seguimiento: Muestra el intervalo superior y los seguimientos secundarios junto con los detalles sobre el seguimiento. Para ver más detalles sobre el seguimiento, haz clic en Ver en Trace a fin de navegar a Cloud Trace. Para obtener más información sobre el contenido en el panel de salida, consulta Ver detalles de seguimiento.
.
  • Mostrar todos los registros de este seguimiento: Define mejor y ejecuta la consulta. Para ello, agrega el campo trace configurado al identificador de seguimiento asociado con la entrada de registro.

  • Mostrar solo las solicitudes con seguimiento: Define mejor y ejecuta la consulta. Para ello, agrega el campo traceSampled configurado como True. Para obtener más información sobre el muestreo, ve a Tasa de muestreo.

Fijar registros

Fijar un registro te permite destacar una entrada de registro de interés. Para fijar un registro, desplázate sobre el registro que quieres fijar y, luego, selecciona el ícono de fijar . Después de fijar una entrada de registro, se oscurece el fondo y se muestra un ícono de marcador .

Una vez que fijas un registro y vuelves a ejecutar tu consulta, el registro fijado aparecerá en la parte superior o inferior del panel Resultados de la consulta, según cómo se configuren tus registros. También aparece un ícono de marcador en el panel Histograma según el timestamp del registro fijado.

El Explorador de registros muestra una entrada de registro fijada en el panel

Para dejar de fijar el registro, selecciona el ícono de marcador y, luego, No fijar la entrada de registro.

Ver una entrada de registro fijada en su contexto de recursos

Puedes ver el registro fijado en el contexto de recursos, lo que te permite examinar las entradas de registro alrededor del registro fijado que tienen el mismo tipo de recurso que el registro fijado.

Para ver el registro fijado en el contexto de los recursos, selecciona el ícono de marcador y, luego, selecciona Fijar y mostrar entradas de registro de recursos.

Se selecciona la opción de fijar y mostrar en el contexto de recursos.

Logging propaga el Compilador de consultas con el tipo de recurso del registro fijado y ejecuta la consulta. Ahora puedes ver la relación de registro fijada con el tipo de recurso.

Visualiza una entrada de registro fijada en el panel Histograma

Con el panel Histograma, puedes seleccionar el registro fijado y, luego, Zoom a registro de entrada para reducir el plazo que el panel Histogram muestra. Esto te permite definir mejor tu consulta para aislar los registros cerca del registro fijado.

Se redujo el plazo del histograma.

Para compartir un vínculo a un registro, expande una entrada de registro y, luego, selecciona Copiar vínculo. El vínculo se copió en el portapapeles. Ahora puedes enviar el vínculo a los usuarios que tienen acceso al proyecto. Cuando un usuario pega el vínculo en un navegador o lo selecciona, Logging fija la entrada de registro en su panel Resultados de la consulta.

Copia el vínculo para compartir la entrada de registro con otros.

Descarga registros

Puedes descargar tus registros en formato CSV o JSON. Necesitas las siguientes funciones para descargar registros:

  • Administrador de Logging (roles/logging.admin)
  • Descriptor de acceso de vista de registros (roles/logging.viewAccessor)

Para descargar tus registros, haz lo siguiente:

  1. Selecciona Acciones y, luego, Descargar registros.

    Descargar registros con el botón Acción

  2. En el diálogo Descargar registros, selecciona el formato CSV o JSON y, luego, selecciona descargar los registros en tu computadora o Drive, o verlos en una pestaña nueva.

    Cuando guardas un archivo CSV y seleccionas Drive, puedes abrir el archivo en Hojas de cálculo.

Soluciona problemas

En esta sección, se proporcionan instrucciones para solucionar problemas comunes cuando se usa el Explorador de registros.

Selecciona un proyecto o una organización de Cloud

Para seleccionar un proyecto de Cloud desde cualquier parte de Google Cloud Console, por ejemplo, desde el Explorador de registros, usa el selector de proyectos y organizaciones:

Se selecciona un proyecto desde el menú desplegable

Obtén el ID de organización o del proyecto de Cloud

Para obtener un ID de organización o del proyecto de Cloud desde Google Cloud Console, expande la lista de proyectos del selector de proyecto y organización, y busca el ID del proyecto en la columna ID:

Se muestra el ID del proyecto

No se pueden ver las entradas de registro

Si no ves ninguna entrada de registro, verifica lo siguiente:

  • ¿Está seleccionado el proyecto correcto? Si no lo está, selecciona el proyecto correcto en el selector de proyecto y organización.

  • ¿Tu proyecto usa recursos que generan registros? ¿Hay actividad en esos recursos? Incluso si el proyecto es nuevo, debe tener registros de auditoría que registren su creación. Para verificar que estás usando un recurso que genera registros, ve a la sección "Asigna servicios a tipos de recursos" en la página Lista de recursos supervisados.

  • ¿El intervalo de tiempo es demasiado reducido? Verifica que el intervalo de tiempo en tu consulta sea correcto.

  • Visualiza tus consultas de exclusión actuales para asegurarte de que los registros que buscas no se excluyan de forma accidental.

Mi consulta es correcta, pero aún no veo entradas de registro

  • No puedes ver las entradas de registro anteriores al período de retención de Logging. Consulta Períodos de retención de registros para conocer el período de retención de registros vigente.

  • Durante períodos de mucha carga, puede haber demoras en el envío de registros a Logging o en la recepción y visualización de los registros.

  • El Explorador de registros no muestra las entradas de registro con marcas de tiempo en el futuro hasta que el tiempo actual lo “alcance”. Esta es una situación poco común, posiblemente causada por un desvío temporal en la aplicación que envía los registros.

Obtén asistencia

Para obtener información sobre cómo obtener asistencia, consulta la página de asistencia de Google Cloud's operations suite.