Visualiza registros con el explorador de registros

En este documento, se proporciona una descripción general del Explorador de registros en la consola de Google Cloud, que puedes usar para recuperar, ver y analizar datos de registro. El Explorador de registros te permite encontrar y ver tus registros para que puedas solucionar problemas. También puedes leer registros con la API de Logging y Google Cloud CLI.

Cada elemento del histograma muestra la cantidad aproximada de entradas de registro recibidas en el intervalo de tiempo asociado con el elemento. Para obtener un recuento exacto de la cantidad de entradas de registro recibidas en un intervalo de tiempo, usa el Análisis de registros o copia los registros en un bucket de Cloud Storage.

Para realizar operaciones agregadas en tus entradas de registro, como contar la cantidad de entradas de registro que contienen un patrón específico, actualiza el bucket de registros para usar el Análisis de registros y, luego, ejecuta consultas desde la página Análisis de registros. Puedes seguir usando el Explorador de registros a fin de ver los registros en los buckets de registros que se actualizaron para usar el Análisis de registros. Para obtener más información, consulta la Descripción general del análisis de registros.

Comenzar

Si quieres obtener los permisos que necesitas para ver los registros en el Explorador de registros, pídele a tu administrador que te otorgue los siguientes roles de IAM:

  • Consulta todos los registros del bucket _Required y los registros en la vista _Default del bucket _Default: Visor de registros (roles/logging.viewer) en tu proyecto.
  • Consulta todos los registros de los buckets _Required y _Default, incluidos los registros de acceso a los datos: Visualizador de registros privados (roles/logging.privateLogViewer) en tu proyecto.
  • Consulta los registros almacenados en una vista de registro en un bucket de registros definido por el usuario: Descriptor de acceso de vista de registros (roles/logging.viewAccessor) en el proyecto que contiene el bucket definido por el usuario. Si tienes el rol Descriptor de acceso de vista de registros sin ninguna condición adjunta, puedes ver los registros almacenados en cualquier vista de registro en buckets de registros definidos por el usuario. Consulta Lee registros de un bucket para ver un ejemplo.
  • Consulta los campos LogEntry restringidos en un bucket: Descriptor de acceso del campo de registro (roles/logging.fieldAccessor) en tu proyecto. Para obtener más información, consulta Configura el acceso a nivel de campo.

Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Para comenzar a usar el Explorador de registros, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  2. Selecciona el proyecto de Google Cloud adecuado.

    Si usas Amazon Web Services Elastic Compute Cloud (AWS EC2), tus entradas de registro se encuentran en el proyecto de conector de AWS que vincula tu cuenta de AWS con los servicios de Google Cloud.

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 búsqueda.

Interfaz de usuario para el explorador de registros

El Explorador de registros contiene las siguientes secciones, que se detallan en esta página:

  1. Barra de herramientas de acción
  2. Panel Consulta
  3. Barra de herramientas Resultados
  4. Panel Campos de registro
  5. Histograma
  6. Panel Resultados de la consulta

Barra de herramientas de acción

Con las funciones de la barra de herramientas Acción, puedes hacer lo siguiente:

  • Define mejor el permiso: Define el alcance de la búsqueda según los registros de tu proyecto actual de Google Cloud únicamente o una o más vistas de almacenamiento. Para obtener más información sobre los permisos, consulta Define mejor el alcance.
  • Más información: Consulta los vínculos a documentación y temas relevantes.
  • Compartir vínculo: Crea una URL abreviada de la consulta actual y cópiala en el portapapeles, lo que facilita compartir una consulta. La URL copiada tiene el intervalo de tiempo absoluto correspondiente representado por el intervalo de tiempo actual de tu consulta; por ejemplo, 7:49:37 PM - 8:49:37 PM.

Definir mejor el permiso

Si tus registros se almacenan en buckets de registros, puedes verlos en el Explorador de registros. Según el proyecto que hayas seleccionado, es posible que debas ajustar el permiso del Explorador de registros para ver los registros almacenados en ciertos buckets de registros.

De forma predeterminada, el Explorador de registros muestra todos los registros que generan los recursos del proyecto actual o que se enrutan directamente al proyecto actual y, luego, se almacenan en cualquier bucket de registros. De forma predeterminada, el Explorador de registros no muestra los registros que generan los recursos de otro proyecto y, luego, los enruta a un bucket de registros en el proyecto actual.

