Visualiza registros con el explorador de registros

En este documento, se proporciona una descripción general del Explorador de registros de la consola de Google Cloud, que puedes usar para recuperar, ver y analizar las entradas de registro que se almacenan en buckets de registro. Visualizar y analizar entradas de registro individuales y una secuencia de entradas de registro puede ayudarte a solucionar problemas. También puedes leer los datos de registro con la API de Logging y Google Cloud CLI.

Para realizar operaciones de agregación 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 Log Analytics y, luego, ejecuta consultas desde la página Log Analytics 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 de Log Analytics.

En el resto de este documento, se describe cómo usar el Explorador de registros.

Antes de comenzar

Para obtener los permisos que necesitas para usar el Explorador de registros y ver las entradas de registro, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Para ver las entradas de registro en el bucket _Required y las de la vista _Default en el bucket _Default, o para seleccionar un alcance de registro, usa el Visualizador de registros (roles/logging.viewer) en tu proyecto, carpeta o organización.
• Para ver todas las entradas de registro en los buckets _Required y _Default, usa el Visualizador de registros privados (roles/logging.privateLogViewer) en tu proyecto, carpeta o organización.
• Para ver los campos LogEntry restringidos en un bucket de registros, usa el Acceso a campos de registros (roles/logging.fieldAccessor) en el proyecto, la carpeta o la organización que almacena el bucket de registros. Para obtener información sobre cómo restringir el acceso a los campos LogEntry, consulta Configura el acceso a nivel de campo.
• Para ver y descargar entradas de registro almacenadas en una vista de registro en un bucket de registros, usa el Acceso a la vista de registros (roles/logging.viewAccessor) en el proyecto, la carpeta o la organización que contiene el bucket de registros. Para obtener información sobre cómo obtener acceso solo a una vista de registro específica, consulta Controla el acceso a una vista de registro.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Comenzar

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

1. En la consola de Google Cloud, ve a la página Explorador de registros.

   Ir al Explorador de registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. Selecciona un proyecto, una carpeta o una organización de Google Cloud.

   Las entradas de registro que muestra la página Explorador de registros dependen de lo siguiente:

   • Los recursos en los que se buscaron entradas de registro
   • La configuración del intervalo de tiempo
   • Tus roles de Identity and Access Management (IAM) en los recursos que se buscaron
   • Tu consulta filtra los resultados de la búsqueda. Por ejemplo, si agregas la consulta severity>=ERROR, se mostrará una lista que solo incluirá las entradas de registro con un nivel de gravedad de al menos ERROR.

   De forma predeterminada, la página Explorador de registros busca entradas de registro en los recursos que se enumeran en el ámbito de registros predeterminado. Si no se puede acceder a ese permiso, la página busca las entradas de registro que se originan en el proyecto, la carpeta o la organización que seleccionaste. Cuando se selecciona un proyecto, los resultados de la búsqueda incluyen las entradas de registro que un receptor en otro proyecto enruta al proyecto y, luego, se almacenan en un bucket de registros.

   Después de que se abra la página Explorador de registros, puedes seleccionar en qué recursos se buscan entradas de registro. Los cambios que realices con el menú Definir mejor el alcance solo se aplicarán a la sesión actual.

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:

1. Barra de herramientas principal
2. Panel Query
3. Panel Campos de registro
4. Cronograma
5. Barra de herramientas Resultados de la consulta
6. Panel Resultados de la consulta

Barra de herramientas principal

Con la barra de herramientas principal, puedes hacer lo siguiente:

• Biblioteca de consultas: Consulta las consultas guardadas, recientes y sugeridas. Para obtener más información, consulta Guarda y comparte consultas.
• Compartir vínculo: Crea una URL abreviada de la consulta y cópiala en el portapapeles, lo que facilita 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.
• Preferencias: Ajusta la vista de la página del Explorador de registros y personaliza el formato de los resultados de tus consultas. Para obtener más información, consulta Cómo establecer preferencias para ver los datos de registro.
• 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 Cómo usar el selector de período.
• Transmitir registros: Visualiza las entradas de registro a medida que Logging las almacena en buckets de registro. Para obtener más información, consulta Transmite registros.
• Aprende: Consulta vínculos a temas y documentación relevantes.

Nota: Si tus 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 información, consulta Restricciones y limitaciones de Assured Workloads.

Consulta las consultas recientes, guardadas y sugeridas

