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.
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. con 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:
-
Ve al menú de navegación de Google Cloud menu y selecciona Logging > Explorador de registros:
Ir al Explorador de registros - Selecciona un proyecto de Google Cloud.
- 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:
- Menús desplegables del compilador de consultas
- Consultas que usan el lenguaje de consulta de Logging
- Pestañas de consultas Recientes, Guardadas y Sugeridas
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.
- 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:
- Consulta mediante una expresión de marca de tiempo
Consulta mediante el selector de intervalos de 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.
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:
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).
Agrega un Name (Nombre) para la consulta.
Los nombres tienen un límite de 64 caracteres.
Para agregar campos de resumen a tu consulta, activa Include summary fields (opcional).
Agrega una Description (Descripción) para tu consulta (opcional).
Las descripciones tienen un límite de 1,000 caracteres. No incluyas información sensible.
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 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:
Ingresa una consulta en el compilador de consultas.
Selecciona Guardar en el panel del compilador de consultas.
Completa los campos en el cuadro de diálogo para guardar.
Habilita Compartir con el proyecto.
Ahora tu consulta se comparte con otros usuarios del proyecto.
Para compartir una consulta ya guardada, haz lo siguiente:
Selecciona Guardado.
Seleccione Más opciones more_vert > Editar create o seleccione la consulta directamente.
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:
Selecciona la pestaña Guardados.
Selecciona Todas.
Ordena la columna 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:
Haz clic en la pestaña Sugerido.
Revisa la descripción de la consulta sugerida.
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 more_vert y selecciona Ver.
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.
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.
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 more_vert 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.