Para personalizar qué registros se muestran en el Explorador de registros, usa el botón Define mejor el permiso en la barra de herramientas Acción:

  • Para ver todos los registros que se generan o enrutan directamente al proyecto actual, selecciona Limitar alcance por proyecto actual.

    Un receptor de registros puede enrutar los registros a un bucket de registros en el proyecto actual, a un bucket de registros en un proyecto diferente o a un proyecto diferente. Para obtener más información, consulta Enruta registros a destinos compatibles.

  • Para ver ciertos registros almacenados en buckets de registros en el proyecto actual, selecciona Limitar alcance por almacenamiento y elige una o más vistas de registro. Usa esta opción cuando quieras un control más detallado sobre quién tiene acceso a qué registros en los buckets de registros en el proyecto actual.

    Para obtener más información sobre cómo crear y administrar vistas de registro, consulta Configura vistas de registro en un bucket de registros.

  • Para ver determinados registros almacenados en buckets de registros que se encuentran en proyectos diferentes, selecciona Limitar alcance por almacenamiento, haz clic en Importar proyecto en el selector de proyectos y vistas de registro, y selecciona una o más vistas de registro. Usa esta opción si tu organización tiene varios proyectos, cada uno de los cuales genera sus propios registros únicos, y deseas ver esos registros juntos en el Explorador de registros.

    Por ejemplo, para ver todos los registros almacenados en un bucket de registros, selecciona la vista _AllLogs:

    Diálogo Definir mejor el permiso que muestra el proyecto y el selector de vista de registro.

Panel Consulta

Usa las funciones del panel Consulta para hacer lo siguiente:

  • Pestaña Consulta: Crea y define mejor las consultas con las siguientes funciones:

    • Selector de intervalo de tiempo: Especifica un intervalo de tiempo para los registros que deseas ver. Para obtener más información, consulta Usa el selector de intervalo de tiempo.

    • Cuadro de texto de búsqueda: Encuentra entradas de registro que coincidan con tus frases o términos de búsqueda. Para obtener más detalles, consulta Busca texto en los campos de registro.

    • Menús de filtro: Compila consultas en función de Recurso, Nombre del registro y Gravedad. Para obtener más información, consulta Cómo usar los menús de filtro.

    • Campo de editor de consultas: crea consultas avanzadas con el lenguaje de consulta de Logging. Para obtener más información, consulta Cómo escribir consultas avanzadas.

  • Pestaña Recientes: Consulta las consultas que ejecutaste recientemente. Para obtener más información, consulta Cómo usar las consultas recientes.

  • Pestaña Saved: Visualiza las consultas guardadas y las consultas que otros usuarios del proyecto de Google Cloud compartieron contigo. Si deseas obtener más información, lee Cómo guardar consultas y Cómo compartir consultas.

  • Pestaña Suggested: Consulta consultas sugeridas en función de los recursos de tu proyecto de Google Cloud. Para obtener más información, consulta Cómo usar las consultas sugeridas.

  • Pestaña Biblioteca: Visualiza y ejecuta las consultas que proporciona Google según tus casos de uso. Para obtener más información, lee Selecciona consultas de la biblioteca.

  • Guardar (Save): Guarda las consultas que se pueden ver y ejecutar desde la pestaña Guardados.

  • Clear query: Borra y restablece las selecciones que hiciste cuando compilaste una consulta en el panel Query.

  • Transmitir registros: Visualiza las entradas de registro a medida que Logging las almacena en buckets de registro. Para obtener más información, consulta Transmite registros.

  • Ejecutar consulta: Ejecuta tus consultas después de haberlas creado en el panel Consulta.

Si no ves el campo del editor de consultas, habilita Mostrar consulta. Si agregas términos de búsqueda en el cuadro de texto de búsqueda, esos términos también aparecen en el campo del editor de consultas y se evalúan como parte de la expresión de consulta.

Después de revisar tu consulta, haz clic en Ejecutar consulta. Los registros que coinciden con tu consulta se enumeran en el panel Resultados de la consulta. Los paneles Histograma y Campos de registro también se ajustan según la expresión de la consulta.

Transmitir registros (Stream logs)

Puedes transmitir registros, ya que Logging los almacena en buckets de registros o puedes agregar una consulta para transmitir solo aquellos registros que coincidan con la consulta.

Para transmitir registros basados en una consulta, agrega una consulta en el panel Consulta y, luego, selecciona Transmitir registros. Como Logging almacena los datos de registro en buckets de registros, en el panel Resultados de la consulta solo se muestran los registros que coinciden con la consulta. Si no se proporciona una consulta, Logging muestra cada registro a medida que están almacenados.

Para detener la transmisión, haz clic en Detener transmisión o desplázate por el panel Resultados de la consulta.

Barra de herramientas de Resultados

