Visualiza registros con el explorador de registros

En este documento, se proporciona una descripción general del Explorador de registros en la consola deCloud de Confiance , que puedes usar para recuperar, ver y analizar las 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 los datos de registro con la API de Logging y Google Cloud CLI.

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, haz lo siguiente: Visualizador de registros (roles/logging.viewer) en tu proyecto, carpeta u organización.
• Para ver todas las entradas de registro en los buckets _Required y _Default, haz lo siguiente: Visualizador de registros privados (roles/logging.privateLogViewer) en tu proyecto, carpeta u organización.
• Para ver y descargar las entradas de registro almacenadas en una vista de registros en un bucket de registros, haz lo siguiente: Acceso a la vista de registros (roles/logging.viewAccessor) en el proyecto, la carpeta o la organización que contiene el bucket de registros. Si deseas obtener información para acceder solo a una vista de registros específica, consulta Controla el acceso a una vista de registros.

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 a través de roles personalizados o cualquier otro rol predefinido.

Comenzar

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

1. En la consola de Cloud de Confiance , accede a la página Explorador de registros:

   Acceder 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 Cloud de Confiance proyecto, una carpeta o una organización. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

   Las entradas de registro que se muestran en la página Explorador de registros dependen de lo siguiente:

   • Son los recursos en los que se buscaron entradas de registro.
   • Es el parámetro de configuración del intervalo de tiempo.
   • Tus roles de Identity and Access Management (IAM) en los recursos buscados
   • Tu búsqueda filtra los resultados. Por ejemplo, si agregas la consulta severity>=ERROR, en la lista de visualización solo se mostrarán 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 indican en el ámbito de registros predeterminado. Cuando no se puede acceder al permiso de registro predeterminado, la página busca las entradas de registro que se originan en el proyecto, la carpeta o la organización que seleccionaste. En el caso de los proyectos, 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 qué recursos buscará el Explorador de registros para encontrar entradas de registro. Sin embargo, tu selección solo se aplica a tu 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
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:

• menu_book Biblioteca de consultas: Consulta las consultas guardadas, recientes y sugeridas. Si deseas obtener más información, consulta Guarda y comparte consultas.
• link Compartir vínculo: Crea una URL abreviada de la búsqueda y cópiala en el portapapeles, lo que facilita compartir una búsqueda. La URL copiada tiene el intervalo de tiempo absoluto correspondiente representado por el intervalo de tiempo de tu búsqueda, por ejemplo, 7:49:37 PM - 8:49:37 PM.
• settings Preferencias: Ajusta la vista de la página del Explorador de registros y personaliza el formato de los resultados de tu consulta. 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íodos.
• school Aprende: Consulta vínculos a documentación y temas relevantes.

Cómo ver las consultas recientes, guardadas y sugeridas

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

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

• Consultas recientes: Consulta las búsquedas que realizaste recientemente. Para obtener más información, consulta Cómo usar las búsquedas recientes.

• Consultas guardadas: Consulta tus consultas guardadas y las consultas que otros usuarios del proyecto Cloud de Confiance han compartido contigo. Para obtener más información, consulta Cómo guardar y compartir consultas.

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

• Consultas proporcionadas por Cloud de Confiance by S3NS: Consulta las consultas proporcionadas por Cloud de Confiance by S3NSen función de los casos de uso comunes para varios servicios de Cloud de Confiance . Para obtener más información, consulta Cómo seleccionar consultas de la biblioteca.

Cómo establecer preferencias para ver los datos de registro

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

• Para mostrar u ocultar los paneles Línea de tiempo y Campos, 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 Tiempo de los resultados de la consulta, selecciona Formato. Para obtener más información, consulta Cómo configurar la columna Tiempo.

• Para mostrar hasta 10 líneas por entrada de registro, selecciona Formato y haz clic en Ajustar 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 los 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 Tiempo

En la columna Hora del panel Resultados de la consulta, se muestran las marcas de tiempo de las 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ú settings Preferencias, selecciona Formato y, luego, elige una de las siguientes opciones:

• Fecha, hora y zona horaria

• Fecha y hora (predeterminada)

• Solo hora

Cómo encontrar patrones en tus registros con los campos de resumen

Supongamos que estás revisando las entradas de registro en los resultados de tu consulta y quieres echar un vistazo rápido a los resultados por un determinado campo LogEntry. O tal vez quieras agrupar tus entradas de registro por un determinado par clave-valor. 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 búsqueda actual, y los campos de resumen personalizados te permiten seleccionar cualquier campo en LogEntry.

Para mostrar u ocultar todos los chips de campos de resumen en los resultados de la búsqueda, haz clic en el botón Preferencias settings, selecciona Ver y, luego, Mostrar chips de resumen. Cuando esta opción está habilitada, los resultados se muestran en formato de texto sin formato.

Para ocultar campos de resumen específicos, habilita Campos de resumen y, luego, haz clic en Ocultar el campo de resumen. Para modificar los campos de resumen, haz lo siguiente:

1. Haz clic en el botón settings Preferencias y selecciona Administrar campos de resumen.

2. En el cuadro de 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 el autocompletado y la 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, independientemente de si se te sugiere con la función de autocompletar.

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

   • Activa y desactiva el truncamiento para tus campos de resumen personalizados.

     Para acortar la vista 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.

   • Para ocultar o mostrar los campos de resumen predeterminados, haz lo siguiente:

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

3. Haz clic en Aplicar.

   Tus campos de resumen ahora se actualizaron en los resultados de la búsqueda.

Visualiza los 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 búsqueda y que se incluya la hora actual, haz clic en keyboard_tab Pasar a los más recientes.

Panel Consulta

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

• Selecciona los recursos en los que se buscarán entradas de registro. Las consultas que escribes filtran las entradas de registro que muestra la búsqueda.

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

• Menús de filtros: 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 Escribe consultas avanzadas con el lenguaje de consultas de Logging.

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

Selecciona los recursos en los que se buscan entradas de registro

En esta sección, se describe cómo ver o cambiar los recursos en los que se buscan entradas de registro. 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, en la lista de visualización solo se mostrarán las entradas de registro con un nivel de gravedad de, al menos, ERROR.

Para determinar qué entradas de registro mostrar, la página Explorador de registros busca en los recursos que se indican en el ámbito de registros predeterminado. Cuando no se puede acceder al permiso de registro predeterminado, la página busca las entradas de registro que se originan en el proyecto, la carpeta o la organización que seleccionaste. Cuando se buscan proyectos, 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.

En tu sesión actual, puedes configurar qué recursos busca el Explorador de registros para encontrar entradas de registro. Por ejemplo, cuando solucionas problemas, es posible que solo quieras examinar las entradas de registro que se incluyen en una vista de registro o que se originan en unCloud de Confiance proyecto específico.

En la barra de herramientas del panel Consulta, se muestran las entradas de registro de los recursos buscados:

• Registros del proyecto y _Predeterminado: Se devuelven las entradas de registro que se originan en el proyecto, la carpeta o la organización seleccionados. En el caso de los proyectos, estas entradas de registro incluyen las que se enrutan al proyecto a través de un receptor en otro proyecto.

• N log view: Se devuelven las entradas de registro incluidas en las vistas de registro N. Puedes expandir el menú para enumerar las vistas de registro.

• my-custom-scope, donde "my-custom-scope" es el nombre de un alcance de registro personalizado: Si un alcance de registro enumera vistas de registro, se devuelven las entradas de registro en esas vistas de registro. Si un permiso de registro enumera otros recursos, como proyectos, se devuelven las entradas de registro que se originan en esos recursos. Para obtener más información, consulta Crea y administra ámbitos de registros.

Cuando quieras cambiar los recursos en los que se buscan entradas de registro, haz lo siguiente:

1. Ve a la barra de herramientas del panel Consulta. En esta barra de herramientas, se muestra un menú etiquetado de una de las siguientes maneras:

   • Registros del proyecto
   • N vistas de registro
   • my-custom-scope

   Selecciona el menú.