Para ver las consultas que ejecutaste recientemente, las que guardaste para usarlas en el futuro y las sugerencias, haz clic en el botón Biblioteca de consultas.

En la pestaña Biblioteca de consultas, puedes ver lo siguiente:

• Consultas recientes: Consulta las consultas que ejecutaste recientemente. Para obtener más información, consulta Cómo usar consultas recientes.

• Consultas guardadas: Consulta tus consultas guardadas y las consultas que otros usuarios del proyecto de Google Cloud han compartido contigo. Para obtener más información, consulta Guarda y comparte consultas.

• Consultas sugeridas: Consulta las consultas sugeridas en función de los recursos de tu proyecto de Google Cloud. Para obtener más información, consulta Cómo usar las consultas sugeridas.

• Consultas proporcionadas por Google Cloud: Consulta las consultas que proporciona Google Cloud basadas en casos de uso comunes para varios servicios de Google Cloud. Para obtener más información, consulta Cómo seleccionar consultas de la biblioteca.

Establece preferencias para ver los datos de registro

Para personalizar la forma en que se presentan los datos de tus registros en los resultados de la búsqueda, haz clic en el botón Preferencias y selecciona Ver, Formato o Administrar campos de resumen:

• Para ocultar o mostrar los paneles Cronología y Campos de registro, ocultar los chips de resumen en los resultados de la consulta o cambiar el orden de clasificación de los registros, selecciona Ver.

• Para configurar la columna Hora de los resultados de tu consulta, selecciona Formato. Para obtener más información, consulta Configura la columna Hora.

• Para mostrar hasta 10 líneas para cada entrada de registro, selecciona Formato y haz clic en Unir líneas. De forma predeterminada, el contenido de cada entrada de registro se trunca para que quepa en una línea. Los espacios en blanco se conservan en cada entrada de registro.

• Para encontrar patrones en tus registros con campos de resumen, selecciona Administrar campos de resumen. Para obtener más información, consulta Cómo encontrar patrones en tus registros con campos de resumen.

Configura la columna Hora

La columna Hora del panel Resultados de la consulta muestra las marcas de tiempo de tus entradas de registro. Puedes personalizar la columna Hora para que solo se vean ciertas partes de la marca de tiempo. 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 se mostrarán, haz clic en el menú Preferences, selecciona Format y, luego, elige una de las siguientes opciones:

• Fecha, hora y zona horaria

• Fecha y hora (predeterminada)

• Solo hora

Usa campos de resumen para encontrar patrones en tus registros

Supongamos que estás revisando las entradas de registro en los resultados de tu consulta y deseas revisar rápidamente los resultados por un campo LogEntry determinado. O tal vez desees agrupar tus entradas de registro por un par de valor de campo determinado. Puedes agregar campos de resumen a tus resultados, que aparecen como chips al comienzo de 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 tu consulta actual, y los campos de resumen personalizados te permiten seleccionar cualquier campo en LogEntry.

Para mostrar u ocultar todos los chips de campo de resumen en los resultados de la consulta, haz clic en el botón Preferences, selecciona View y, luego, Show summary chips. Cuando esta opción está habilitada, los resultados se muestran en formato de texto sin procesar.

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:

1. Haz clic en el botón Preferences y selecciona Manage summary fields.

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

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

     El campo de resumen admite la corrección de campos y el autocompletado 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, independientemente de 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 la truncación de tus campos de resumen personalizados.

     Para acortar la vista de los valores del campo de resumen, usa el botón de activación 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.

     Sugerencia: Para mostrar el valor completo de un campo de resumen, coloca el puntero sobre un campo de resumen truncado en los resultados de la consulta.

   • Oculta o muestra los campos de resumen predeterminados:

     Para personalizar los campos de resumen predeterminados que se muestran en los resultados de la consulta, expande el menú Ocultar o mostrar los campos de resumen predeterminados.

3. Haz clic en Aplicar.

   Los campos de resumen ahora se actualizan en los resultados de la consulta.

Cómo ver registros por período

Para especificar un intervalo de tiempo para las entradas de registro que deseas ver, usa el selector de intervalo de tiempo.

Para realizar una actualización forzada de los resultados de la consulta para incluir la hora actual, haz clic en keyboard_tab Jump to now.

Transmitir registros