En la barra de herramientas Resultados, tienes las siguientes opciones:

  • Campo de registros: Oculta o muestra el panel Campo de registros en el diseño de la página del Explorador de registros. Para obtener más información, consulta la sección Campo de registro de este documento.
  • Histograma: Oculta o muestra el panel Histograma del diseño de la página del Explorador de registros. Para obtener más información, consulta la sección Histograma de este documento.
  • Analizar resultados: Agrega y organiza los resultados de tu consulta con el Análisis de registros. Este botón solo es visible si el permiso que seleccionaste contiene un bucket de registros que se actualizó para usar el Análisis de registros. Para obtener más información, consulta la sección Analiza los resultados de este documento.
  • Crear métrica: Configura una métrica basada en registros.
  • Crear alerta: Configura una alerta basada en registros.
  • Pasar al momento actual: Realiza una actualización forzada de los resultados de la consulta para incluir la hora actual. Si el selector de intervalo de tiempo usa un rango 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. Ten en cuenta que la expresión de consulta no se altera cuando usas esta función.
  • Más acciones: Usa estas opciones adicionales para administrar alertas basadas en registros o crear un receptor.

Analizar resultados

Puedes agregar, analizar y graficar tus datos de registro mediante consultas en SQL en la página Análisis de registros cuando tu proyecto contenga buckets de registros que se actualicen para usar el Análisis de registros. Para ir a la página Análisis de registros del Explorador de registros, en la barra de herramientas Resultados, haz clic en Analizar resultados.

El botón Analizar resultados solo es visible cuando el permiso que seleccionaste contiene un bucket de registros que se actualizó para usar el Análisis de registros. Por ejemplo, si seleccionaste Limitar alcance por permiso de almacenamiento con el botón Definir mejor el permiso, se mostrará el botón Analizar resultados cuando se actualice al menos un bucket dentro del permiso de almacenamiento para usar el análisis de registros. Si quieres obtener información sobre cómo actualizar un bucket de registros para usar el Análisis de registros, consulta Actualiza un bucket de registros para usar el Análisis de registros.

Lo siguiente ocurre cuando haces clic en el botón Analyze results:

  • El intervalo de tiempo en el Explorador de registros se puede ajustar automáticamente para que haya datos de registro significativos en la página Análisis de registros.

  • La página Análisis de registros se abre en una pestaña nueva y traduce automáticamente la consulta actual del lenguaje de consulta de Logging en una consulta en SQL.

  • El alcance que seleccionaste en el Explorador de registros se convierte en una cláusula FROM equivalente en la consulta en SQL:

    • Si seleccionaste Alcance por proyecto actual, se consultan los buckets _Required y _Default.

    • Si seleccionaste Limitar alcance por almacenamiento con una o más vistas de registro seleccionadas, solo se consultarán los buckets de registros del proyecto actual que contengan las vistas de registro seleccionadas.

    • Si seleccionaste Limitar alcance por almacenamiento y especificaste una vista de registro en un proyecto diferente, no se consultará ningún buckets de registros.

En la página Análisis de registros, puedes ver los resultados en formato de tabla o como un gráfico. En la pestaña Gráfico, puedes seleccionar los datos del gráfico, personalizar la configuración del gráfico o guardar un gráfico en un panel personalizado. Para obtener información sobre cómo crear gráficos a partir de los resultados de las consultas y guardar gráficos en un panel personalizado, consulta Gráficos de los resultados de las consultas con el Análisis de registros.

Si quieres obtener información sobre el uso de SQL para escribir consultas en el Análisis de registros, visita Consulta y visualiza registros en el Análisis de registros.

El panel Campos de registro

El panel Campos de registro ofrece un resumen de alto nivel de los datos de registro y proporciona una manera eficiente de definir mejor una consulta. El panel muestra entradas de registro desglosadas por diferentes dimensiones, que corresponden a los campos de estas entradas.

Después de ejecutar la consulta en el campo del editor de consultas, el panel Campos de registro se propaga en función de los resultados de la consulta. Este panel muestra los recuentos de entradas de registro para cada dimensión compatible. Para cada dimensión, puedes seleccionar una opción. Las siguientes dimensiones siempre están disponibles:

  • Tipo de recurso

    Si usas BindPlane para escribir registros de nube híbrida y locales, selecciona el tipo de recurso Nodo genérico.

  • Gravedad

    Si quieres que la consulta filtre por varios niveles de gravedad, usa el menú Gravedad.

Es posible que veas una dimensión Servicio:

  • Si tienes registros cuyo tipo de recurso es Contenedor de Kubernetes y no los filtraste por tipo de recurso, se propaga el menú Servicio. Las entradas de este menú están determinadas de forma dinámica por los valores de la etiqueta k8s-pod/app del recurso.

    Por ejemplo, si se muestra una entrada de registro similar a la siguiente como resultado de tu consulta, el menú de servicio incluirá el servicio llamado myservice:

    {
     ...
     labels: {
         compute.googleapis.com/resource_name: "mycluster1"
         k8s-pod/app: "myservice"
         k8s-pod/pod-template-hash: "5ffcd94fdd"
      }
      logName: "projects/my-project/logs/stdout"
      resource: {
         labels: {6}
         type: "k8s_container"
      }
      ...
    }
    
  • Si filtras por el tipo de recurso de Recurso auditado, se propaga el menú Servicio. Las entradas de este menú están determinadas de forma dinámica por los valores de la etiqueta service del recurso.