2. En el menú desplegable Define mejor el permiso, selecciona la ubicación de almacenamiento y, luego, completa el diálogo.

   La siguiente información puede ayudarte a completar el diálogo:

   • Cuando quieras ver las entradas de registro que enrutó un receptor agregado, selecciona Vista de registros como la ubicación de almacenamiento. Asegúrate de seleccionar todas las vistas de registros que almacenan las entradas de registro que deseas ver.

   • En el caso de las carpetas y las organizaciones, el menú de vistas de registros enumera todas las vistas de registros que almacenan entradas de registro que se originaron en esos recursos.

   • En el caso de los proyectos, el menú de vistas de registros enumera las vistas de registros en los buckets de registros almacenados por el proyecto seleccionado.

   • Para modificar el menú de vistas de registros y que incluya vistas de registros en buckets de registros almacenados en un proyecto específico, haz clic en add_circle Importar proyecto y, luego, selecciona el proyecto.

Panel Fields

El panel Campos ofrece un resumen de alto nivel de los datos de registros y proporciona una forma eficiente de definir mejor una consulta. Las entradas de este panel también enumeran la cantidad aproximada de entradas de registro que coinciden con el filtro correspondiente.

Después de ejecutar una consulta en el campo del editor de consultas, el panel Campos se completa en función de los resultados de la consulta. El panel se divide en las siguientes secciones:

• Fijados: Muestra los campos que fijaste para acceder a ellos rápidamente. Si no se muestra esta sección, significa que no fijaste ningún campo.

• Metadatos del sistema: Muestra las entradas de registro desglosadas por diferentes dimensiones, que corresponden a los campos en las entradas de registro.

• Carga útil de JSON (más frecuente): Muestra los campos json_payload más frecuentes en los resultados de la búsqueda actual.

En la sección Metadatos del sistema, 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.

Algunas dimensiones se completan de forma dinámica en función de las etiquetas de tus datos de registro. Por ejemplo, es posible que veas una dimensión de Servicio o Aplicación:

• La dimensión Servicio se muestra en las siguientes situaciones:

  • Tienes datos de registro cuyo tipo de recurso es Contenedor de Kubernetes y no filtraste tus registros por tipo de recurso. Los valores de la etiqueta labels.k8s-pod/app contribuyen a las entradas de la dimensión Servicio.

    Por ejemplo, si se muestra una entrada de registro similar a la siguiente como resultado de tu búsqueda, 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"
     }
     ...
    }
    

  • Tienes datos de registro con etiquetas para un servicio o una carga de trabajo de App Hub. Estas etiquetas tienen el formato apphub.workload.id o apphub.service.id. En la entrada de registro, se muestran en la entrada apphub. Por ejemplo, una entrada de registro puede contener algo como lo siguiente:

    apphub: {
     application: {3}
     workload: {
        criticalityType: "MEDIUM"
        environmentType: "STAGING"
        id: "my-workload-id"
     }
    }
    

  • Filtra tus datos de registro por el tipo de recurso de Recurso auditado. Los valores de la etiqueta resource.labels.service contribuyen a las entradas de la dimensión Servicio.

  • Tienes datos de registro que contienen la etiqueta resource.labels.namespace_name o labels.service.name.

• La dimensión Aplicación se muestra cuando tus datos de registro contienen una etiqueta de ID de aplicación de App Hub, que tiene el formato apphub.application.id. En la entrada de registro, esta etiqueta se muestra en la entrada apphub:

  apphub: {
    application: {
       container: "projects/my-project"
       id: "my-app"
       location: "my-app-location"
    }
    workload: {3}
  }
  

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

Defina mejor su consulta

Para definir mejor tu consulta, selecciona un valor en el panel Campos. Por ejemplo, si seleccionas Error en el encabezado Gravedad, el panel de consultas se actualizará para incluir severity=ERROR.

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

Agrega campos al panel Campos

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 sueles filtrar por el valor del campo jsonPayload.message, agrégalo al panel Campos.