Puedes transmitir registros a medida que Logging los almacena en buckets de registro, o bien puedes agregar una consulta para transmitir solo los registros que coincidan con ella.

Para transmitir registros basados en una consulta, agrega una consulta en el panel Consulta y, luego, selecciona el botón Transmitir registros en la barra de herramientas principal. A medida que Logging almacena los datos de los registros en buckets de registros, solo se muestran en el panel Resultados de la consulta los registros que coinciden con la consulta. Cuando no se proporciona una consulta, Logging muestra cada entrada de registro a medida que se almacena.

Para detener la transmisión, haz clic en Detener transmisión o desplázate manualmente para pausarla.

Panel Consulta

Para crear una consulta en el Explorador de registros, usa el panel de consulta. En el panel de consulta, puedes compilar y definir mejor las consultas con las siguientes funciones:

• Buscar en todos los campos: Encuentra entradas de registro que coincidan con tus términos o frases de búsqueda. Los términos de búsqueda que se agregan al campo Buscar en todos los campos se agregan al campo del Editor de consultas y se evalúan como parte de la expresión de consulta. Para obtener más información, consulta Cómo buscar texto en todos los campos de registro.

• Menús de filtro: Crea consultas con varios menús para seleccionar recursos, nombres de registros, niveles de gravedad y correlación con otros registros. Para obtener más información, consulta Cómo usar los menús de filtros.

• Campo del editor de consultas: Compila consultas avanzadas con el lenguaje de consulta de Logging. Si no ves el campo del editor de consultas, habilita Mostrar consulta. Para obtener más información, consulta Cómo escribir consultas avanzadas con el lenguaje de consulta de Logging.

  Nota: Cuando una consulta contiene varias sentencias, puedes especificar cómo se unen o puedes confiar en que Cloud Logging agregue de forma implícita la restricción conjuntiva, AND, entre las sentencias. Por ejemplo, supongamos que un diálogo de consulta o filtro contiene dos instrucciones, resource.type = "gce_instance" y severity >= "ERROR". La consulta real es resource.type = "gce_instance" AND severity >= "ERROR". Cloud Logging admite restricciones disyuntivas, OR, y restricciones conyugadas, AND. Cuando uses sentencias OR, te recomendamos que agrupes las cláusulas con paréntesis. Para obtener más información, consulta la documentación del lenguaje de consulta de Logging.

Después de revisar la consulta, haz clic en Ejecutar consulta. Los registros que coincidan con la consulta se enumerarán en el panel Resultados de la consulta. Los paneles Cronograma y Campos de registro también se ajustan según la expresión de consulta.

Recursos seleccionados en los que se buscaron entradas de registro

Cuando abres la página Explorador de registros, se recuperan las entradas de registro que se originan en el recurso que seleccionaste y que tienes permiso para ver. En el caso de los proyectos de Google Cloud, las entradas de registro recuperadas también incluyen aquellas que un sink en otro proyecto enruta al proyecto. Si ingresas una consulta, el Explorador de registros solo mostrará las entradas de registro recuperadas que también coincidan con la consulta. Por ejemplo, si agregas la consulta severity>=ERROR, se mostrará una lista que solo incluirá las entradas de registro con un nivel de gravedad de al menos ERROR.

Nota: Para configurar qué recursos se buscan cuando se abre la página Explorador de registros, establece el ámbito de registro predeterminado. Para obtener más información, consulta Crea y administra ámbitos de registros.

En tu sesión actual, puedes configurar en qué recursos el Explorador de registros busca entradas de registro con el menú Definir mejor el ámbito. Por ejemplo, cuando soluciones un problema, es posible que desees examinar solo las entradas de registro que se incluyen en una vista de registro o que se originan en un proyecto específico de Google Cloud.

El menú Definir mejor el permiso te permite realizar búsquedas por el proyecto actual, por la vista de registro o por el permiso de registro:

• Para buscar por el proyecto, la carpeta o la organización que se seleccionó con el selector de proyectos, expande el menú Definir mejor el permiso y selecciona Proyecto actual.

  Para todos los recursos, los resultados de la búsqueda incluyen las entradas de registro que se originan en el recurso. En el caso de los proyectos de Google Cloud, los resultados de la búsqueda también incluyen las entradas de registro que un sink en otro proyecto enruta al proyecto.