Otras dimensiones, como el ID del proyecto, se enumeran según tus selecciones. Por ejemplo, la dimensión ID del proyecto aparece cuando tu consulta restringe las entradas de registro a aquellas cuyo tipo de recurso es Contenedor de Kubernetes o cuando seleccionas Alcance por almacenamiento.

Define mejor tu consulta

Para definir mejor tu consulta, selecciona un valor del panel Campos de registro. Por ejemplo, si seleccionas Error en el encabezado Gravedad, el panel de consulta se actualiza para incluir severity=ERROR.

En la siguiente captura de pantalla, se muestra el campo del editor de consultas después de seleccionar la gravedad y el tipo de recurso mediante el panel Campos de registro:

Ejemplo del panel Campos de registro con dos selecciones.

Para quitar una selección, haz clic en Borrar X.

Agrega campos al panel Campos de registro

Puedes agregar algunos pares clave-valor LogEntry al panel Campo de registros desde las entradas de registro propagadas en el panel Resultados de la consulta. Por ejemplo, si filtras con frecuencia por el valor del campo jsonPayload.message, agrégalo al panel Campo de registro.

Para agregar un campo al panel Campo de registros, haz lo siguiente:

  1. En el panel Resultados de la consulta, haz clic en Expandir para expandir una entrada de registro.

  2. Haz clic en el valor de un campo. En el menú, selecciona Agregar campo al panel Campos de registro (Add field to Log fields pane).

    El campo personalizado aparece en el panel Campos de registro como una lista de pares clave-valor.

Para quitar un campo personalizado del panel Campos de registro, haz clic en Quitar junto al campo.

Ten en cuenta que los siguientes tipos de campos no se pueden agregar al panel Campos de registro:

  • Campos relacionados con la hora, por ejemplo, receiveTimestamp y protoPayload.startTime.
  • Campos con alta cardinalidad, por ejemplo, insertId y protoPayload.latency.
  • Campos con índices de array en su ruta de acceso, por ejemplo, protoPayload.authorizationInfo[0].resource.

Histograma

Con el panel Histogram, puedes visualizar la distribución de los registros a lo largo del tiempo. El histograma se vuelve a generar cuando ejecutas una consulta, lo que facilita la visualización de tendencias en los datos de tus registros y la solución de problemas.

Para mostrar u ocultar el panel Histogram, haz clic en el botón Histogram de la barra de herramientas Results.

Funciones del histograma

Panel de histograma

  1. Barras del histograma: Cada barra del histograma representa un intervalo de tiempo. Cada barra contiene un desglose de tres colores para los niveles de gravedad del registro capturados en el intervalo de tiempo de cada barra. Los colores representan las siguientes gravedades del registro:

    • Azul: Gravedad baja, como Predeterminada, Depuración, Información y Aviso.
    • Amarillo: Gravedad media, como Advertencia.
    • Rojo: Gravedad alta, como Error, Crítico, Alerta y Emergencia.

    Cada barra del histograma cuenta con un menú con opciones para analizar tus registros.

  2. Controles de tiempo: Te permiten ajustar el intervalo de tiempo de los registros que ves en el panel Resultados de la consulta. Para obtener detalles sobre estas opciones, consulta Analiza registros con controles de tiempo.

  3. Cronograma: Te muestra el intervalo de tiempo de los registros, representados por barras de histograma, que se muestran actualmente en el panel Resultados de la consulta (Query results). El cronograma te ayuda a orientar los registros que ves dentro del intervalo de tiempo mayor de la consulta.

Analiza registros con controles de tiempo

Puedes usar los controles de tiempo del histograma para investigar y analizar los datos de tus registros.

Ajusta el tiempo rápidamente

El histograma proporciona controles de tiempo que te permiten ajustar rápidamente los datos que ves en el Explorador de registros.

En el cronograma del panel de histograma, se muestran los controles de tiempo rápidos.

  • Controladores de tiempo: Arrastra los controladores del cronograma hacia adentro a fin de limitar los datos o hacia fuera para ampliar los datos en el cronograma del histograma. Haz clic en Ejecutar.

  • Desliza la línea de tiempo hacia adelante y hacia atrás: Haz clic en la flecha hacia adelante para deslizar el cronograma a un momento posterior. Haz clic en flecha hacia atrás para deslizar el cronograma a un momento anterior.

  • Acercar y alejar la imagen: Haz clic en Alejar para ampliar los datos que se muestran en el cronograma. Haz clic en Acercar para reducir los datos que se muestran en el cronograma.

