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 entradas de registro almacenadas en buckets de registros. Ver y analizar entradas de registro individuales y una secuencia de entradas de registro puede ayudarte a solucionar problemas. También puedes leer datos de registro mediante la API de Logging y Google Cloud CLI.
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 de la consola de Google Cloud. Puedes seguir usando el Explorador de registros para 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.
Antes de comenzar
Si deseas obtener los permisos que necesitas para ver las entradas de registro, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Para ver las entradas de registro del bucket
_Required
y las de la vista_Default
en el bucket_Default
, haz lo siguiente: Visor de registros (roles/logging.viewer
) en tu proyecto. -
Para ver las entradas de registro en los buckets
_Required
y_Default
, haz lo siguiente: Visor de registros privados (roles/logging.privateLogViewer
) en tu proyecto. -
Para ver las entradas de registro almacenadas en una vista de registro de un bucket de registros, haz lo siguiente: Acceso de vista de registros (
roles/logging.viewAccessor
) en el proyecto que contiene el bucket definido por el usuario. Para obtener información sobre cómo obtener acceso a una vista de registro específica, consulta Cómo controlar el acceso a una vista de registro. -
Para ver los campos restringidos de
LogEntry
en un bucket, haz lo siguiente: Acceso al campo de registros (roles/logging.fieldAccessor
) de 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 roles, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios a través de funciones personalizadas o, también, otras funciones predefinidas.
Comenzar
Para comenzar a usar el Explorador de registros, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Explorador de registros:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
Selecciona el proyecto, la carpeta o la organización de Google Cloud que corresponda.
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 a los servicios de Google Cloud.
Interfaz del explorador de registros
La interfaz del Explorador de registros te permite mostrar entradas de registro, analizarlas y especificar parámetros de consulta.
El Explorador de registros contiene las siguientes secciones, que se detallan en esta página:
- Barra de herramientas Acción
- Panel Consulta
- Barra de herramientas Resultados
- Panel Campos de registro
- Histograma
- Panel Resultados de la consulta
Barra de herramientas de acciones
Con las funciones de la barra de herramientas Acción, puedes hacer lo siguiente:
- Define mejor el permiso: Configura qué entradas de registro se recuperan de los buckets de registros para mostrar. Las consultas que escribes filtran las entradas de registro recuperadas. Para obtener más información, consulta Define mejor el permiso.
- Obtener información: Consulta los vínculos a documentación y temas relevantes.
- Compartir vínculo: Crea una URL abreviada de la consulta y cópiala en tu portapapeles, para que sea más fácil compartir una consulta.
La URL copiada tiene el intervalo de tiempo absoluto correspondiente representado por el intervalo de tiempo de tu consulta; por ejemplo,
7:49:37 PM - 8:49:37 PM
.
Definir mejor el permiso
Cuando abres la página Explorador de registros, este recupera las entradas de registro que pasan por los receptores del recurso que seleccionaste y que tienes permiso para ver.
Para todos los recursos, las entradas de registro recuperadas incluyen las que se originan en el recurso. Para los proyectos de Google Cloud, las entradas de registro recuperadas también incluyen las que se enrutan al proyecto.
Si ingresas una consulta, el Explorador de registros mostrará solo las entradas de registro recuperadas que también coincidan con la consulta.
Por ejemplo, si agregas la consulta severity>=ERROR
da como resultado la visualización que muestra solo esas entradas de registro con un nivel de gravedad de al menos ERROR
.
Para tu sesión actual, puedes configurar qué entradas de registro recupera el Explorador de registros. Por ejemplo, para solucionar problemas, es posible que quieras examinar las entradas de registro que se incluyen en una vista de registro o que se originan en un proyecto específico de Google Cloud.
Para configurar qué entradas de registro recupera la página Explorador de registros, haz lo siguiente:
En la barra de herramientas Acción, selecciona Definir mejor el permiso.
Selecciona cómo deseas que la página Explorador de registros recupere entradas de registro:
Para recuperar las entradas de registro que se pasan a través de los receptores del recurso que seleccionaste, selecciona Alcance por proyecto actual.
Para todos los recursos, las entradas de registro recuperadas incluyen las que se originan en el recurso. Para los proyectos de Google Cloud, las entradas de registro recuperadas también incluyen las que se enrutan al proyecto.
Para recuperar entradas de registro por vista de registro, selecciona Limitar alcance por almacenamiento y, luego, selecciona una o más vistas de registro.
Para las carpetas y organizaciones, el menú de vistas de registro incluye todas las vistas de registro que almacenan entradas de registro que se originaron en esos recursos.
Para los proyectos de Google Cloud, el menú de vistas de registros incluye todas las vistas de registro en los buckets de registros del proyecto seleccionado. Para seleccionar vistas de registro en los buckets de registros almacenados en otro proyecto de Google Cloud, haz clic en add_circle Importar proyecto, selecciona el proyecto de Google Cloud y, luego, la vista de registro.
Haz clic en Aplicar.
Panel Consulta
Usa las funciones del panel Consulta (Query) 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 las entradas de registro 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 términos o frases de búsqueda. Para obtener más detalles, consulta Busca texto en los campos de registro.
Menús de filtro: Compila consultas basadas en Recurso, Nombre del registro y Gravedad. Para obtener más información, consulta Usa menús de filtro.
Campo de editor de consultas: Compila consultas avanzadas con el lenguaje de consulta de Logging. Para obtener más información, consulta Cómo escribir consultas avanzadas.
Pestaña Recientes: Visualiza las consultas que ejecutaste recientemente. Para obtener más información, revisa Cómo usar consultas recientes.
Pestaña Guardadas: Visualiza las consultas guardadas y las consultas que otros usuarios del proyecto de Google Cloud compartieron contigo. Para obtener más información, lee Cómo guardar consultas y Cómo compartir consultas.
Pestaña Suggested: Visualiza consultas sugeridas en función de los recursos de tu proyecto de Google Cloud. Para obtener más información, revisa Usa las consultas sugeridas.
Pestaña Biblioteca: Visualiza y ejecuta consultas proporcionadas por Google según tus casos de uso. Para obtener más información, consulta 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 realizaste cuando creaste una consulta en el panel Query.
Transmitir registros: Visualiza las entradas de registro a medida que Logging las almacena en buckets de registros. Para obtener más información, consulta Transmite registros.
Ejecutar consulta: Ejecuta tus consultas después de haberlas compilado 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, estos 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 al panel Consulta y, luego, selecciona Transmitir registros. Dado que Logging almacena los datos de registros en buckets de registros, solo se muestran aquellos registros que coinciden con la consulta en el panel Resultados de la consulta. Cuando no se proporciona una consulta, Logging muestra cada entrada de registro mientras están almacenadas.
Para detener la transmisión, haz clic en Detener transmisión o desplázate dentro del panel Resultados de la consulta.
Barra de herramientas de Resultados
En la barra de herramientas Resultados, tienes las siguientes opciones:
- toggle_off Campo de registros: Oculta o muestra el panel Campo de registro del diseño de la página del Explorador de registros. Para obtener más información, consulta la sección del panel Campo de registro de este documento.
- toggle_off Histograma: Oculta o muestra el panel Histograma en el diseño de la página del Explorador de registros. Para obtener más información, consulta la sección Histograma de este documento.
- manage_search Analizar resultados: agrega y grafica 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 Analizar resultados de este documento.
- add_chart Crear métrica: Configura una métrica basada en registros.
- add_alert Crear alerta: Configura una política de alertas basada en registros.
- Pasar a los más recientes: 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, ejecutará 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 las políticas de alertas basadas en registros deo crear un receptor.
Analizar resultados
Puedes agregar, analizar y graficar tus datos de registro con las consultas de SQL en la página Análisis de registros cuando tu proyecto contiene buckets de registros que se actualizaron para usar el Análisis de registros. Para ir a la página Análisis de registros desde el Explorador de registros, en la barra de herramientas Resultados, haz clic en manage_search Analizar resultados.
El botón manage_search 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 manage_search Analizar resultados cuando se actualice al menos un bucket dentro del permiso de almacenamiento para usar el Análisis de registros. Si deseas obtener más información, consulta Actualiza un bucket de registros para usar el Análisis de registros.
Lo siguiente ocurre cuando haces clic en manage_search Analizar resultados:
El intervalo de tiempo en el Explorador de registros puede ajustarse 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 Limitar alcance por proyecto actual, se consultarán las siguientes vistas:
Una vista de registro del bucket
_Required
Una vista de registro del bucket
_Default
Todas las vistas de registros en buckets definidos por el usuario en el proyecto actual.
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 consulta ningún buckets de registros.
En la página Análisis de registros, puedes ver los resultados en formato tabular o como un gráfico. En la pestaña Gráfico, puedes seleccionar los datos del gráfico, personalizar su configuración 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 consultas y guardar gráficos en un panel personalizado, consulta Gráficos de los resultados de consultas con el Análisis de registros.
Si quieres obtener información sobre el uso de SQL para escribir consultas, 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. En el panel, se muestran las 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. En este panel, se muestran los recuentos de entradas de registro para cada dimensión compatible. Puedes hacer una selección para cada dimensió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 tu 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 filtraste los registros por tipo de recurso, se propagará el menú Servicio. Las entradas de este menú se determinan de forma dinámica mediante 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 servicios 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 propagará el menú Servicio. Las entradas de este menú se determinan de forma dinámica con 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 seleccionaste Limitar el 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 una gravedad y un tipo de recurso mediante el panel Campos de registro:
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 registros.
Para agregar un campo al panel Campo de registro, haz lo siguiente:
En el panel Resultados de la consulta, expande una entrada de registro con un clic en chevron_right Expandir.
Selecciona 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
yprotoPayload.startTime
. - Campos con alta cardinalidad, por ejemplo,
insertId
yprotoPayload.latency
. - Campos con índices de array en su ruta, por ejemplo,
protoPayload.authorizationInfo[0].resource
Histograma
Con el panel Histograma, 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 ocultar o mostrar el panel Histograma, haz clic en Histograma en la barra de herramientas Resultados.
Funciones de histograma
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.
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 los registros con controles de tiempo.
Cronograma: Te muestra el intervalo de tiempo de los registros, representados por barras de histogramas, que se muestran en el panel Resultados de la consulta. El cronograma ayuda a orientarte con respecto a los registros que estás viendo dentro del intervalo de tiempo más amplio de tu 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.
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 chevron_right flecha hacia adelante para deslizar la línea de tiempo a un momento posterior. Haz clic en la chevron_left flecha hacia atrás para deslizar el cronograma a un horario anterior.
Acercar y alejar la imagen: Haz clic en zoom_out Alejar para ampliar los datos que se muestran en el cronograma. Haz clic en zoom_in Acercar para acotar los datos que se muestran en el cronograma.
Las modificaciones de la línea de tiempo solo deben realizarse entre el momento actual ("ahora") y el período de hace 30 días.
Desplázate o ve registros del período
Además de los controles de tiempo mencionados anteriormente, el histograma proporciona las funciones Desplazarse al tiempo y Zoom al tiempo para brindarte un control más detallado del histograma y los datos que ves en otros paneles del Explorador de registros.
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 hacia el momento para explorar los datos de tus registros 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:
Mantén el puntero 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.
En el panel, selecciona Desplazarse por registros.
De manera alternativa, hacer clic en una barra de histograma equivale a seleccionar Desplazarse al tiempo.
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 encuentra 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:
Mantén el puntero 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.
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 entradas de registro individuales y agrupar y analizar entradas de registro para encontrar patrones en tus registros.
Configura la columna Time
En la columna Tiempo, en el panel Resultados de la consulta, se muestran las marcas de tiempo de tus 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 quieres mostrar, haz clic en el menú arrow_drop_down 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
Busca patrones en tus registros mediante campos de resumen
Supongamos que estás revisando las entradas de registro en los resultados de la consulta y deseas leer rápidamente los resultados según un campo LogEntry
determinado. O tal vez quieras agrupar tus entradas de registro por un par de campo-valor determinado. Puedes agregar campos de resumen a tus 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 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 toggle_off de 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 línea. Para mostrar hasta 10 líneas por cada entrada de registro, usa el botón de activación toggle_off Unir líneas. Los espacios en blanco se conservan en cada entrada de registro.
Para ocultar campos de resumen específicos, habilita Campos de resumen y, luego, haz clic en Ocultar campo de resumen.
Para modificar los campos de resumen, haz lo siguiente:
Haz clic en el botón edit Editar de la columna Resumen para abrir el menú de edición.
En el diálogo Administrar campos de resumen, puedes hacer lo siguiente:
Agrega cualquier nombre de campo personalizado a Campos de resumen personalizados.
La selección del campo de resumen tiene las siguientes características:
- Completar automáticamente con los registros que se muestran en los resultados de tu consulta
- Corrección de campos para caracteres legales entre comillas
Por ejemplo, si escribes
jsonPayload.id-field
, se cambiará ajsonPayload."id-field"
.También puedes seleccionar cualquier campo
LogEntry
, independientemente de si se te sugiere con la función de autocompletar.Para quitar un campo de resumen personalizado existente, haz clic en la
X
del chip.Activa y desactiva el truncamiento en tus campos de resumen personalizados.
Para acortar la visualización de los valores del campo de resumen, usa el botón de activación toggle_off junto a Truncar los campos de resumen personalizados. Puedes elegir cuántos caracteres mostrar antes de que se trunque el campo y si debe mostrarse el principio o el final del campo.
Ocultar o mostrar los campos de resumen predeterminados:
Para personalizar qué campos de resumen predeterminados se muestran en los resultados de la consulta, expande el menú Ocultar o mostrar campos de resumen predeterminados.
Haz clic en Aplicar.
Tus campos de resumen ahora están actualizados en los resultados de tu consulta.
Busca los resultados de tu consulta
Para buscar el contenido de los Resultados de la consulta, haz clic en Buscar en los resultados en el panel Resultados de la consulta y, luego, ingresa el término de búsqueda. Este filtro te permite encontrar información en tus entradas de registro sin tener que 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:
Ver entradas de registro similares
Puedes ver las 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:
En el panel Resultados de la consulta, en una entrada de registro, haz clic en chevron_right Expandir.
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, haz lo siguiente:
En el panel Resultados de la consulta, en una entrada de registro, haz clic en chevron_right Expandir.
Expande el menú Entradas similares y, luego, 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
- Ejemplos de entradas de registro que contienen el patrón
En este diálogo, puedes ocultar o mostrar entradas de registro:
Ocultar entradas de registro similares
Puedes ocultar entradas de registro similares, lo que te permite quitar registros de los resultados de las consultas.
Hay dos maneras de ocultar entradas de registro similares:
Oculta grandes cantidades de entradas de registro agrupadas automáticamente. Cuando ejecutas una consulta, sus resultados se analizan en busca de patrones y, luego, las entradas de registro se agrupan de forma automática según el contenido similar de un campo 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 pueden estar ocultos:
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 abrirá una ventana separada que describe el patrón encontrado y muestra ejemplos de las entradas.
Cuando ocultas registros similares, no se guarda información fuera de la sesión del Explorador de registros y cada consulta produce un análisis nuevo, que se basa solo en los registros que se muestran. Las diferentes 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 específica. Para ocultar entradas de registro similares a una entrada de registro, haz lo siguiente:
En la entrada de registro, haz clic en chevron_right Expandir, haz clic en el menú Entradas similares y, luego, selecciona Ocultar entradas similares.
La consulta se actualiza y el panel Resultados de la consulta se vuelve a cargar. No se muestran las entradas de registro similares a la entrada de registro seleccionada.
Cómo ocultar o ver las entradas de registro que coinciden con un campo
Puedes ocultar o ver las entradas de registro que coincidan con un campo en una entrada de registro, lo que te permite enfocarte en entradas que tengan 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:
En el panel Resultados de la consulta, en la entrada de registro, haz clic en chevron_right Expandir.
Haz clic en el valor de un campo dentro de la entrada de registro, como
compute.googleapis.com
, que esserviceName
.Verás el siguiente menú:
Selecciona Ocultar entradas coincidentes o Mostrar 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 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:
- Mantén el puntero sobre la entrada de registro que quieres fijar.
- Haz clic en push_pin Fijar.
Después de fijar una entrada de registro, su fondo se oscurece, y se muestra el ícono de Fijar push_pin. También aparece un ícono de fijar en el panel Histograma basado en el
timestamp
de la entrada de registro fijada:
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 consulta nueva que muestre entradas de registro que coincidan con el tipo de recurso o las etiquetas de recurso 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:
Haz clic en arrow_drop_down flecha hacia abajo junto al registro fijado para expandir el menú de fijar.
En el menú de fijar, realiza una selección:
Para volver a ejecutar la consulta con el mismo
resource.type
que el registro fijado, selecciona Same resource.type.Por ejemplo, supongamos que fijas una entrada de registro con un
resource.type
dek8s_node
. Si seleccionas Same resource.type, la consulta se vuelve a ejecutar para mostrar todas las entradas de registro conresource.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 Histograma, haz clic en push_pin Fijar y, luego, elige una de las siguientes opciones de menú:
- Desplazarse hasta la entrada de registro: Coloca la entrada de registro en el panel Resultados de la consulta actual y visualiza la entrada de registro fijada en el contexto de registros cercanos.
- Zoom a la entrada de registro: Limita el intervalo de tiempo que muestra el panel Histogram (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.
Cuando una entrada de registro contiene solo el campo trace
, solo aparecerá 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 comoTrue
. Para obtener más información sobre el muestreo, consulta Tasa de muestreo.
Copia un vínculo a una entrada de registro
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.
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:
Haz clic en save_alt Descargar en la barra de herramientas del panel Resultados de la consulta.
En el cuadro de diálogo Download logs (Descargar registros), selecciona el formato CSV o JSON y, luego, haz clic en Download (Descargar).
Selecciona qué hacer con los datos de registro. Tienes las siguientes opciones:
- Descarga los datos en tu computadora.
- Descargar los datos en 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.
Para obtener información sobre la solución de problemas, consulta Falla la descarga de registros.
Consultas de ejemplo
Para ver las consultas sugeridas, organizadas por producto y caso de uso de Google Cloud, lee Consultas de muestra con el Explorador de registros. Por ejemplo, puedes ejecutar consultas relacionadas con Kubernetes para encontrar registros de Google Kubernetes Engine.
Ver 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 del Explorador de registros. Por ejemplo, para el tipo de recurso gce_instance
, verás el nombre de la VM junto con el ID de la VM. Los nombres de recursos te ayudan a identificar el ID de recurso correcto, en el que puedes compilar 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 ID de recurso 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 de los campos.
- Resultados de la consulta: En los registros de instancias de VM de Compute Engine, el campo
resource.labels
muestra metadatos con el nombre del recurso correspondiente. - Campos de resumen: para los registros de instancias de VM de Compute Engine, el chip muestra el nombre del recurso en lugar del ID del recurso.
Solucionar 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 de receptores, consulta Soluciona problemas de enrutamiento y receptores.
Falla la descarga de registros
Usas el Explorador de registros y haz clic en save_alt Descargar. El comando se inicia, pero no se completa o informa un error.
Para resolver este problema, prueba lo siguiente a fin de reducir el tiempo que tarda en ejecutarse el comando:
- En el diálogo Descargar registros, reduce el valor de Cantidad máxima de entradas de registro.
- Reduce el período durante el cual se consultan los registros.
- En la barra de herramientas de los resultados de la consulta, haz clic en Ocultar entradas similares antes de comenzar la descarga.
- Modifica tu consulta para usar campos indexados.
No se pueden encontrar 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:
-
En la consola de Google Cloud, ve a la página Instancias de VM.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Compute Engine.
Selecciona la instancia y, luego, elige Puerto en serie 1 (consola) en la sección Registros de la página.
Puedes configurar las instancias de modo que las salidas del puerto en serie se envíen a Cloud Logging. Para obtener más información, consulta Habilita e inhabilita el registro de salidas de puertos en serie.
Obtener el ID de la organización o del proyecto de Google Cloud
Para obtener un ID de organización o un proyecto de Google Cloud desde cualquier parte de la consola de Google Cloud, 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.
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, elige el proyecto de Google Cloud correcto en el selector de proyecto y organización de Google Cloud.
¿Tu proyecto de Google Cloud usa recursos que generan registros? ¿Hay actividad en esos recursos? Incluso si el proyecto de Google Cloud es nuevo, debería 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 está usando el permiso correcto para ver los registros? Si quieres obtener instrucciones para 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 las entradas para ese recurso. Si Cloud Logging identifica más de 200 buckets en los que se podrían 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 registros 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. Ajusta el cronograma del histograma con los controles de tiempo del histograma o 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
Si quieres saber cómo obtener asistencia, consulta la página de asistencia de observabilidad de Google Cloud.