• Para buscar vistas de registro, expande el menú Definir mejor el alcance, selecciona Vista de registro y, luego, selecciona una o más vistas de registro del menú.

  Nota: Usa este parámetro de configuración cuando quieras ver las entradas de registro enrutadas por un sumidero agregado.

  Cuando se selecciona un proyecto con el selector de proyectos, el menú muestra las vistas de registro en los buckets de registro que almacena el proyecto seleccionado. Sin embargo, cuando se selecciona una carpeta o una organización, el menú muestra todas las vistas de registro que almacenan entradas de registro que se originaron en esos recursos.

  Para modificar el menú de vista de registro para incluir vistas de registro en buckets de registro almacenados en un proyecto, haz clic en  Import project y, luego, selecciona el proyecto.

• Para buscar los recursos incluidos en un ámbito de registro, que puede incluir proyectos y vistas de registro, expande el menú Definir mejor el permiso, selecciona Ámbito de registro y, luego, selecciona un ámbito de registro.

  Si deseas configurar tus permisos de registro, haz clic en Administrar permisos. Para obtener más información, consulta Crea y administra ámbitos de registros.

  Los alcances de registro están en versión preliminar pública.

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. El panel muestra las entradas de registro desglosadas por dimensiones diferentes, que corresponden a los campos en 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 admitida. Para cada dimensión, puedes hacer una selecció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 deseas 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 los filtraste por tipo de recurso, se propagará el menú Service. Las entradas de este menú se determinan de forma dinámica según 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 incluye 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 propaga el menú Servicio. Las entradas de este menú se determinan de forma dinámica según los valores de la etiqueta service del recurso.

Otras dimensiones, como ID del proyecto, se muestran según tus selecciones. Por ejemplo, la dimensión ID del proyecto aparece en la lista cuando tu consulta restringe las entradas de registro a aquellas cuyo tipo de recurso es Contenedor de Kubernetes o cuando seleccionaste una vista de registro.

Defina mejor su 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 actualizará para incluir severity=ERROR.

Para quitar una selección, haz clic en el botón Borrar.

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 Campos de registro, haz lo siguiente:

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

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

Cronograma

Nota: Cada elemento de la línea de tiempo muestra la cantidad aproximada de entradas de registro que se recibieron en el intervalo de tiempo asociado con el elemento. Para obtener un recuento exacto de la cantidad de entradas de registro recibidas en un intervalo de tiempo, usa Log Analytics o copia los registros en un bucket de Cloud Storage.

Con el panel Cronograma, puedes visualizar la distribución de los registros a lo largo del tiempo. El cronograma 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 Rutas, haz clic en keyboard_capslock Contraer Rutas.

Funciones de Línea de tiempo

1. Barras de cronograma: Cada barra de cronograma 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 de la Línea de tiempo 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. Si deseas obtener detalles sobre estas opciones, consulta Analiza registros con controles de tiempo.

3. Intervalo de tiempo: Te muestra el intervalo de tiempo de los registros, representados por barras del histograma. 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 en la línea de tiempo para investigar y analizar los datos de tus registros.

Sugerencia: Cuando ajustas los controles de tiempo del cronograma, los datos de registros en los paneles Resultados de la consulta y Campos de registro se ajustan según el intervalo de tiempo que captura el cronograma. Ajustar los controles de tiempo de la línea de tiempo no altera la expresión de consulta en el panel Consulta.

Cómo ajustar los controles de tiempo

El cronograma proporciona controles de tiempo que te permiten ajustar los datos que ves en el Explorador de registros:

• Controladores de tiempo: Arrastra los controladores del cronograma hacia adentro para limitar los datos o hacia afuera para ampliar los datos en el cronograma. Haz 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 Alejar para ampliar los datos que se muestran en el cronograma. Haz clic en Acercar para reducir los datos que se muestran en el cronograma.

• Ocultar cronograma: Haz clic en keyboard_capslock Contraer cronograma para ocultarlo.

Las modificaciones del cronograma deben estar entre la hora actual (“ahora”) y hasta 30 días en el pasado.

Desplázate o ve registros del período

Además de los controles de tiempo mencionados anteriormente, el cronograma 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 cronograma y los datos que ves en otros paneles en el Explorador de registros. Quizás una barra en particular de la línea de tiempo te interese según su tamaño relativo o sus niveles de gravedad. Puedes seleccionar esa barra para ajustar los datos de los registros que ves en el Explorador de registros.

