Visualiza registros con el explorador de registros

En este documento, se proporciona una descripción general del Explorador de registros en Google Cloud Console, que puedes usar para recuperar, ver y analizar datos de registro. El Explorador de registros te permite encontrar y ver tus registros para que puedas solucionar problemas.

El Explorador de registros no admite operaciones de agregación, como contar la cantidad de entradas de registro que contienen un patrón específico. Para realizar operaciones agregadas, habilita las estadísticas en el bucket de registros y, luego, usa la página Estadísticas de registros. También puedes usar el Explorador de registros para ver los registros en buckets habilitados para estadísticas. Para obtener más información, consulta Descripción general de estadísticas de registro.

También puedes leer registros mediante la API de Logging y la CLI de Google Cloud.

Comenzar

Para comenzar a usar el Explorador de registros, haz lo siguiente:

• Asegúrate de tener la función de Identity and Access Management correcta para ver los registros. Para obtener información sobre las funciones y los permisos de IAM, consulta Control de acceso con IAM.

• Ten en cuenta que 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.

• Ten en cuenta que si transfieres registros de nube híbrida y local a través de BindPlane, puedes encontrar estos registros en el tipo de recurso generic_node.

• Navega al Explorador de registros:

  Ir al Explorador de registros.

  Selecciona el proyecto de Cloud adecuado.

Interfaz del explorador de registros

La interfaz del explorador de registros te permite recuperar registros, analizar datos de registros y definir mejor tus parámetros de búsqueda.

El Explorador de registros contiene las siguientes secciones, que se detallan en esta página:

1. Barra de herramientas Acción
2. Panel Consulta
3. Barra de herramientas Resultados
4. Panel Campos de registro
5. Histograma
6. Panel Resultados de la consulta

Barra de herramientas de acción

Con las funciones de la barra de herramientas de acciones, puedes hacer lo siguiente:

• Define mejor el permiso: Limitar el alcance de tu búsqueda por registros en tu proyecto de Cloud actual únicamente o por una o más vistas de almacenamiento. Para obtener más información sobre el alcance, consulta Define mejor el permiso.
• Más información: Consulte vínculos a documentación y temas relevantes.
• Compartir vínculo: Crea una URL acortada de la consulta actual y cópiala en el 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 actual de tu consulta, por ejemplo, 7:49:37 PM - 8:49:37 PM.

Nota: Si los datos se administran a través de un entorno de Assured Workloads, es posible que esta función se vea afectada o restringida. Para obtener más información, consulta Restricciones y limitaciones en Assured Workloads.

Defina mejor el permiso

Puedes definir mejor el permiso de los registros que se muestran en el explorador de registros a través de la opción Definir mejor el permiso. Solo puedes buscar registros en el proyecto actual de Cloud o registros de búsqueda en una o más vistas de almacenamiento. Para definir mejor el permiso del explorador de registros, haz lo siguiente:

1. En la barra de herramientas Acción, selecciona Definir mejor el permiso.

2. En el panel Definir mejor el permiso, selecciona la opción Permiso por.

   

   • Alcance por permiso: Te permite buscar registros que genera el proyecto de Cloud actual.

   • Alcance por almacenamiento Te permite buscar registros en función de una o más vistas de almacenamiento. Para obtener más información sobre las vistas de registro, consulta Configura el acceso a nivel de bucket .

3. Si seleccionas Alcance por almacenamiento, elige uno o más depósitos que desees ver.

   El cuadro de diálogo muestra vistas de almacenamiento que cumplen las siguientes condiciones:

   • El usuario tiene acceso a la vista de almacenamiento.
   Nota: El acceso a la vista de almacenamiento requiere el permiso logging.views.access. Este permiso no se incluye en la función de IAM visor de registros. Para obtener más información, consulta Control de acceso con IAM: funciones predefinidas.
   • Los buckets de registro pertenecen al proyecto de Cloud seleccionado o el proyecto de Cloud seleccionado ya enruta registros a los buckets de almacenamiento.

4. Haz clic en Aplicar.

Panel Consulta

Usa las funciones del panel Query para hacer lo siguiente:

• Pestaña Query: Cree y defina mejor las consultas con las siguientes funciones:

  • Selector de intervalo de tiempo: especifica un intervalo de tiempo para los registros que deseas ver. Para obtener más información, consulta Cómo usar el selector de intervalo de tiempo.

  • Cuadro de texto de búsqueda: Busca 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.

  • Filtrar menús: Crea consultas basadas en recurso, Nombre de registro y Gravedad. Para obtener más información, consulta Usa los menús de filtro.

  • Campo de editor de consultas: Crea consultas avanzadas con el lenguaje de consultas de Logging. Para obtener más información, visita la página sobre cómo escribir consultas avanzadas.