Las modificaciones del cronograma están limitadas a la hora actual (“ahora”) y la hora actual (“ahora”) y hace 30 días.

Desplázate o ve registros del período

Además de los controles de tiempo anteriores, el histograma proporciona las funciones Desplazarse por registros (Scroll to time) y Ver registros del período (Zoom to time) para darte un control más detallado del histograma y los datos que ves en otros paneles en el explorador de registros.

Cronograma del panel de histograma con los controles Desplazarse por registros y Ver registros del período.

Quizás una barra de histograma en particular te interese según su tamaño relativo o sus niveles de gravedad. Puedes seleccionar esa barra de histograma para ajustar los datos de los registros que ves en el Explorador de registros.

Puedes usar la función Desplazarse por el tiempo para explorar los datos de registro sin cambiar los valores en los paneles Histograma y Campos de registro. Cuando seleccionas la función Desplazarse por registros, sucede lo siguiente:

  • Los datos de registros que ves en el panel Resultados de la consulta se ajustan según el intervalo de tiempo que captura la barra de histograma seleccionada.

    La consulta no se ejecuta, pero puede que se realice una carga parcial de los datos para garantizar que veas registros en el panel Resultados de la consulta que correspondan al intervalo 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.

Para seleccionar la función Desplazarse por registros, haz lo siguiente:

  1. Coloca el cursor sobre una barra en el cronograma del histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Desplazarse por registros.

    De manera alternativa, hacer clic en una barra de histograma, en lugar de colocar el cursor sobre ella, es equivalente a seleccionar Desplazarse por registros.

La función Ver registros del período es similar a Desplazarse por registros, pero ejecuta una consulta en tus datos de registros según el intervalo de tiempo que captura una barra de histograma seleccionada. Cuando seleccionas la función Ver registros del período, ocurre lo siguiente:

  • Los datos de registros que ves en el panel Resultados de la consulta se vuelven a limitar y reducir según la restricción de intervalo 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 encuentre dentro del intervalo de tiempo de la barra de histograma seleccionada.
  • Los datos del panel Campos de registro se ajustan según el intervalo de tiempo que captura la barra de histograma seleccionada.

Para seleccionar la función Ver registros del período, haz lo siguiente:

  1. Coloca el cursor sobre una barra en el cronograma del Histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Ver registros del período.

Resultados de la consulta

Para ver los resultados de tus consultas, usa el panel Resultados de la consulta. Para ayudarte a solucionar problemas de tus aplicaciones, puedes ver los detalles de las entradas de registro individuales, y agrupar y analizar las entradas de registro para encontrar patrones en tus registros. Si Duet AI está habilitado en el proyecto en el que ves los registros, también puedes usar Duet AI para resumir una entrada de registro.

Configura la columna Tiempo

La columna Tiempo en el panel Resultados de la consulta muestra las marcas de tiempo de las entradas de registro. Puedes personalizar la columna Time para que solo ciertas partes de la marca de tiempo sean visibles. Esto crea más espacio horizontal para que puedas ver más información en la entrada de registro.

Para seleccionar qué partes de la marca de tiempo se mostrarán, haz clic en el menú Opciones de hora adicionales en la columna Hora y, luego, selecciona una de las siguientes opciones:

  • Fecha, hora y zona horaria

  • Fecha y hora (predeterminadas)

  • Solo hora

Encuentra patrones en tus registros con campos de resumen

Supongamos que estás buscando las entradas de registro en los resultados de tu consulta y quieres obtener una vista rápida de los resultados mediante un campo LogEntry determinado. O tal vez quieras agrupar tus entradas de registro por un par campo-valor determinado. Puedes agregar campos de resumen a los resultados, que aparecen como chips al comienzo de cada línea de entrada de registro. Por ejemplo, en la siguiente imagen, se muestran los resultados de la consulta con el campo de resumen resource.type agregado a cada línea de entrada de registro:

El Explorador de registros muestra registros precedidos por texto verde que indica tipos de recursos.

El Explorador de registros ofrece campos de resumen predeterminados y campos de resumen personalizados. Los campos de resumen predeterminados dependen de los resultados de la consulta actual, y los campos de resumen personalizados te permiten seleccionar cualquier campo en LogEntry.

