Crear consultas en el Explorador de registros

En este documento, se describe cómo compilar consultas en el Explorador de registros de Google Cloud Console para recuperar y analizar registros.

Para obtener más información sobre las consultas en el Explorador de registros, visita Usa el Explorador de registros.

Antes de comenzar

Para ver los registros que envías desde una cuenta de Amazon Web Services (AWS) a Logging, selecciona el proyecto del conector de AWS en el selector de recursos de Google Cloud Console y, luego, usa el Explorador de registros. El proyecto de conector de AWS almacena el nombre del recurso de Amazon (ARN) de tu cuenta de AWS y vincula tu cuenta de AWS a los servicios de Google Cloud. Si deseas obtener más información, consulta Visualiza métricas para cuentas de AWS.

Asegúrate de tener los permisos o la función de administración de identidades y accesos correctos para compilar consultas con el Explorador de registros. Para obtener detalles sobre los permisos de IAM necesarios, consulta Control de acceso con IAM: permisos de Google Cloud Console.

Comienza ahora

Para comenzar a usar Google Cloud Console a fin de compilar consultas, navega al Explorador de registros:

Ir al Explorador de registros.

Selecciona el proyecto de Cloud o cualquier otro recurso de Google Cloud correspondiente del que desees ver los registros.

Compilar consultas

Cuando creas consultas en el Explorador de registros, usa el panel Consulta principalmente:

Panel de consulta del Explorador de registros

En el panel Consulta, se proporcionan varias formas de compilar y ejecutar expresiones de consulta:

  • Buscar texto en todos los campos de registro
  • Seleccione las opciones de los menús de filtro.
  • Escribir consultas avanzadas mediante el lenguaje de consultas de Logging
  • Consulta, edita o ejecuta las consultas en las pestañas Recientes, Guardados, Sugeridas y Biblioteca.

En las siguientes secciones, se describen estas funciones en más detalle.

Buscar texto en campos de registro

Para buscar texto en todos los campos de registro y encontrar todas las entradas de registro que coincidan, ingresa los términos de búsqueda en el campo de búsqueda:

El campo de búsqueda del Explorador de registros en el panel de consultas.

Para buscar entradas de registro que contengan una frase, escribe los términos de búsqueda entre comillas. También puedes usar operadores booleanos en las expresiones de búsqueda. Para ver los términos de búsqueda en la expresión de consulta, habilita Mostrar consulta.

Después de ingresar los términos de búsqueda, haz clic en Ejecutar consulta o presiona la tecla Intro. Los resultados de la consulta se muestran en el panel Resultados de la consulta.

Operadores booleanos

Tus entradas de campo de búsqueda se convierten en expresiones booleanas que especifican un subconjunto de todas las entradas de registro en el recurso de Google Cloud seleccionado.

El campo de búsqueda admite el uso de los operadores booleanos AND, OR y NOT. Cuando uses operadores booleanos en tus expresiones de búsqueda, ten en cuenta lo siguiente:

  • No puedes usar paréntesis para anidar reglas. Cualquier paréntesis en la expresión de búsqueda se analiza como términos de búsqueda.
  • Debes usar mayúsculas en los operadores booleanos. and, or y not en minúscula se analizan como términos de búsqueda, no como operadores.

Si no incluyes ningún operador, AND se unirá a todos los términos de búsqueda y las frases. Puedes omitir el operador AND entre los términos de búsqueda.

Los operadores AND y OR son operadores de cortocircuito. Puedes combinar las reglas AND y OR en la misma expresión. Por ejemplo, cuando los dos operadores se mezclan, la expresión a AND b OR c AND d se convierte en la siguiente expresión del lenguaje de consultas de Logging:

"a"
"b" OR "c"
"d"

El operador NOT tiene la prioridad más alta, seguido de OR y AND en ese orden.

El operador NOT realiza una negación del término posterior. Por ejemplo, NOT error muestra entradas de registro que no contienen error. También puedes reemplazar el operador NOT por el operador - (menos). Por ejemplo, las siguientes dos consultas son las mismas:

response AND successful AND NOT error
response successful -error

Esta lógica también funciona con una frase si el operador - (menos) está fuera de las comillas. Por ejemplo, las siguientes dos consultas son las mismas:

-"response successful"
NOT "response successful"

Cómo usar los menús de filtro

Puedes usar los menús de filtro en el panel Consulta para agregar los parámetros de recurso, nombre de registro y gravedad de registro al campo de editor de consultas. Estas opciones corresponden a los campos LogEntry para todos los registros en Logging.

