Crear consultas en el Explorador de registros

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

Antes de comenzar

Para ver los registros que envías desde 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 heredado. 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 adecuados de administración de identidades y accesos para compilar consultas mediante el Explorador de registros. Para obtener detalles sobre los permisos de IAM necesarios, consulta la Guía de control de acceso: Permisos de Cloud Console.

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

Crea consultas

En el panel del compilador de consultas, se proporcionan varias formas de recuperar registros:

  1. Menús desplegables del compilador de consultas
  2. Consultas mediante el lenguaje de consulta de Logging
  3. Pestañas de consultas Recientes, Guardadas y Sugeridas

query-builder-pane

En las siguientes secciones, se describe cómo compilar y ejecutar consultas para recuperar tus registros.

Menús desplegables del compilador de consultas

Los menús desplegables te permiten agregar parámetros de búsqueda al Compilador de consultas. Puedes usar los menús desplegables para seleccionar los recursos, los nombres de registros, la gravedad del registro y los intervalos de tiempo. Estas opciones corresponden a los campos LogEntry de todos los registros de Logging.

Menús desplegables del compilador de consultas

  • Resource: Te permite especificar el resource.type. Puedes seleccionar solo un recurso a la vez para agregarlo al Compilador de consultas. En las entradas, se usa el operador lógico AND.
  • Nombre del registro (Log name): Te permite especificar logName. Puedes seleccionar varios nombres de registro al mismo tiempo para agregarlos al Compilador de consultas. Cuando seleccionas varias entradas, 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 al Compilador de consultas. Cuando seleccionas varias entradas, se usa el operador lógico OR.

Para usar cualquiera de los menús de los parámetros de búsqueda, debes expandirlos, seleccionar uno o varios parámetros y, luego, hacer clic en Agregar.

Una vez que hayas compilado la consulta, haz clic en Ejecutar consulta para recuperar las entradas de registro que desees.

Consultas con una restricción de tiempo

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

  1. Consulta mediante una expresión de marca de tiempo
  2. Consulta mediante el selector de intervalos de tiempo

    El Explorador de registros muestra dos formas de filtrar por tiempo

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.

Consultas mediante el lenguaje de consulta de Logging

Puedes usar el lenguaje de consulta de Logging para compilar consultas en el panel del compilador de consultas de Cloud Logging, así como en la API de Logging o la interfaz de línea de comandos.

Para obtener más detalles, consulta Lenguaje de consulta de Logging.

Consultas guardadas

En el panel del compilador de consultas, se incluye una pestaña Saved (Guardadas), en la que puedes acceder a las consultas guardadas.

Lista de 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 consulta que compilaste en el panel del compilador de consultas, haz lo siguiente:

  1. Haz clic en Guardar (Save) en el panel del compilador de consultas. Se abrirá el cuadro de diálogo Guardar consulta, que contendrá tu expresión de consulta en el campo Query (Consulta).

  2. Agrega un Name (Nombre) para la consulta.

    Los nombres tienen un límite de 64 caracteres.

  3. Para agregar campos de resumen a tu consulta, activa Include summary fields (opcional).

  4. Agrega una Description (Descripción) para tu consulta (opcional).

    Las descripciones tienen un límite de 1,000 caracteres. No incluyas información sensible.

  5. Selecciona Guardar consulta en el cuadro de diálogo.

Las consultas guardadas aparecen en una lista en la pestaña Saved (Guardadas) en el panel del compilador de consultas.

Para ejecutar una consulta guardada, haz clic en Run query (Ejecutar consulta).

Consultas compartidas

Las consultas compartidas permiten que los usuarios de un proyecto compartan sus consultas guardadas entre sí.

Si deseas conocer las funciones y los permisos necesarios para ver y editar consultas compartidas, consulta la sección Permisos y funciones en la página Control de acceso.

Comparte una consulta

Puedes compartir consultas que ya guardaste o puedes compartir una nueva.

Para compartir una consulta nueva, haz lo siguiente:

  1. Ingrese una consulta en el compilador de consultas.

  2. Selecciona Guardar en el panel del compilador de consultas.

  3. Completa los campos del cuadro de diálogo de la consulta de guardado.

  4. Habilita Compartir con el proyecto.

Ahora tu consulta se comparte con otros usuarios del proyecto.

Para compartir una consulta ya guardada, haz lo siguiente:

  1. Selecciona Guardado.

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

  3. En el cuadro de diálogo de la consulta de edición, habilita Compartir con el proyecto y, luego, selecciona Actualizar consulta.

Ahora tu consulta se comparte con otros usuarios del proyecto.

Visualiza las 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. Seleccionar todo.

  3. Ordena la columna Visibilidad (Visibility).

La columna de visibilidad está ordenada.

En la columna Visibilidad, se distinguen las consultas que se comparten contigo de las consultas que compartes con otros usuarios del proyecto.

Visualiza solo tus consultas

Para ver las consultas compartidas que creaste o compartiste, haz clic en Mine. Ahora verás una lista de 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).

Consultas sugeridas

Logging genera consultas sugeridas en función de su conocimiento de los productos de Google Cloud que usas. Propone consultas que 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 podría sugerir una consulta que busque todos los registros de errores para tus contenedores.

Para ver y ejecutar consultas sugeridas en el panel de compilador de consultas, haz lo siguiente:

  1. Haz clic en la pestaña Sugerido.

    Pestaña de consultas sugeridas que muestra un conjunto de consultas

  2. Revisa la descripción de la consulta sugerida.

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

    a. Haz clic en la fila.

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

  4. En el panel del compilador de consultas, verás la consulta y las opciones Ejecutar o Guardar.

    a. Para guardar la consulta, haz clic en Guardar. La consulta aparecerá en tu lista Guardada, en la que puedes elegir ejecutar la consulta más tarde.

    b. Para ejecutar la consulta, haz clic en Ejecutar. La consulta aparece en Vista previa de consulta en el panel del compilador de consultas.

  5. Después de revisar la consulta, haz clic en Ejecutar consulta. Los resultados de la consulta sugerida se muestran en Resultados de consultas.

Las consultas sugeridas se crean de manera dinámica según el contexto del proyecto de Google Cloud. Es posible que las cargas de páginas sucesivas no muestren las mismas consultas en el mismo orden. Se prevé que esto suceda.

Consultas recientes

El panel del compilador de consultas muestra la pestaña 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.

La pestaña Recientes muestra las búsquedas recientes.

Para ver las consultas recientes, selecciona la pestaña Recientes en el panel del compilador de consultas. En la pestaña Recientes, tienes las siguientes opciones:

  • Transmitir. Transmite registros según los parámetros de búsqueda dados.
  • Ejecuta. Ejecuta la consulta.
  • Más opciones  Te permite ver los parámetros de consulta con las opciones para ejecutar la consulta o guardarla en tu lista de consultas Guardadas. También puedes seleccionar la consulta directamente para obtener estas opciones.

    Para ejecutar la consulta, selecciona Ejecutar.

    Para guardar la consulta, selecciona Guardar como y completa los siguientes campos:

    • Nombre: Proporciona un nombre.
    • 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 e ingresa los campos que deseas mostrar.
    • Truncar los campos de resumen (opcional): Habilita Truncar los campos de resumen y selecciona la cantidad de caracteres que deseas truncar y si el truncamiento debe ser al principio o al final de los campos.

    Selecciona Guardar consulta. La consulta ahora está disponible en tu lista de consultas guardadas.

Ten en cuenta que también puedes filtrar tus consultas recientes. El filtro coincide en el texto de la expresión de tu consulta.