Para ocultar los campos de resumen en los resultados de la consulta, usa el botón de activación Campos de resumen. Cuando se habilita este botón de activación, los resultados se muestran en formato de texto sin procesar. De forma predeterminada, el contenido de cada entrada de registro se trunca para que quepa en una sola línea. A fin de mostrar hasta 10 líneas para cada entrada de registro, usa el botón de activación Unir líneas. Los espacios en blanco se conservan en cada entrada de registro.

Para ocultar campos de resumen específicos, haz clic en el campo de resumen y, luego, en Ocultar campo de resumen.

Para modificar los campos de resumen, haz lo siguiente:

  1. Haz clic en el botón Editar en la columna Resumen para abrir el menú de edición.

    En el panel de resultados de la consulta, se muestra el botón para editar los campos de resumen.

  2. En el diálogo Administra los campos de resumen, puedes hacer lo siguiente:

    • Agrega los nombres de campos personalizados a Campos de resumen personalizados.

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

      • Autocompletar con los registros que se muestran actualmente en los resultados de tu consulta.
      • Corrección de campos para caracteres legales entre comillas

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

      También puedes seleccionar cualquier campo LogEntry, sin importar si se te sugiere con la función de autocompletado.

      Para quitar un campo de resumen personalizado existente, haz clic en la X en el chip.

    • Activa y desactiva el truncamiento para tus campos de resumen personalizados.

      Para acortar la visualización de los valores del campo de resumen, usa el botón de activación junto a Truncate custom summary field. Puedes elegir cuántos caracteres mostrar antes de que se trunque el campo y si se muestra el principio o el final.

    • Oculta o muestra los campos de resumen predeterminados:

      Para personalizar qué campos de resumen predeterminados se muestran en los resultados de tu consulta, expande el menú Ocultar o mostrar los campos de resumen predeterminados.

  3. Haz clic en Aplicar.

    Tus campos de resumen ahora se actualizaron en los resultados de la consulta.

Buscar los resultados de la consulta

Para buscar el contenido de los Resultados de la consulta, haz clic en Encontrar en los resultados en el panel Resultados de la consulta y, luego, ingresa tu término de búsqueda. Este filtro te permite encontrar información en tus entradas de registro sin crear una consulta nueva.

Los términos que coinciden con los criterios de búsqueda se destacan en las entradas de registro dentro del panel Resultados de la consulta:

Se destacan las entradas de registro con los términos de búsqueda que coinciden.

Ver entradas de registro similares

Puedes ver entradas de registro que son similares a una entrada de registro seleccionada, lo que te permite enfocarte en los registros de interés.

Para mostrar entradas de registro similares, haz lo siguiente:

  1. En el panel Resultados de la consulta, en una entrada de registro, haz clic en Expandir.

  2. Haz clic en Entradas similares y selecciona Mostrar entradas similares.

    La consulta se actualiza con una consulta similar a la siguiente y vuelve a cargar los resultados:

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

Para obtener una vista previa de las entradas de registro similares, sigue estos pasos:

  1. En el panel Resultados de la consulta, en una entrada de registro, haz clic en Expandir.

  2. Expande el menú Entradas similares y selecciona Obtener vista previa de entradas similares.

    Se abrirá un diálogo separado con la siguiente información:

    • El patrón que se encontró
    • El porcentaje de entradas de registro que contienen el patrón
    • Ejemplo de entradas de registro que contienen el patrón

    En este diálogo, puedes ocultar o mostrar entradas de registro:

    El diálogo Vista previa de las entradas de registro te permite ocultar o mostrar entradas de registro similares.

Ocultar entradas de registro similares

Puedes ocultar entradas de registro similares, lo que te permite quitar registros de los resultados de tu consulta.

Existen dos maneras de ocultar entradas de registro similares:

  • Oculta grandes cantidades de entradas de registro agrupadas automáticamente. Cuando ejecutas una consulta, los resultados se analizan en busca de patrones y las entradas de registro se agrupan automáticamente según un contenido similar de campos de registro. Si se detecta un patrón significativo, aparecerá un banner en el panel Resultados de la consulta que mostrará el porcentaje de resultados que se pueden ocultar:

    Ocultar banner de registros similares.

    Ocultar entradas similares: Este botón agrega una cláusula a la consulta y vuelve a cargar los resultados de la consulta.

    Vista previa: Se abre una ventana separada que describe el patrón encontrado y muestra ejemplos de las entradas.

    Cuando ocultas registros similares, no se guarda ninguna información fuera de la sesión del Explorador de registros, y cada consulta produce un análisis nuevo, solo en función de los registros que se muestran. Las distintas consultas analizan distintas partes de las entradas de registro según los tipos de registros que se muestran.

  • Oculta entradas de registro similares a una entrada de registro específica. Para ocultar entradas de registro similares a una, haz lo siguiente:

    1. En la entrada de registro, haz clic en Expandir, haz clic en el menú Entradas similares y, luego, selecciona Ocultar entradas similares.

      Se actualiza la consulta y se vuelve a cargar el panel Resultados de la consulta. No se muestran las entradas de registro similares a la entrada de registro seleccionada.

