Esta página se ha traducido con Cloud Translation API.
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 y 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

El panel Barra de acciones ofrece las siguientes funciones:

  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 sobre los permisos del alcance, 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 buscar registros en una o más vistas de almacenamiento. Para definir mejor el alcance del Explorador de registros, haz lo siguiente:

  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 de registro pertenecen al proyecto de Cloud seleccionado, o el proyecto de Cloud seleccionado ya enruta registros de forma previa a 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: te permite ejecutar tus consultas después de haberlas creado en el campo de compilador de consultas.

Transmite registros

Puedes transmitir tus registros como 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 mientras 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, 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 intervalo de tiempo que usa el panel Histogram.

Habilita el panel Campos 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 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 con los campos resource.type y severity.

panel de campos de registro.

Analizar registros mediante el panel Campos de registro

Puedes agregar campos del panel Campos de registro 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 manera automática como una expresión a la consulta original con el operador AND.

Cuando se ejecuta una consulta, se analizan las entradas de registro y se cambiará el recuento de campos del registro. Cuando se completa la consulta, 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. Barras de histogramas: Cada barra de histograma representa un intervalo de tiempo. Cada barra contiene un desglose de tres colores para los niveles de gravedad gravedad registrada en el intervalo de cada barra. Los colores representan las siguientes niveles de registro:

    • Azul: Importancia baja, como Predeterminado, Depuración, Información y Aviso.
    • Amarillo: Gravedad media, como Advertencia.
    • Rojo: Tiene el alto nivel de gravedad, como Error, Critical, Alerta y Emergencia.

    Puedes usar las barras de histogramas para analizar tus registros.

  2. Ajustar el intervalo 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. viewport de histogramas: Te permite ver el intervalo de tiempo de los registros, representados por las barras de histograma, que se muestran dentro del panel Resultados de la consulta. El viewport te ayuda a orientarte hacia los registros que estás viendo en un intervalo de tiempo mayor 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

Puedes usar el histograma para analizar los datos de tus registros. Por ejemplo, quizá una barra de histograma determinada te interesa en función de sus niveles de gravedad o el tamaño relativo a las otras barras. Puedes seleccionar la barra de histograma para ajustar los datos de registros que ves enResultados de la consulta panel de control con el panelDesplázate para ver el tiempo oHacer zoom.

La función Desplazar a tiempo te permite explorar tus datos de registros sin cambiar los valores de los paneles Histogram y Log fields. Cuando seleccionas la función Desplazamiento a la hora, ocurre lo siguiente:

  • Los datos de registro que ves en la ventana de visualización Resultados de la consulta se ajustan según el intervalo de tiempo capturado por la barra de histograma seleccionada.

    La consulta no se ejecuta, pero es posible que se produzca una nueva carga parcial de los datos para garantizar que veas registros en el viewport que se correspondan con el rango de tiempo de la barra de histograma seleccionado.

  • La URL de la consola se actualiza para contener el timestamp del registro más reciente capturado por el intervalo de tiempo de la barra de histograma seleccionada.

Para seleccionar la función Desplazarse hasta el momento, haz lo siguiente:

  1. Desplázate sobre una barra en el panel Histograma. Aparecerá un panel con información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Scroll to time.

    De forma alternativa, hacer clic en una barra de histograma, en lugar de colocar el cursor sobre ella, es equivalente a seleccionar Scroll to time.

Los modelosHacer zoom es similar aDesplazar a la hora, pero ejecuta una consulta sobre los datos de tus registros según el intervalo de tiempo capturado por la barra de histograma seleccionada. Cuando seleccionas la función Zoom a tiempo, ocurre lo siguiente:

  • Los datos de registro que ves en la ventana de visualización Resultados de la consulta se vuelven a cargar y se modifican según la restricción de rango de tiempo de la barra de histograma seleccionada.
  • La URL de la consola se actualiza para contener el timestamp del registro más reciente capturado por el intervalo de tiempo de la barra de histograma seleccionada.
  • El histograma cambia para mostrar solo los registros que tienen un valor timestamp que se encuentra dentro del rango de tiempo de la barra de histograma seleccionada.
  • El selector de intervalo de tiempo se actualiza al intervalo de tiempo que captura la barra de histograma seleccionada.
  • Los datos del panel Log fields se ajustan según el intervalo de tiempo capturado por la barra de histograma seleccionada.

Para seleccionar la función Zoom a tiempo, haz lo siguiente:

  1. Desplázate sobre una barra en el panel Histograma. Aparecerá un panel con información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Zoom to time.

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. Para obtener más información, consulta Cómo fijar registros.
  14. Desplazamiento del cursor Cuando se desplazan los registrosResultados de la consulta, la URL se ajusta para incluircursorTimestamp, que indica el parámetrotimestamp del registro más reciente que se muestra en laResultados de la consulta viewport.

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. Ocultar entradas coincidentes: te permite consultar las 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.

Fija entradas de registro

Fijar una entrada de registro te permite destacar una entrada de registro de interés.

Para fijar una entrada de registro, desplázate sobre la entrada de 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 .

Si fijas una entrada de registro y vuelves a ejecutar tu consulta, esta aparece en la parte superior o inferior del panel Resultados de la consulta, según cómo estén configurados tus datos de registros. También aparece un ícono de marcador en el panel Histogram basado en el timestamp de la entrada de registro fijada.

El explorador de registros muestra una entrada de registro fijada en el panel “Resultados” y en el panel del histograma.

Para no fijar la entrada de 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

Para ver la entrada de registro fijada en el contexto de tu recurso, 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 campo resource.type de la entrada de registro fijada y ejecuta la consulta. Ahora puedes ver la entrada de registro fijada en relación con su tipo de recurso.

Visualiza una entrada de registro fijada en el panel Histograma

Puedes usar el panel Histogram para destacar una entrada de registro fijada, desplazarte hacia ella y examinarla.

Con el panel Histogram, selecciona el ícono de marcador y, luego, elige una de las siguientes opciones de menú:

  • Desplazarse a la entrada de registro: Esta opción lleva la entrada de registro al viewport actual de Resultados de la consulta y te permite ver la entrada de registro fijada en el contexto de Nearby. registros.
  • Zoom para entrada de registro: Esta opción reduce el intervalo de tiempo que muestra el panel Histograma y te permite definir mejor tu consulta para aislar los registros cerca del registro fijado. las rutas "a GCP".

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 si estás usando un recurso que genera registros. Para ello, ve a la sección "Asigna servicios a tipos de recursos" en la página de lista de recursos supervisados.

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

  • Mira tus consultas de exclusión actuales para asegurarte de que los registros que buscas no estén excluidos 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.