Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Usar el Explorador de registros

En esta guía, se muestra cómo buscar y ver registros con el Explorador de registros.

Antes de comenzar

Si envías registros de una cuenta de Amazon Web Services (AWS) a Logging, selecciona el proyecto de conector de AWS en el selector de proyectos de Google Cloud Console y, luego, usa el Visor de registros heredados. El proyecto de conector de AWS almacena el nombre del recurso de Amazon (ARN) para tu cuenta de AWS y vincula la cuenta de AWS a los servicios de Google Cloud. Para obtener más información, consulta Agrega un proyecto o una cuenta a un lugar de trabajo.

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 del Explorador de registros

El explorador de registros contiene los siguientes paneles:

  1. Barra de acciones
  2. Compilador de consultas
  3. Campos de registro
  4. Histograma
  5. Resultados de una consulta

Barra de acciones

Panel de la barra de acciones

En el panel Barra de acciones, puedes hacer lo siguiente:

  1. Opciones: Te permite ir al visor de registros heredados, enviar comentarios y ver un resumen de las nuevas características de Logging.
  2. Alcance específico: te permite definir el alcance de la búsqueda por registros en tu proyecto actual de Cloud o solo una o más vistas de almacenamiento. Para obtener más información, consulta Define mejor el alcance.
  3. Compartir vínculo: te permite crear una URL abreviada de la consulta actual y la copia en el portapapeles, lo que facilita compartir una consulta.
  4. Selector de intervalo de tiempo: Te permite restringir los resultados de la consulta por intervalo de tiempo. El intervalo de tiempo predeterminado es de una hora.
  5. Diseño de página: te permite habilitar y, también, inhabilitar los paneles Histogram y Explorador de campos de registros.
  6. Aprender: Te permite ver los vínculos a la documentación relevante.

Define mejor el permiso

Puedes definir mejor el alcance de los registros que se muestran en el Explorador de registros mediante la opción Definir mejor el alcance. Solo puedes buscar registros dentro del proyecto actual de Cloud o registros de búsqueda basados en 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 diálogo Definir mejor el alcance, selecciona una opción Alcance por.

    El diálogo Definir mejor el alcance

    • Alcance por proyecto de Cloud te permite buscar registros que genera el proyecto de Cloud actual.

    • Alcance por almacenamiento Te permite buscar registros en función de una o más vistas de almacenamiento. Para obtener más información sobre las vistas de registro, consulta Administra vistas de registro en tus depósitos de registros.

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

    El cuadro de diálogo enumera las vistas de almacenamiento que cumplen con las siguientes condiciones:

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

Compilador de consultas

Compilador de consultas

Desde el panel Compilador de consultas, puedes hacer lo siguiente:

  1. Campo de compilador de consultas: te permite compilar consultas mediante el lenguaje de consulta de Logging.
  2. Menús desplegables del compilador de consultas : Te permite agregar expresiones de consulta basadas enRecurso :Nombre del registro yGravedad las rutas "a GCP". Para obtener más información, consulta los menús desplegables del compilador de consultas.
  3. Recientes: te permite ver tus consultas recientes. Para obtener más información, consulta Consultas recientes.
  4. Guardado: te permite ver tus consultas guardadas y consultas que otros usuarios del proyecto de Cloud compartieron contigo. Para obtener más información, consulta Consultas guardadas y Consultas compartidas.
  5. sugerido: te permite ver las consultas sugeridas según los recursos de tu proyecto de Cloud. Para obtener más información, consulta Consultas sugeridas.
  6. Guardar: te permite guardar las consultas que se pueden ver y ejecutar desde la pestaña Guardados.
  7. Registros de transmisión: Te permite ver las entradas de registro mientras Logging las transfiere. Para obtener más información, consulta Registros de transmisión.
  8. Ejecutar: le permite ejecutar sus consultas después de haberlas creado en el campo compilador de consulta.

Transmite registros

Puedes transmitir todos tus registros a medida que Logging los transfiere o puedes agregar una consulta para transmitir solo aquellos que coinciden con la consulta.

Para transmitir registros según una consulta, agrega una consulta al campo del compilador de consultas y, luego, selecciona Transmitir registros. A medida que Logging transfiere los datos de los registros, solo los registros que coinciden con la consulta se muestran en el panel Resultado de la consulta. Si no se proporciona una consulta, Logging muestra cada registro a medida que se transfiere.

Agrega una consulta antes de seleccionar la opción para transmitir registros

Para detener la transmisión, selecciona Detener transmisión o desplázate hacia abajo dentro del panel Resultados de la consulta.

Campos de registro

El panel Campos de registro ofrece un resumen de alto nivel de los datos de registros y proporciona una forma más eficiente de definir mejor una consulta. Muestra el recuento de entradas de registro, ordenadas por recuento descendente, para el campo de registro dado, y proporciona resultados basados en la agregación para resource.type, resource.labels, logName. y severity. Los recuentos de campos de registro corresponden al rango de tiempo que usa el panel Histogram.

Cómo habilitar el panel del campo de registro

Para habilitar el panel Campos de registro, selecciona Diseño de página y, luego, la casilla de verificación Campos de registro. Aparece el panel Campos de registro.

Panel de campos de registro seleccionado

Para inhabilitar el panel Campos de registro, desmarca la casilla de verificación Campos de registro.

Características de los campos de registro

El panel Campos de registro se propaga y actualiza según una consulta ejecutada. Cuando hay una consulta vacía, el panel Campos de registro muestra el recuento de entradas de registro por tipo de recurso y campos de gravedad de registro.

panel de campos de registro.

Analizar registros mediante el panel de campos Log