Filtrar menús para el Editor de consultas

  • Resource (Recurso): Te permite especificar el resource.type y el resource.labels asociado. Puedes seleccionar un solo tipo de recurso mediante este menú de filtros y cero o más etiquetas de recursos para aplicar a tu consulta. El operador lógico AND une los parámetros de recursos.
  • Nombre del registro (Log name): Te permite especificar logName. Puedes seleccionar varios nombres de registro para aplicar a tu consulta. Cuando seleccionas varios nombres de registro, se usa el operador lógico OR.
  • Gravedad (Severity): Te permite especificar la gravedad. Puedes seleccionar varios niveles de gravedad al mismo tiempo para agregarlos a tu consulta. Cuando seleccionas varios niveles de gravedad, se usa el operador lógico OR.

Para usar cualquiera de los menús de filtro, haz lo siguiente:

  1. Expande en cualquiera de los menús de filtro del panel Query.

  2. Definir mejor los parámetros del filtro

  3. Haga clic en Aplicar. Verá los parámetros en el campo de consulta-editor.

    Para ver los términos de búsqueda en la expresión de consulta, habilita Mostrar consulta.

  4. Después de revisar la consulta, haz clic en Ejecutar consulta. Los resultados de la consulta se muestran en el panel Query results.

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

Escribe consultas con restricciones de tiempo

Existen dos maneras de consultar registros en función del tiempo:

  1. Realiza consultas con el selector de intervalo de tiempo.
  2. Consulta mediante una expresión de marca de tiempo en el campo de consulta-editor.

Para realizar consultas rápidas en segundos, minutos, horas o días, usa los valores predeterminados o ingresa un intervalo de tiempo personalizado con el selector.

Para agregar una expresión de marca de tiempo directamente al campo de consulta-editor, usa el lenguaje de consulta de Logging.

Si el campo de consulta-editor contiene una expresión con una marca de tiempo, se inhabilita el selector de intervalo de tiempo 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, la consulta usa el selector de intervalo de tiempo como su restricción de intervalo de tiempo.

Cómo usar el selector de intervalos de tiempo

El selector de intervalo de tiempo te permite restringir los resultados de la consulta por intervalo de tiempo:

Selector de intervalo de tiempo en el panel de consulta.

Para usar el selector de intervalo de tiempo, haz lo siguiente:

  1. Haz clic en el selector de intervalo de tiempo en el panel Consulta.

  2. Selecciona el intervalo de tiempo correspondiente para el que desees ver los registros.

  3. Haga clic en Aplicar. Verá los parámetros en el campo de consulta-editor.

    El panel Resultados de la consulta se ajusta según el intervalo de tiempo que seleccionaste.

El intervalo de tiempo predeterminado es de una hora. Puedes usar la opción Saltar a un momento específico para restringir y centrar el intervalo de tiempo alrededor de una marca de tiempo específica.

Puedes configurar tus preferencias regionales, incluido el formato de fecha y hora, en el selector de rango de tiempo:

  1. Selecciona Ingresar rango personalizado.
  2. Selecciona Cambiar fecha y hora.
  3. Actualiza tus preferencias en el menú Idioma y región.
  4. Haz clic en Guardar.

    Después de actualizar el navegador, el formato de fecha y hora preferido aparece en el Explorador de registros.

Escribir consultas avanzadas con el lenguaje de consulta de Logging

Puedes usar el lenguaje de consulta de Logging para compilar consultas más avanzadas en el campo del editor de consultas del Explorador de registros:

  1. Si no ves el campo consulta-editor en el panel Query, habilita Show query.

  2. Ingresa tus expresiones de consulta directamente en el campo de búsqueda-editor.

    Si agregaste términos de búsqueda en el campo de búsqueda o seleccionaste algún parámetro en los menús de filtro, esos también aparecerán en el campo de consulta del editor y se evaluarán como parte de tu expresión de consulta.

  3. Después de revisar su consulta, haga clic en Ejecutar consulta.

    Los registros que coinciden con tu consulta se enumeran en el panel Resultados de la consulta. Los paneles Histogram y Log fields también se ajustan de acuerdo con la expresión de consulta.

Si quieres ver ejemplos de consultas comunes que te pueden interesar, consulta Consultas de muestra con el Explorador de registros.

Usar consultas recientes

Cuando ejecutas una consulta, esta se agrega a tu lista de Consultas recientes, que contiene las últimas 10,000 consultas únicas en un período de 30 días.