Para agregar un campo al panel Campos, haz lo siguiente:

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

2. Selecciona el valor de un campo. En el menú, selecciona Fijar en el panel Campos.

   El campo personalizado aparece en el panel Campos como una lista de pares clave-valor.

Para quitar un campo personalizado del panel Campos, haz clic en Quitar junto al campo.

Ten en cuenta que los siguientes tipos de campos no se pueden agregar al panel Campos:

• 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

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

Funciones de línea de tiempo

1. Barras del cronograma: Cada barra del 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 las 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.

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

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

• Acercar y alejar: Haz clic en zoom_out Alejar para ampliar los datos que se muestran en el cronograma. Haz clic en zoom_in 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 que se mencionaron anteriormente, la línea de tiempo proporciona las funciones Desplazarse por registros y Ver registros del período para darte un control más detallado de la línea de tiempo 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 Cronograma y Campos. 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 la línea de tiempo seleccionada.

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

1. Mantén el puntero sobre una barra del 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 la 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 la línea de tiempo 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 la línea de tiempo 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 la línea de tiempo seleccionada.
• Los datos del panel Campos 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 del 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:

• Acciones: Selecciona entre varias opciones para analizar aún más los datos de tus registros:

  • ink_highlighter Highlight in results: Ingresa el texto que se destacará en los resultados de la búsqueda.
  • call_merge Crear receptor: Crea un receptor de registros que propaga automáticamente el filtro de inclusión del receptor con la expresión de consulta actual.
  • download Descargar: Descarga tus registros en formato CSV o JSON. Para obtener más información, consulta Descarga registros.

Cómo buscar en los resultados de tu búsqueda

Para buscar en el contenido de 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 consulta.

Descargar registros