Puedes agregar campos del panel Log fields al Compilador de consultas para acotar y definir mejor una consulta. Para hacerlo, haz clic en el valor de un campo en el panel Campos de registro. 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 del campo de registro se cargan de forma incremental a medida que las entradas de registro se analizan 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.

Histograma

El panel Histogram te permite visualizar la distribución de registros en el tiempo. El histograma se genera cuando ejecutas una consulta, lo que facilita ver las tendencias en los datos de registro y solucionar problemas.

Habilita el panel de histograma

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

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

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

Características del histograma

Panel de histograma.

  1. Barra de histogramas: Cada barra de histograma contiene un desglose de tres colores para los niveles de gravedad logarítmica registrados en el rango de tiempo de cada histograma. Los colores representan las siguientes niveles de registro:

    • Azul (baja gravedad) : predeterminado, depuración, información, aviso
    • Amarillo (gravedad media): advertencia
    • Rojo (altos altos): Error, crítico, alerta, emergencia

    Cuando seleccionas un histograma, puedes seleccionar Zoom a tiempo para realizar consultas en función del intervalo de tiempo capturado por el histograma.

  2. Ajustar intervalos de tiempo: te permite cambiar el intervalo de tiempo utilizado 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 en la consulta.

    Intervalo de tiempo ajustado con controladores

  3. Ventana de visualización del histograma: te permite ver el intervalo de tiempo de los registros que se muestran actualmente en el panel Resultados de la consulta. El viewport te ayuda a orientar los registros que estás viendo dentro del intervalo de tiempo más grande de tu consulta.

    El tamaño del 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 ventana de visualización.

Analizar registros mediante el panel de histograma

Para analizar los datos de registro con el histograma, desplázate sobre una barra en el panel Histogram y selecciona Zoom to time para acercar 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

Resultados de la consulta

Panel de resultados de la consulta

El panel Resultados de la consulta te permite explorar las entradas de registro que coinciden con tus expresiones de consulta.

  1. Query results (Resultados de consultas): Te permite ver los registros recuperados de tu consulta.
  2. Entradas de registro: Te permite ver las entradas de registro en el formato JSON estructurado.
  3. Expandir y contraer los resultados de la consulta: te permite expandir el panel de resultados de consulta para ver más entradas de registro.
  4. Zona horaria: Te permite cambiar la zona horaria en la que se muestran los registros.
  5. Datos de seguimiento: te permite ver los detalles de seguimiento y definir mejor tu consulta en función de ella. Para obtener más información, consulta Cómo ver los datos de seguimiento.
  6. Hide log summary (Ocultar resumen del registro): Te permite ocultar la línea de resumen de registro de los resultados de la consulta.
  7. Expandir o contraer los campos de registro anidados: Te permite expandir o contraer los campos anidados.
  8. Copy to clipboard (Copiar en el portapapeles): Te permite copiar la entrada de registro en su formato JSON.
  9. Copiar vínculo a una entrada de registro: Te permite compartir un vínculo a una entrada de registro. Para obtener más información, consulta Copia un vínculo a una entrada de registro.
  10. Saltar a ahora: te permite realizar una actualización forzada para incluir la hora actual. Si el selector de intervalo de tiempo usa un rango personalizado y se establece una hora de finalización, se 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.
  11. Acciones: te permite configurar una métrica basada en registros, crear un destino del receptor o descargar tus registros. Para obtener más información sobre la descarga de registros, consulta Descarga registros.
  12. 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 del registro. También te permite mostrar los registros más recientes primero o último. Para obtener más información sobre cómo agregar un campo de resumen, consulta Agrega campos de resumen.
  13. Fijar entrada de registro: te permite fijar una entrada de registro en los paneles Resultados de la consulta y Histograma. Según cómo se configure tu panel Resultados de la consulta, Logging fija el registro en la parte superior o al final del panel Resultados de la consulta. Para obtener más información, consulta Cómo fijar registros.

En el panel de resultados de la consulta, puedes hacer clic en los valores de un campo para elegir hacer lo siguiente:

Opciones después de seleccionar el valor del campo

  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.

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 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.

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 “Resultados” y en el panel del histograma.

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 Histogram, puedes seleccionar el registro fijado y, luego, seleccionar Zoom to log entry (Zoom a entrada de registro) para limitar el intervalo de tiempo del Histograma. panel. Esto te permite definir mejor tu consulta para aislar los registros cerca del registro fijado.

Se redujo el plazo del histograma.

Ve 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 vuelo, consulta Cómo ver los 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.

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 de Cloud. 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 una de las siguientes funciones de administración de identidades y accesos 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.

    Descarga registros con el botón Acción.

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

    Cuando guardas un archivo CSV y seleccionas Drive, puedes abrirlo 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 proyecto de Cloud y el selector de organización:

Se selecciona un proyecto desde el menú desplegable

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

Para obtener un proyecto de Cloud o un ID de organización desde cualquier parte de Google Cloud Console, expande la lista de proyectos de Cloud desde el selector de proyectos y organizaciones de Cloud y busca el ID del proyecto de Cloud en el 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:

  • ¿Se seleccionó el proyecto de Cloud correcto? De lo contrario, selecciona el proyecto de Cloud correcto del proyecto de Cloud y el selector de organización.

  • ¿Tu proyecto de Cloud usa recursos que generan registros y hay actividad en esos recursos? Incluso si el proyecto de Cloud es nuevo, debería tener registros de auditoría que registren el hecho de que se creó. Verifica que estés usando un recurso que genere registros. Para ello, ve a la sección "Asigna servicios a tipos de recursos" de la página de la 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.