Oculta o muestra entradas de registro que coincidan con un campo

Puedes ocultar o ver las entradas de registro que coinciden con un campo en una entrada de registro, lo que te permite enfocarte en las entradas que contienen el mismo contenido de campo.

Para ocultar o ver las entradas de registro que coinciden con un campo específico en una entrada de registro, haz lo siguiente:

  1. En el panel Resultados de la consulta, en la entrada de registro, haz clic en Expandir.

  2. Haz clic en el valor de un campo dentro de la entrada de registro, como compute.googleapis.com, que es un serviceName.

    Verás el siguiente menú:

    Menú con opciones para ocultar y mostrar entradas de registro según un campo específico.

  3. Selecciona Mostrar las entradas coincidentes, o bien Ocultar las entradas coincidentes.

    La consulta se actualiza con una consulta que oculta o muestra entradas similares, y los Resultados de la consulta se vuelven a cargar con los resultados nuevos.

Fija las entradas de registro

Después de ejecutar una consulta, puedes fijar una entrada de registro para destacarla. La entrada de registro fijada permanece centrada en el panel Resultados de la consulta. Si ejecutas una consulta nueva y la entrada de registro fijada no está incluida, se te solicitará que dejes de fijarla.

Para fijar una entrada de registro, haz lo siguiente:

  1. Coloca el cursor sobre la entrada de registro que quieres fijar.
  2. Haz clic en Fijar.

Después de fijar una entrada de registro, su fondo se oscurece y se muestra el ícono de Fijar. También aparece un ícono de fijar en el panel Histograma según 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 dejar de fijar una entrada de registro, vuelve a hacer clic en el ícono de fijar.

Mostrar registros que coinciden con el recurso de una entrada de registro fijada

Después de fijar una entrada de registro, puedes ejecutar una nueva consulta que muestre entradas de registro que coincidan con el tipo de recurso o las etiquetas de recursos del registro fijado.

Para fijar una entrada de registro y mostrar entradas de registro que coincidan con el mismo tipo de recurso o etiquetas de recursos, haz lo siguiente:

  1. Haz clic en la flecha hacia abajo que se encuentra junto al registro fijado para expandir el menú correspondiente.

  2. En el menú Fijar, haz una selección:

    • Para volver a ejecutar la consulta con el mismo resource.type que el registro fijado, selecciona Mismo recurso.type.

      Por ejemplo, supongamos que fijas una entrada de registro con un resource.type de k8s_node. Si seleccionas Same resource.type, la consulta se vuelve a ejecutar para mostrar todas las entradas de registro con resource.type="k8s_node".

    • Para volver a ejecutar la consulta con el mismo resource.labels que el registro fijado, selecciona Same resource.labels.

    • Para volver a ejecutar la consulta con el mismo trace que el registro fijado, selecciona Mismo seguimiento.

    • Para borrar la consulta y mostrar todas las entradas de registro, selecciona Mostrar todo.

Visualiza una entrada de registro fijada en el panel Histograma

Puedes usar el panel Histograma para destacar, desplazarte y examinar más una entrada de registro fijada.

En el panel Histogram, haz clic en Pin y, luego, elige una de las siguientes opciones de menú:

  • Desplazarse hasta la entrada de registro: lleva la entrada de registro al panel Resultados de la consulta actual y visualiza la entrada de registro fijada en el contexto de los registros cercanos.
  • Zoom a la entrada de registro: Limita el intervalo de tiempo que muestra el panel Histograma y define mejor tu consulta para aislar los registros cerca del registro fijado.

Visualiza 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 detalles, consulta Cómo buscar y explorar seguimientos.
  • 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, consulta Tasa de muestreo.

Visualiza los datos de Monitoring

Para ciertos registros, como los registros de GKE y de Compute Engine, puedes hacer clic en el tipo de recurso de la línea de resumen del registro para mostrar un menú con las siguientes opciones:

  • Ver detalles de supervisión: Abre un panel de detalles para un recurso de GKE. Para obtener información sobre el panel de detalles, consulta Ver detalles del recurso.
  • Ver en Monitoring: Se abre una página de Monitoring para el recurso.
  • Ver en GKE o Ver en Compute Engine: Abre la página Detalles del recurso dentro de la interfaz de usuario de GKE o Compute Engine.

Se muestra el menú de Explorador de registros para los recursos de GKE.

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. Puedes enviar el vínculo a los usuarios que tienen acceso al proyecto de Google 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.

Descargar registros