Para ver las consultas recientes, selecciona la pestaña Recientes en el panel Consulta. En la pestaña Recientes, encontrarás las siguientes opciones:

  • Stream: Para ejecutar la consulta y transmitir los resultados, elige esta opción.
  • Ejecutar: Para ejecutar la consulta, elige esta opción.
  • Más opciones : Te permite ver la expresión de consulta con las opciones para ejecutarla o guardarla en tu lista de consultas Guardados. También puedes seleccionar la consulta directamente para obtener estas opciones.

    Para guardar la consulta, haz lo siguiente:

    1. Haz clic en Guardar como. Se abrirá el diálogo Save query.
    2. Completa los siguientes campos:

      • Name (obligatorio): Proporciona un nombre para tu consulta. Los nombres tienen un límite de 64 caracteres.
      • Descripción (opcional): Proporciona una descripción para ayudar a identificar el propósito de la consulta.
      • Incluir campos de resumen (Opcional): Habilita Incluir campos de resumen y, luego, ingresa los campos de resumen que deseas mostrar.
      • Truncar campos de resumen (opcional): Habilita Truncar resúmenes fields y selecciona la cantidad de caracteres para truncar y si el truncamiento se produce al comienzo o al final de los campos.
    3. Haz clic en Guardar consulta. La consulta ahora está disponible en tu lista de consultas guardadas.

También puedes ordenar y filtrar las consultas recientes. El filtro coincidirá con el texto de tu expresión de consulta.

Guardar consultas

El panel Consultas muestra una pestaña Guardados, en la que puedes acceder a las consultas guardadas. Las consultas guardadas te permiten almacenar expresiones de consulta para ayudarte a explorar los registros de manera más coherente y eficiente.

Para guardar una expresión de consulta que compilaste en el campo de consulta-editor, haz lo siguiente:

  1. Haz clic en Guardar en el panel Consulta. Se abrirá el diálogo Save query (Guardar consulta), con tu expresión de consulta en el campo query-editor.

  2. Completa los siguientes campos:

    • Name (obligatorio): Proporciona un nombre para tu consulta. Los nombres tienen un límite de 64 caracteres.
    • Descripción (opcional): Proporciona una descripción para ayudar a identificar el propósito de la consulta.
    • Incluir campos de resumen (Opcional): Habilita Incluir campos de resumen y, luego, ingresa los campos de resumen que deseas mostrar.
    • Truncar campos de resumen (opcional): Habilita Truncar resúmenes fields y selecciona la cantidad de caracteres para truncar y si el truncamiento se produce al comienzo o al final de los campos.
    1. Haz clic en Guardar consulta. Las consultas guardadas aparecerán en una lista de la pestaña Guardados.

Para ejecutar una consulta guardada, haz clic en Ejecutar. Para ejecutar la consulta y transmitir los resultados, haz clic en Transmitir.

También puedes ordenar y filtrar las consultas guardadas; el filtro coincide con el texto de la expresión de la consulta.

Compartir consultas

Las consultas compartidas permiten a los usuarios de un proyecto de Cloud compartir sus consultas guardadas entre sí. Puedes ver las consultas compartidas en la pestaña Saved.

Si deseas ver las funciones y los permisos necesarios para ver y editar las consultas compartidas, consulta Permisos de Google Cloud Console. Ten en cuenta que los usuarios que tienen la función de IAM roles/logging.admin o roles/editor pueden editar las consultas compartidas de otros usuarios.

Crear una consulta compartida

Puedes compartir consultas que ya guardaste o compartir una nueva.

Para crear y compartir una consulta, haz lo siguiente:

  1. Ingresa una consulta en el campo de consulta-editor.

  2. Haz clic en Guardar.

  3. Completa los campos del diálogo Guardar consulta.

  4. Habilita Compartir con el proyecto.

  5. Haz clic en Guardar consulta.

Tu consulta ahora se comparte con otros usuarios del proyecto de Cloud.

Para compartir una consulta ya guardada, haz lo siguiente:

  1. Selecciona la pestaña Guardadas (Saved).

  2. Selecciona Más opciones > Editar , o selecciona la consulta directamente.

  3. En el cuadro de diálogo Editar consulta, habilita Compartir con el proyecto y haz clic en Actualizar consulta.

Tu consulta ahora se comparte con otros usuarios del proyecto de Cloud.

Ver consultas compartidas

Para ver todas las consultas compartidas con rapidez, ordena la columna Visibilidad para mostrar primero las consultas compartidas:

  1. Selecciona la pestaña Guardadas (Saved).

  2. Haga clic en Todos.

  3. Ordena la columna Visibilidad (Visibility).

