Esta página se ha traducido con Cloud Translation API.
Switch to English

Compila consultas de registro

En esta página, se describe cómo compilar consultas en el Explorador de registros de Google Cloud Console para recuperar, definir mejor y analizar registros.

Antes de comenzar

Para ver los registros de un proyecto de Cloud específico, selecciona ese proyecto de Cloud en el selector de proyectos de Google Cloud Console y, luego, usa el Visor de registros heredados.

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.

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 que usan 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

  • Recurso: 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: te permite especificar el logName. Puedes seleccionar varios nombres de registro al mismo tiempo para agregar al compilador de consultas. Cuando seleccionas varias entradas, se usa el operador lógico OR.
  • Gravedad: 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 utilizar cualquiera de los menús de los parámetros de búsqueda, expanda estos menús y seleccione uno o varios parámetros. Luego, haga clic en Agregar (Add).

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 que usan el lenguaje de consultas de Logging

Puedes usar el lenguaje de consulta de Logging a fin de 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 información, 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. Selecciona Guardar 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 a los usuarios de un proyecto compartir sus consultas guardadas entre sí.

A fin de obtener información sobre las funciones y 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 compartir una consulta nueva.

Para compartir una consulta nueva, haz lo siguiente:

  1. Ingresa una consulta en el compilador de consultas.

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

  3. Completa los campos en el cuadro de diálogo para guardar.

  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. Seleccione Más opciones > Editar o seleccione la consulta directamente.

  3. En el cuadro de diálogo Editar-consulta, habilita Compartir con proyecto y selecciona Actualizar consulta.

Ahora tu consulta se comparte con otros usuarios del proyecto.

Visualiza consultas compartidas

Para ver rápidamente todas las consultas compartidas, primero ordena la columna Visibility para mostrar primero las consultas compartidas:

  1. Selecciona la pestaña Guardados.

  2. Selecciona Todas.

  3. Ordena la columna Visibilidad.

Se ordena la columna de visibilidad

La columna Visibilidad distingue las consultas compartidas con usted de las consultas que comparte 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 denotan por Compartidos por mí.

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:

  • Transmisión. Transmite registros según los parámetros de consulta 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.