Puedes usar la función Desplazarse por registros para explorar los datos de tus registros sin cambiar los valores en los paneles Línea de tiempo 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 cronograma 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 cronograma 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 cronograma seleccionada.

Para seleccionar la función Desplazarse por registros, haz lo siguiente:

1. Mantén el puntero sobre una barra en el cronograma. 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 línea de tiempo 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 cronograma 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 cargar y se reducen según la restricción de intervalo de tiempo de la barra de cronograma 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 cronograma seleccionada.
• La línea de tiempo cambia para mostrar solo los registros que tienen un valor timestamp que se encuentra dentro del intervalo de tiempo de la barra de línea de tiempo seleccionada.
• Los datos del panel Campos de registro se ajustan según el intervalo de tiempo que captura la barra de cronograma seleccionada.

Para seleccionar la función Ver registros del período, haz lo siguiente:

1. Mantén el puntero sobre una barra en el cronograma. 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.

Barra de herramientas Resultados de la consulta

En la barra de herramientas Resultados de la consulta, tienes las siguientes opciones:

• Analizar resultados: Agrupa y crea gráficos con los resultados de tus consultas con Análisis de registros. Este botón solo se muestra si el alcance 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 Cómo analizar los resultados de este documento.

• Acciones: Selecciona entre varias opciones para analizar con mayor detalle los datos de tus registros:

  • ink_highlighter Destacar en los resultados: Ingresa el texto que se destacará en los resultados de la búsqueda.
  • Crear métrica: Configura una métrica basada en registros.
  • Create sink: Crea un receptor de registros que propague automáticamente el filtro de inclusión del receptor con la expresión de consulta actual.
  • Crear alerta de registro: Configura una política de alertas basada en registros.
  • Administrar alertas: Consulta y administra las políticas de alertas.
  • Descargar: Descarga tus registros en formato CSV o JSON. Para obtener más información, consulta Descarga registros.

Analizar resultados

Puedes agregar, analizar y graficar tus datos de registro con consultas 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 de Log Analytics desde el Explorador de registros, en la barra de herramientas Resultados, haz clic en Analizar resultados.

El botón Analizar resultados solo es visible cuando el alcance que seleccionaste contiene un bucket de registros que se actualizó para usar el Análisis de registros. Por ejemplo, si seleccionaste Vista de registro mediante el menú Definir mejor el alcance, se mostrará el botón Analizar resultados cuando se actualice al menos un bucket dentro del almacenamiento alcance para usar el Análisis de registros. Para obtener más información, consulta Actualiza un bucket de registros para usar el análisis de registros.

Cuando haces clic en Analizar resultados, ocurre lo siguiente:

• Es posible que el intervalo de tiempo del Explorador de registros se ajuste automáticamente para que haya datos de registro significativos en la página Log Analytics.

• La página Log Analytics se abre en una pestaña nueva y traduce automáticamente la consulta actual del lenguaje de consulta de registros a una consulta en SQL.

• El recurso que selecciona el selector de proyectos de Google Cloud y el valor de la configuración de Refinar el alcance determinan cómo se construye la cláusula FROM en la consulta en SQL. El recurso seleccionado puede ser un proyecto, una carpeta o una organización:

  • Cuando el menú Refine scope muestra Project, se consultan los buckets _Required y _Default del recurso.

  • Cuando el menú Refina el alcance muestra Vista, se consultan las vistas de registro en los buckets de registro del proyecto actual. Se ignoran las vistas de registro en los buckets de registro que almacenan diferentes recursos.

  • Cuando el parámetro de configuración Definir mejor el permiso enumera el nombre de un permiso de registro, las reglas anteriores se aplican a los recursos enumerados en el permiso de registro seleccionado. Por ejemplo, si el ámbito de registro contiene vistas de registro, solo se consultan aquellas vistas de registro en los buckets de registro que almacena el recurso. Los permisos de registro están en versión preliminar pública.

  Nota: Log Analytics no admite consultas entre proyectos o regiones. Cuando la configuración de Definir mejor el permiso incluye entradas de registro que se almacenan en varios proyectos o regiones, es posible que Log Analytics muestre entradas de registro diferentes a las de la página Explorador de registros.

En la página de Log Analytics, puedes ver tus resultados en formato tabular o como un gráfico. En la pestaña Gráfico, puedes seleccionar los datos que se grafican, personalizar la configuración del gráfico 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 tus consultas y guardarlos en un panel personalizado, consulta Cómo graficar los resultados de las consultas con Log Analytics.