La columna Visibilidad indica si las consultas se comparten y de qué manera:

  • Compartidos por mí: Consultas que guardaste y compartiste con otros usuarios del proyecto de Cloud.
  • Compartidos: Las consultas que compartieron otros usuarios del proyecto de Cloud.
  • Privadas: Consultas que guardaste y no compartiste con otros usuarios del proyecto de Cloud.

Consulta solo tus búsquedas

Para ver las consultas guardadas que creaste o compartiste, haz clic en Mine. Ahora verás una lista de las consultas que creaste y guardaste. En la columna Visibilidad, puedes ver tus consultas Privadas no compartidas. Las consultas que compartiste se identifican con Compartidas por mí (Shared by me).

Cómo usar las búsquedas sugeridas

Logging genera consultas sugeridas en función del contexto de tu proyecto de Cloud, como los productos de Google Cloud que usas. Las consultas sugeridas pueden ayudarte a identificar problemas y brindarte estadísticas sobre el estado general de tus sistemas. Por ejemplo, si detectas que usas Google Kubernetes Engine, Logging puede sugerir una consulta que encuentre todos los registros de errores de tus contenedores.

Para ver y ejecutar consultas sugeridas, selecciona la pestaña Suggested en el panel Query. En la pestaña Suggested, se muestra una lista de consultas, cada una con descripciones y las siguientes opciones:

  • Stream: Para ejecutar la consulta y transmitir los resultados, elige esta opción.
  • Ejecutar: Para ejecutar la consulta, elige esta opción.
  • Más opciones : Te permite ver los detalles de la expresión de consulta con las opciones para ejecutarla o guardarla. También puedes seleccionar la consulta directamente para obtener estas opciones.

    Para revisar los detalles de una consulta sugerida, realiza una de las siguientes acciones:

    • Selecciona la fila de la consulta.

    • Haz clic en More y selecciona View. Se abrirá el diálogo Detalles de la consulta.

    En el diálogo Detalles de la consulta, verás la consulta y las opciones Ejecutar, Transmitir o Guardar como:

    • Para guardar la consulta, haz lo siguiente:

      1. Haga clic en Guardar como.
      2. Completa los campos del diálogo Guardar consulta.

      La consulta editada aparece en tu lista Saved (Guardada), en la que puedes elegir ejecutar la consulta más tarde.

    • Para ejecutar la consulta ahora, haga clic en Ejecutar. La consulta se ejecuta y aparece en el campo de consulta-editor.

    • Para ejecutar la consulta ahora y transmitir los resultados, haga clic en Transmitir.

    • Para cerrar el diálogo y volver a la lista de consultas sugeridas, haz clic en Cerrar.

Ten en cuenta los siguientes comportamientos esperados:

  • Es posible que las cargas de página sucesivas no muestren las mismas búsquedas en el mismo orden.
  • Es posible que no vea ninguna consulta sugerida.
  • A veces, cuando se ejecuta una consulta sugerida, no se muestran registros.

Selecciona consultas de la biblioteca

Logging proporciona una biblioteca de consultas basadas en casos de uso comunes y productos de Google Cloud. Estas consultas pueden ayudarte a encontrar de manera eficiente los registros durante las sesiones importantes para solucionar problemas y explorar los registros para comprender mejor qué datos de registro están disponibles.

Para ver y ejecutar las consultas de la biblioteca, haz lo siguiente:

  1. Selecciona la pestaña Biblioteca en el panel Consulta.

  2. En la columna Todas las consultas, verás categorías amplias de consultas disponibles y subconjuntos de consultas basadas en los productos de Google Cloud. Para restringir la selección de búsquedas que ves, haz clic en cualquiera de los productos.

    También puedes usar el campo de búsqueda para buscar las consultas disponibles por categoría, descripción o el contenido de la expresión de consulta.

  3. Para revisar una expresión de consulta, realiza una de las siguientes acciones:

    a. Haz clic en la fila de la consulta.

    b. Haz clic en Más y selecciona Ver.

  4. En el cuadro de diálogo Query details, verás la consulta y las opciones Run, Stream o Save As:

    • Para guardar la consulta, haz lo siguiente:

      1. Haga clic en Guardar como.
      2. Completa los campos del diálogo Guardar consulta.

      La consulta editada aparece en tu lista Saved (Guardada), en la que puedes elegir ejecutar la consulta más tarde.

    • Para ejecutar la consulta ahora, haga clic en Ejecutar. La consulta se ejecuta y aparece en el campo de consulta-editor.

    • Para ejecutar la consulta ahora y transmitir los resultados, haga clic en Transmitir.

    • Para cerrar el diálogo y volver a la lista de consultas sugeridas, haz clic en Cerrar.