Para obtener los permisos que necesitas para descargar registros, pídele a tu administrador que te otorgue el rol de IAM Logs View Accessor (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 contiene el permiso logging.logEntries.download. También puedes otorgar un rol que contenga el permiso logging.logEntries.list, que permite que un principal vea y descargue 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 Hojas de cálculo de Google.

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

Cómo ver los resultados de tu búsqueda

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, y agrupar y analizar las entradas de registro para encontrar patrones en tus registros.

Cómo resumir una entrada de registro con la ayuda de Gemini

Cuando investigues un problema, puedes usar Gemini para generar un resumen de la entrada de registro. Para generar un resumen de una entrada de registro, haz lo siguiente:

1. Después de ejecutar una consulta, en el panel Resultados de la consulta, selecciona la entrada de registro que deseas resumir.

2. En la barra de herramientas de la entrada de registro, haz clic en Explica esta entrada de registro.

   Cloud Logging envía el texto de la entrada de registro a Gemini Cloud Assist con una instrucción para resumir el contenido de la entrada de registro. Gemini Cloud Assist responde con un resumen generado en el panel de Gemini. El resumen se basa únicamente en el texto de la entrada de registro, sin ningún contexto adicional.

Para obtener más información sobre cómo resumir tus entradas de registro con Gemini Cloud Assist, consulta Resume entradas de registro con la asistencia de Gemini.

Soluciona un problema con la ayuda de Gemini

Para obtener ayuda para solucionar un problema, crea una investigación de Gemini Cloud Assist. Las investigaciones usan datos de registros y métricas para recopilar estadísticas sobre tus entornos complejos y distribuidos, y pueden ayudarte a comprender, diagnosticar y resolver problemas en tu infraestructura y aplicaciones de Cloud de Confiance by S3NS.

Para crear una investigación, haz lo siguiente:

1. Selecciona una entrada de registro que tenga un nivel de gravedad de al menos WARNING.
2. Ve a la barra de herramientas de la entrada de registro y haz clic en Investigar.

Puedes crear una investigación para determinar las causas probables de los problemas y aplicar las soluciones recomendadas por Gemini Cloud Assist para ayudarte a resolverlos. Para obtener más información sobre las investigaciones, consulta la siguiente documentación:

• Soluciona problemas con las investigaciones de Gemini Cloud Assist
• Crea una investigación de Gemini Cloud Assist
• Administra las investigaciones de Gemini Cloud Assist

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 chevron_right Expandir.

2. Haz clic en Entradas similares y selecciona Mostrar entradas similares.

   La consulta se actualiza con una similar a la siguiente y se vuelven a cargar los resultados:

   --Show similar entries
   protoPayload.methodName="io.k8s.core.v1.configmaps.update"
   --End of show similar entries
   

Para ver 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 chevron_right Expandir.

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

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

   • Es 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

Oculta las entradas de registro similares

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

Existen dos formas de ocultar entradas de registro similares:

• Oculta grandes cantidades de entradas de registro agrupadas automáticamente. Cuando ejecutas una consulta, se analizan los resultados para detectar patrones y, luego, las entradas de registro se agrupan automáticamente según el 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.

  Hide similar entries: 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 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. Cada búsqueda genera un análisis nuevo basado solo 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 las entradas de registro similares a una 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 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 u ocultar entradas de registro que coincidan con un campo

Puedes ver u 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 u ocultar las entradas de registro que coinciden con un campo específico en una entrada de registro, haz lo siguiente:

1. En el panel Resultados de la consulta, en la entrada de registro, haz clic en chevron_right 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 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 destacar una entrada de registro fijándola. La entrada de registro fijada permanece centrada en el panel Resultados de la consulta. Si ejecutas una nueva búsqueda 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 push_pin Fijar.

Después de fijar una entrada de registro, se oscurece el fondo y se muestra un ícono de Fijar push_pin. También aparece un ícono de fijar en el panel Cronograma según 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 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 las 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 las entradas de registro que coinciden con el mismo tipo de recurso o etiquetas de recursos, haz lo siguiente:

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

2. Realiza una selección en el menú de fijación:

   • Para volver a ejecutar la consulta con el mismo resource.type que el registro fijado, selecciona Mismo resource.type.

     Por ejemplo, supongamos que fijas una entrada de registro con un resource.type de k8s_node. Si seleccionas Mismo resource.type, se vuelve a ejecutar la consulta 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 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 push_pin 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 el panel Cronograma y define mejor tu consulta para aislar los registros cerca del registro fijado.
• Dejar de fijar: Deja de fijar una entrada de registro.

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 content_copy Copiar. Puedes copiar un registro en formato 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 Cloud de Confiance . 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 Cloud de Confiance producto y caso de uso, consulta Ejemplos de consultas 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

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 texto secundario 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 su ID. Los nombres de los recursos te ayudan a identificar el ID de recurso correcto, sobre el cual puedes compilar consultas.

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

• Menús de filtro del panel Query: Los tipos de recursos de Compute Engine muestran los nombres de los recursos, con sus IDs correspondientes como texto secundario.
• Campos: Los tipos de recursos de Compute Engine muestran el nombre del recurso, en lugar de su ID, 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 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 destinos de receptores, consulta Solución de problemas de enrutamiento y receptores.

Falla la descarga de registros

Estás usando el Explorador de registros y haces clic en download Descargar. El comando se inicia, pero luego 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 Descargar registros, reduce el valor de Entradas de registro máximas.
• Reduce el período durante el que 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.

No se encuentran 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 Cloud de Confiance , 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.

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

Para obtener un ID de Cloud de Confiance proyecto o de organización desde cualquier lugar de la consola deCloud de Confiance , expande la lista de proyectos de Cloud de Confiance desde el selector deCloud de Confiance proyectos y organizaciones, y busca el ID del proyecto deCloud de Confiance 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 Cloud de Confiance proyecto correcto.

• Verifica que tu proyecto Cloud de Confiance use recursos que generen registros y que haya actividad en esos recursos. Incluso si el proyecto Cloud de Confiance 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 Cloud de Confiance 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 podrían haber escrito 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 se ajustan según el intervalo de tiempo que captura el cronograma del histograma. Puedes ajustar el cronograma del histograma con 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 intervalos 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.