Puedes descargar tus registros en formato CSV o JSON. Necesitas una de las siguientes funciones de Identity and Access Management 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. Haz clic en Descargar en el panel Resultados de la consulta.

  2. En el cuadro de diálogo Descargar registros, selecciona formato CSV o JSON.

  3. Selecciona qué hacer con los datos de registro. Tienes las siguientes opciones:

    • Descarga los datos en tu computadora.
    • Descargar los datos a Google Drive
    • Ve los datos en una pestaña nueva.

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

Consultas de ejemplo

Para ver consultas sugeridas organizadas por producto y caso de uso de Google Cloud, consulta Consultas de muestra con el Explorador de registros. Por ejemplo, puedes ejecutar consultas relacionadas con Kubernetes para encontrar los registros de Google Kubernetes Engine.

Visualiza los registros de Compute Engine

Para ciertos tipos de recursos de Compute Engine, como gce_instance y gce_network, puedes ver el nombre del recurso con el ID del recurso como subtexto en varios lugares en el Explorador de registros. Por ejemplo, para el tipo de recurso gce_instance, ves el nombre de la VM junto con el ID. Los nombres de los recursos te ayudan a identificar el ID de recurso correcto en el que puedes crear consultas.

Es posible que veas nombres de recursos de Compute Engine en los siguientes lugares:

  • Menús de filtro del panel Consulta: Los tipos de recursos de Compute Engine muestran los nombres de los recursos, con sus IDs de recursos correspondientes como subtexto.
  • Campos de registro: Los tipos de recursos de Compute Engine muestran el nombre del recurso, en lugar del ID del recurso, en las dimensiones del campo.
  • Resultados de la consulta: En el caso de los registros de instancias de VM de Compute Engine, el campo resource.labels muestra metadatos con el nombre del recurso correspondiente.
  • Campos de resumen: En los registros de instancias de VM de Compute Engine, el chip muestra el nombre del recurso en lugar del ID del recurso.

Solución de problemas

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

Si tienes problemas cuando intentas ver los registros en los destinos del receptor, consulta Soluciona problemas de enrutamiento y receptores.

No se pueden encontrar los registros de la consola de una instancia de VM

Es posible que los registros escritos en la consola de una instancia de Compute Engine no estén disponibles en el Explorador de registros. Para ver estos registros, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.

    Ir a Instancias de VM

  2. Selecciona la instancia y, luego, selecciona Puerto en serie 1 (consola) en la sección Registros de la página.

Puedes configurar las instancias para que la salida del puerto en serie se envíe a Cloud Logging. Para obtener más información, consulta Habilita e inhabilita el registro de salidas de puertos en serie.

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

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

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

  • ¿Tu proyecto de Google Cloud usa recursos que generan registros? ¿Hay actividad en esos recursos? Incluso si el proyecto de Google Cloud 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.

  • ¿Se usa el permiso correcto para ver los registros? Para obtener instrucciones sobre cómo ajustar el alcance de tu búsqueda, consulta Define mejor el alcance.

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.

  • El permiso de la consulta se definió como demasiado amplio y no se pudo completar en un tiempo razonable. Es posible que veas esto como “un plazo vencido antes de que la operación se pueda completar”. Trata de hacer que tu consulta sea más específica o reducir el intervalo de tiempo.

La consulta muestra un error

Si realizas una consulta sobre un recurso sin especificar un bucket, Cloud Logging usa el historial de los receptores en el proyecto de Google Cloud para determinar dónde se podrían haber escrito entradas para ese recurso. Si Cloud Logging identifica más de 200 buckets en los que se pueden haber escrito entradas, la consulta falla y muestra el mensaje Error: Invalid query.

A fin de resolver este problema, define mejor el alcance de tu consulta en un subconjunto del almacenamiento. Para obtener más información, consulta Define mejor el permiso.

El intervalo de tiempo de los resultados de la consulta no coincide con la consulta

Los datos de registro que ves en los paneles Resultados de la consulta y Campos de registro se ajustan según el intervalo de tiempo capturado por el cronograma del histograma. Puedes ajustar el cronograma del histograma con los controles de tiempo del histograma o con el selector de intervalo de tiempo. El ajuste de estos controles de tiempo no altera la expresión de la consulta en el panel Consulta.

Si tienes una consulta con una marca de tiempo, el selector de intervalos de tiempo se inhabilita y la consulta usa la expresión de marca de tiempo como su restricción de intervalo de tiempo. Si una consulta no usa una expresión de marca de tiempo, usará el selector de intervalos de tiempo como su restricción de intervalo de tiempo.

Obtenga asistencia

Para ver más información sobre cómo obtener asistencia, consulta la página de asistencia de observabilidad de Google Cloud.