• Pestaña Recientes: Visualiza las consultas que ejecutaste recientemente. Para obtener más información, consulta Usa consultas recientes.

• Pestaña Guardados: visualiza tus consultas guardadas y las consultas que otros usuarios del proyecto de Cloud compartieron contigo. Para obtener más información, consulta Cómo guardar consultas y Cómo compartir consultas.

• Pestaña Sugerencia: Visualiza las consultas sugeridas en función de los recursos del proyecto de Cloud. Para obtener más información, consulta Usa las consultas sugeridas.

• Pestaña Library: Visualiza y ejecuta consultas proporcionadas por Google en función de tus casos prácticos. Para obtener más información, consulta Selecciona consultas de la biblioteca.

• Guardar: Guarda las consultas que se pueden ver y ejecutar desde la pestaña Guardadas.

• Clear query (Borrar consulta): borra y restablece las selecciones que realizaste cuando compilaste una consulta en el panel Query (Consulta).

• Transmitir registros: Mira las entradas de registro a medida que Logging las transfiere. Para obtener más información, consulta Transmite registros.

• Ejecutar consulta: Ejecuta tus consultas una vez que las hayas creado en el panel Consulta.

Si no ve el campo query-editor, habilite Show query. Si agregas cualquier término de búsqueda en el cuadro de texto de búsqueda, esos términos también aparecen en el campo de consulta-editor y se evalúan como parte de tu expresión de consulta.

Después de revisarla, haz clic en Ejecutar consulta. Los registros que coincidan con tus consultas aparecerán en el panel Resultados de la consulta. Los paneles Histogram (Histograma) y Log fields (Campos de registro) también se ajustan según la expresión de la consulta.

Transmitir registros (Stream logs)

Puedes transmitir los registros a medida que Logging los transfiere, o puedes agregar una consulta a fin de transmitir solo aquellos registros que coincidan con la consulta.

Para transmitir registros basados en una consulta, agrega una consulta en el panel Consulta (Query) y, luego, selecciona Transmitir registros (Stream logs). A medida que Logging transfiere los datos de registro, solo se mostrarán los que coincidan con la consulta en el panel Resultados de la consulta. Si no se proporciona una consulta, Logging muestra cada registro a medida que se transfiere.

Para detener la transmisión, haz clic en Detener transmisión o desplázate dentro del panel Query results (Resultados de la consulta).

Barra de herramientas de resultados

En la barra de herramientas Resultados, puedes hacer lo siguiente:

• Muestra el panel Campo de registros: Muestra u oculta rápidamente este panel en el diseño de la página del Explorador de registros.
• Muestra el panel Histograma: Muestra u oculta rápidamente este panel en el diseño de la página del Explorador de registros.
• Crear métrica: Configura una métrica basada en registros basada en la expresión de consulta actual.
• Crear alerta: Configura una alerta basada en registros basada en la expresión de consulta actual.
• 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 intervalo personalizado y se establece una hora de finalización, se ejecuta la consulta en un intervalo de tiempo predeterminado de una hora. De lo contrario, se actualiza con la fecha de inicio o la duración actual y ejecuta la consulta. Ten en cuenta que la expresión de consulta no se modifica cuando usas esta característica.
• Más acciones: Usa estas opciones adicionales para administrar las alertas basadas en registros o crear un receptor.

El panel Campos de registro

El panel Campos de registro ofrece un resumen de alto nivel de los datos de registros y proporciona una forma más eficiente de definir mejor una consulta. Muestra las entradas de registro desglosadas por dimensiones diferentes, que corresponden a los campos en estas entradas. Para cada campo, el panel Campos de registro muestra los valores y su incidencia en orden de frecuencia descendente. Los recuentos de campos de registro corresponden al intervalo de tiempo en el selector de rango de tiempo.

Para ocultar o mostrar el panel Campos de registro (Log fields), haz clic en el botón Campos de registro (Logs fields) en la barra de herramientas Resultados (Results).

El panel Campos de registro se propaga y se actualiza en función de una consulta ejecutada en el campo de editor de consultas.

Si la consulta está vacía, el panel Campos de registro muestra los recuentos de entradas de registro por los campos Tipo de recurso y Gravedad.

Si seleccionaste Alcance por almacenamiento, también verás ID del proyecto y los recuentos correspondientes de entradas de registro.

Si seleccionas un tipo de recurso del panel Campos de registro, un conjunto de campos relevantes, basados en las etiquetas de recursos, se propaga en el panel. Esto te permite investigar los datos de registros para ese tipo de recurso específico. Si deseas quitarlos, haz clic en Borrar junto al campo Tipo de recurso.

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. Para agregar un campo al panel Campos de registro, haz lo siguiente:

1. En el panel Resultados de la consulta, haz clic en el botón expandir para expandir una entrada de registro.

2. Haz clic en 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 y protoPayload.startTime.
• Campos con alta cardinalidad, por ejemplo, insertId y protoPayload.latency.
• Campos con índices de array en su ruta de acceso, por ejemplo, protoPayload.authorizationInfo[0].resource.

Analiza registros con el panel Campos de registro

Para acotar y definir mejor una consulta, puedes agregar pares de campo y valor del panel Campos de registro a la expresión en el panel Consulta. Para hacerlo, en el panel Campos de registro, haz clic en el valor de un campo. Esto agrega el par campo-valor a la expresión mediante el operador AND. Luego, se ejecuta la consulta.

Puedes agregar pares de valor de campo anidados, además de pares de valor de campo de nivel superior, al panel Campos de registro. Por ejemplo, supongamos que agregaste jsonPayload.message al panel Log fields. Si seleccionas un valor de jsonPayload.message específico, se propaga el campo de consulta-editor.

Los paneles Histograma y Resultados de la consulta también cambian para reflejar la consulta actual.

Cuando se ejecuta una consulta, se analizan las entradas de registro y los recuentos en los campos de registro cambian. Cuando se completa la consulta, se muestran los recuentos totales de todos los campos de registro.

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 el botón Histograma en la barra de herramientas Resultados.

Funciones de Histograma

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

2. 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 registros mediante controles de tiempo.

3. Cronograma: Muestra el intervalo de tiempo de los registros, representados por barras de histograma, que se muestran en el panel Resultados de la consulta. El cronograma te ayuda a orientar los registros que ves dentro del intervalo de tiempo mayor de la consulta.

Analiza registros con controles de tiempo

Puedes usar los controles de tiempo del histograma para investigar y analizar los datos de tus registros.

Sugerencia: Cuando ajustas los controles de tiempo del histograma, los datos de registro en los paneles Resultados de la consulta y Campos de registro se ajustan de acuerdo con el intervalo de tiempo que captura el cronograma del histograma. Ajustar los controles de tiempo del histograma no modifica la expresión de consulta en el panel Query.

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. Haga clic en Ejecutar.

• Mueve el cronograma hacia delante y hacia atrás: Haz clic en la flecha hacia delante para mover el cronograma a una hora posterior. Haz clic en la flecha hacia atrás para mover el cronograma a una hora anterior.

• Acercar y alejar: Haz clic en el ícono de alejar para ampliar los datos que se muestran en el cronograma. Haz clic en el ícono de acercar para reducir los datos que se muestran en el cronograma.

Las modificaciones del cronograma están restringidas para estar entre la hora actual (“ahora”) y hace 30 días.

Desplázate o ve registros del período