Para obtener información sobre cómo usar SQL para escribir consultas, consulta Cómo consultar y ver registros en el Análisis de registros.

Busca en los resultados de tu consulta

Para buscar el contenido de los Resultados de la consulta, haz clic en Destacar en los resultados en el panel Resultados de la consulta y, luego, ingresa tu 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 del panel Resultados de la búsqueda:

Descargar registros

Nota: Esta función no admite la descarga masiva de entradas de registro. Puedes descargar hasta 10,000 entradas de registro, siempre que el tiempo para consultar los registros y realizar la descarga se pueda completar dentro del tiempo de espera del comando. Puedes copiar registros de forma masiva en un bucket de Cloud Storage.

Para obtener los permisos que necesitas para descargar registros, pídele a tu administrador que te otorgue el rol de IAM Accesor de vista de registros (roles/logging.viewAccessor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol incluye el permiso logging.logEntries.download. También puedes otorgar un rol que contenga el permiso logging.logEntries.list, que le permite a un miembro principal ver y descargar registros.

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para descargar tus registros, haz lo siguiente:

1. En el menú Acciones del panel Resultados de la consulta, haz clic en Descargar.

2. En el cuadro de diálogo Descargar registros, selecciona el formato CSV o JSON y, luego, haz clic en Descargar.

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

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

Para obtener información sobre la solución de problemas, consulta La descarga de registros falla.

Panel Resultados de la consulta

Para ver los resultados de tus consultas, usa el panel Resultados de la consulta. Para ayudarte a solucionar problemas en tus aplicaciones, puedes ver los detalles de las entradas de registro individuales, así como agruparlas y analizarlas para encontrar patrones en tus registros.

Cómo 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, en una entrada de registro, haz clic en Expandir.

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 de la consulta:

   --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, en una entrada de registro, haz clic en Expandir.

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

   Se abrirá un diálogo independiente con la siguiente información:

   • El patrón que se encontró
   • Es 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 las entradas de registro:

   

Oculta entradas de registro similares

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

Existen dos maneras de ocultar entradas de registro similares:

• Ocultar grandes cantidades de entradas de registro agrupadas automáticamente Cuando ejecutas una consulta, se analizan los resultados de la consulta en busca de patrones y, luego, las entradas de registro se agrupan automáticamente en función del contenido similar de los campos 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 se pueden ocultar.

  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 abre una ventana independiente 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. Cada consulta produce un análisis nuevo, basado únicamente en los registros que se muestran. Las diferentes consultas analizan diferentes partes de las entradas de registro según los tipos de registros que se muestran.

• Oculta las entradas de registro similares a una entrada de registro específica.

  Para ocultar entradas de registro similares a una entrada de registro, haz clic en Expandir, en el menú Entradas similares y, luego, selecciona Ocultar entradas similares.

  La consulta se actualiza 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.

Cómo ver o ocultar entradas de registro que coincidan con un campo

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

Para ver o ocultar entradas de registro que coincidan con un campo específico, haz lo siguiente:

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

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

3. En el menú, selecciona Mostrar entradas coincidentes o Ocultar entradas coincidentes.

   La consulta se actualiza con una que muestra o 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 no se incluye la entrada de registro fijada, se te solicitará que la desfijes.

Para fijar una entrada de registro, haz lo siguiente:

1. Mantén el puntero sobre la entrada de registro que quieres fijar.
2. Haz clic en Fijar.

Después de fijar una entrada de registro, se oscurece el fondo y se muestra un ícono de fijar . También aparece un ícono de fijar en el panel Cronograma según la timestamp de la entrada de registro fijada.

Para dejar de fijar una entrada de registro, vuelve a hacer clic en el ícono de fijar.

Cómo mostrar registros que coincidan con el recurso de una entrada de registro fijada

Después de fijar una entrada de registro, puedes ejecutar una nueva consulta que muestre entradas de registro que coincidan con el tipo de recurso o las etiquetas de recursos 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:

1. Haz clic en Flecha hacia abajo junto al registro fijado para expandir el menú de fijación.

2. Selecciona una opción del menú de fijació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 de k8s_node. Si seleccionas Same resource.type, la consulta se volverá 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 Mismo 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 la Cronología

Puedes usar la Línea de tiempo para destacar, desplazarte y examinar más una entrada de registro fijada.

En el Cronograma, haz clic en Fijar y, luego, elige una de las siguientes opciones del menú:

• Desplázate hasta la entrada de registro: Lleva la entrada de registro al panel Resultados de la consulta actual y ve la entrada de registro fijada en el contexto de los registros cercanos.
• Hacer zoom a la entrada de registro: Reduce el intervalo de tiempo que se muestra en el panel Cronograma y define mejor tu consulta para aislar los registros cerca del registro fijado.
• Dejar de fijar: Dejar de fijar una entrada de registro.

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 Busca y explora seguimientos.

Nota: El botón Ver detalles de seguimiento solo está disponible cuando 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 seleccionar 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. Puedes copiar un registro en JSON o un vínculo al registro. 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.

Consultas de ejemplo

Para ver las consultas sugeridas, organizadas por producto y caso de uso de Google Cloud, consulta Consultas de muestra con el Explorador de registros. Por ejemplo, puedes ejecutar consultas relacionadas con Kubernetes para encontrar los registros de Google Kubernetes Engine.

Cómo ver los registros de Compute Engine

En el caso de 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 texto secundario en varios lugares del Explorador de registros. Por ejemplo, en el tipo de recurso gce_instance, verás 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 compilar consultas.

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

• Menús de filtro del panel de Query: Los tipos de recursos de Compute Engine muestran los nombres de los recursos, con sus IDs correspondientes como texto secundario.
• Campos de registro: Los tipos de recursos de Compute Engine muestran el nombre del recurso, en lugar del ID del recurso, en las dimensiones del campo.
• Resultados de la consulta: En el caso de los registros de instancias de VM de Compute Engine, el campo resource.labels muestra metadatos con el nombre de recurso correspondiente.
• Campos de resumen: En el caso de 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 registros en los destinos de receptores, consulta Cómo solucionar problemas de enrutamiento y receptores.

La descarga de registros falla

Estás usando el Explorador de registros y haces clic en Descargar. El comando se inicia, pero no se completa o informa un error.

Para resolver este problema, reduce el tiempo que tarda en ejecutarse el comando. Para ello, prueba lo siguiente:

• En el diálogo Download logs, reduce el valor de Maximum log entries.
• Reduce el período durante el cual se consultan los registros.
• En la barra de herramientas de resultados de la consulta, haz clic en Ocultar entradas similares antes de comenzar la descarga.

• Modifica tu consulta para usar campos indexados.

Nota: La función de descarga no está diseñada para descargar registros de forma masiva. Puedes copiar registros en un bucket de Cloud Storage.

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. En la consola de Google Cloud, ve a la página Instancias de VM.

   Ir a Instancias de VM

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Compute Engine.

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

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

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

Para obtener un ID de organización o del proyecto de Google Cloud desde cualquier parte de la console de Google Cloud, expande la lista de proyectos de Google Cloud del 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:

• Verifica que esté seleccionado el proyecto de Google Cloud correcto.

• Verifica que tu proyecto de Google Cloud use recursos que generen registros y que haya actividad en esos recursos. Incluso si el proyecto de Google Cloud es nuevo, debe tener registros de auditoría que registren su creación. Para obtener información sobre cómo verificar que estás usando un recurso que genera registros, consulta Asigna servicios a tipos de recursos.

• Asegúrate de que el intervalo de tiempo no sea demasiado reducido.

• Visualiza tus consultas de exclusión actuales para asegurarte de que los registros que buscas no se excluyan de forma accidental.

• Asegúrate de tener permiso para ver las entradas de registro en los proyectos y las vistas de registro a las que se hace referencia en la configuración del menú Define mejor el permiso. Para obtener información 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 emites una consulta sobre un recurso sin especificar un bucket, Cloud Logging usa el historial de los receptores del proyecto de Google Cloud para determinar en qué lugar se escribieron las entradas para ese recurso. Si Cloud Logging identifica más de 200 buckets en los que se escribieron entradas, la consulta fallará y mostrará 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 que captura el cronograma del histograma. Para ajustar el cronograma del histograma, usa los controles de tiempo del histograma o el selector de intervalo de tiempo. Ajustar estos controles de tiempo no altera la expresión de consulta en el panel Consulta.

Cuando tienes una consulta con una marca de tiempo, el selector de intervalo de tiempo se inhabilita. 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 Observability.