Además de los controles de tiempo anteriores, el histograma proporciona las funciones Desplazarse por registros (Scroll to time) y Ver registros del período (Zoom to time) para darte un control más detallado del histograma y los datos que ves en otros paneles en el 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 a la hora para explorar los datos de registros sin cambiar los valores en los paneles Histogram (Histograma) y Log fields (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:

1. Desplaza el cursor 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.

2. En el panel, selecciona Desplazarse por registros.

   De manera alternativa, hacer clic en una barra de histograma, en lugar de colocar el cursor sobre ella, es equivalente a seleccionar Desplazarse por registros.

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 rango de tiempo de la barra de histograma seleccionada en 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:

1. Coloca el cursor 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.

2. 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 las entradas de registro individuales y agrupar y analizar las entradas de registro a fin de encontrar patrones en tus registros.

Encuentra patrones en tus registros mediante campos de resumen

Supongamos que estás revisando las entradas de registro en los resultados de tu consulta y deseas leer los resultados rápidamente con 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, la siguiente imagen muestra 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 tus resultados de consulta actuales y los campos de resumen personalizados te permiten seleccionar cualquier campo en el LogEntry.

Para modificar los campos de resumen, haz lo siguiente:

1. Haga clic en Editar en la columna Resumen para abrir el menú de edición:

   

2. En el cuadro de diálogo Administrar campos de resumen, puedes hacer lo siguiente:

   • Para mostrar entradas de registro en formato de texto sin procesar, desactiva Campos de resumen predeterminados con el interruptor de activación y no agregues ningún campo de resumen personalizado.

   • Agrega los nombres de los campos personalizados a los campos de resumen personalizados.

     La selección del campo de resumen tiene las siguientes características:

     • Completa automáticamente los registros que se muestran actualmente en los resultados de tu consulta.
     • Corrección de campos para caracteres legales entre comillas

     Por ejemplo, si escribes jsonPayload.id-field, se cambiará a jsonPayload."id-field".

     También puedes seleccionar cualquier campo LogEntry, sin importar si se te sugiere con la función de autocompletado.

     Para quitar un campo de resumen personalizado existente, haz clic en la X en su chip.

   • Activa o desactiva el truncamiento para tus campos de resumen personalizados. Usa el interruptor de activación en Truncar los campos de resumen para acortar la visualización de los valores del campo de resumen. Luego, elige cuántos caracteres mostrar antes de que se trunque el campo y si se muestra el principio o el final del campo.

     Sugerencia: En los resultados de la consulta, colocar el cursor sobre un campo de resumen truncado muestra su valor completo.

3. Haz clic en Aplicar.

   Tus campos de resumen ahora están actualizados en los resultados de tu consulta.

Buscar 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 crear una consulta nueva.

Los términos que coinciden con los criterios de búsqueda se destacan en las entradas de registro en el panel Query results (Resultados de la consulta):

Ver entradas de registro similares

Puedes ver entradas de registro 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:

1. En el panel Resultados de la consulta, expande una entrada de registro.

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

1. En el panel Resultados de la consulta, expande una entrada de registro.

2. Expande el menú Entradas similares y, luego, selecciona Obtener vista previa de entradas similares.

   Se abrirá un cuadro de diálogo independiente 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 cuadro de diálogo, puedes ocultar o mostrar las entradas de registro:

   

Ocultar entradas de registro similares

Puedes ocultar entradas de registro similares, lo que te permite quitar registros de los resultados de tu consulta.

Existen dos maneras de ocultar entradas de registro similares:

• Oculta grandes cantidades de entradas de registro agrupadas automáticamente. Cuando ejecutas una consulta, los resultados se analizan en busca de patrones y, luego, las entradas de registro se agrupan de forma automática en función de contenido de campo de registro similar. Si se detecta un patrón significativo, aparece un banner en el panel Resultados de la consulta que muestra el porcentaje de resultados que se pueden ocultar:

  

  Ocultar entradas similares: Este botón agrega una cláusula a la consulta y vuelve a cargar los resultados.

  Vista previa: Se abre una ventana aparte 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 genera un análisis nuevo, basado solo en los registros que se muestran. Las consultas diferentes analizan diferentes partes de las entradas de registro según los tipos de registros que se muestran.

• Oculta entradas de registro similares a una entrada de registro específica. Para ocultar entradas de registro similares a una entrada de registro, haz lo siguiente:

  1. Haz clic en Expandir en la entrada de registro, en el menú Entradas similares y, luego, selecciona Ocultar entradas similares.

     Se actualiza la consulta y se vuelve a cargar el panel Resultados de la consulta. No se muestran las entradas de registro similares a la entrada de registro seleccionada.

Ocultar o ver las entradas de registro que coinciden con un campo

Puedes ocultar o ver las entradas de registro que coinciden con un campo en una entrada de registro, lo que te permite enfocarte en las entradas que tienen el mismo contenido de campo.

Para ocultar o ver las entradas de registro que coinciden con un campo específico de una entrada de registro, haz lo siguiente:

1. En el panel Resultados de la consulta, haz clic en Expandir en la entrada de registro.

2. Haz clic en el valor de un campo dentro de la entrada de registro, como compute.googleapis.com, que es un serviceName.

   Verás el siguiente menú:

   

3. Selecciona Mostrar entradas coincidentes o bien Ocultar entradas coincidentes.

   La consulta se actualiza con una que muestra u oculta 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 fija 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 fijar la entrada de registro.

Para fijar una entrada de registro, haz lo siguiente:

1. Desplázate sobre la entrada de registro que deseas fijar.
2. Haz clic en el ícono de fijar .

Después de fijar una entrada de registro, su fondo se oscurece y se muestra el ícono de marcador . También aparece un ícono de marcador en el panel Histograma en función del timestamp fijado 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 coincidan 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 del recurso fijado.

Para fijar una entrada de registro y mostrar entradas de registro que coincidan con el mismo tipo de recurso o etiqueta del recurso, haz lo siguiente:

1. Haz clic en la flecha hacia abajo junto al registro fijado para expandir el menú de marcadores.

2. Selecciona una opción del menú de marcadores:

   • 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 de k8s_node. Si seleccionas Same resource.type, la consulta se vuelve a ejecutar para mostrar todas las entradas de registro con resource.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 Same trace.

   • 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 el ícono de marcador y, luego, elige entre las siguientes opciones de menú:

• Desplazarse a la entrada de registro: lleva la entrada de registro al panel Resultados de la consulta actual y observa 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 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 del panel de detalles, consulta Ver detalles de seguimiento.

Nota: Ver detalles de seguimiento solo está disponible si traceSampled es verdadero.

• 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 como True. Para obtener más información sobre el muestreo, consulta Tasa de muestreo.

Visualiza los datos de Monitoring

Para ciertos registros, como los registros de GKE y de Compute Engine, puedes hacer clic en el tipo de recurso de la línea de resumen del registro para mostrar un menú con las siguientes opciones:

• Ver detalles de supervisión: Abre un panel de detalles para un recurso de GKE. Para obtener información sobre el panel de detalles, consulta Ver detalles del recurso.
• Ver en Monitoring: Se abre una página de Monitoring para el recurso.
• Ver en GKE o Ver en Compute Engine: abre la página Detalles del recurso dentro de la interfaz de usuario de GKE o Compute Engine.

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

1. Haz clic en Descargar en el panel Resultados de la consulta.

2. En el cuadro de diálogo Descargar registros, selecciona formato CSV o JSON.

3. Selecciona qué hacer con los datos de registro. Tienes las siguientes opciones:

   • Descarga los datos en tu computadora.
   • Descarga los datos a 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.

Nota: 10,000 es la cantidad máxima de registros que puedes descargar.

Consultas de ejemplo

En el caso de las consultas sugeridas, ordenadas por producto y caso práctico de Google Cloud, visita Consultas de muestra mediante el explorador de registros. Por ejemplo, puedes ejecutar consultas relacionadas con Kubernetes para encontrar los registros de Google Kubernetes Engine.

Ver registros de Compute Engine

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 en varios lugares en el Explorador de registros. Por ejemplo, para el tipo de recurso gce_instance, puedes ver el nombre de la VM junto con el ID de la VM. Los nombres de los recursos te ayudan a identificar el ID de recurso correcto, en el que puedes crear consultas.

Es posible que veas nombres de recursos de Compute Engine en los siguientes lugares:

• Menús de filtro de panel Query: Los tipos de recursos de Compute Engine muestran los nombres de los recursos, con sus ID de recursos correspondientes como subtexto.
• Campos de registro: los tipos de recursos de Compute Engine muestran el nombre del recurso, en lugar del ID, en las dimensiones del campo.
• Resultados de la consulta: para los registros de instancias de VM de Compute Engine, el campo resource.labels muestra metadatos con el nombre del recurso correspondiente.
• Campos de resumen: En los registros de instancias de VM de Compute Engine, el chip muestra el nombre del recurso en lugar del ID del recurso.

Soluciona 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 registros en los destinos de receptores, consulta Soluciona problemas de enrutamiento y receptores.

No se pueden encontrar los 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:

1. Navega a la lista de instancias de VM de tu proyecto de Google Cloud:

   Ir a Instancias de VM

2. Selecciona la instancia y, luego, Puerto en serie 1 (consola) en la sección Registros de la página.

Puedes configurar tus instancias para que la salida del puerto en serie se envíe a Cloud Logging. Para obtener más información, consulta Inhabilita y habilita el registro de salidas del puerto en serie.

Obtén el ID de organización o del proyecto de Cloud

Para obtener un ID de la organización o de un proyecto de Cloud desde cualquier lugar de Google Cloud Console, expande la lista de proyectos de Cloud desde el selector de proyectos y organizaciones de Cloud y busca el ID del proyecto de 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 Cloud correcto? Si no es así, selecciona el proyecto de Cloud correcto del selector de proyectos y organización de Cloud.

• ¿Tu proyecto de Cloud usa recursos que generan registros? ¿Hay actividad en esos recursos? Incluso si el proyecto de Cloud es nuevo, debe 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 usa el permiso correcto para ver los registros? Para obtener instrucciones sobre cómo ajustar el alcance de tu búsqueda, consulta Define mejor el permiso.

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 en 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 escribieron las entradas para ese recurso. Si Cloud Logging identifica más de 200 depósitos en los que se pueden escribir 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 registro que ves en los paneles de Resultados de la consulta y Campos de registro se ajustan según el intervalo de tiempo capturado por el cronograma del histograma. Puedes ajustar el cronograma del histograma mediante los controles de tiempo del histograma o el selector de intervalo de tiempo. El ajuste de estos controles de tiempo no modifica la expresión de consulta en el panel Query.

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

Para obtener información sobre cómo obtener asistencia, consulta la página de asistencia de Google Cloud's operations suite.