Usa el Explorador de registros

En esta guía, se muestra cómo buscar y ver registros con el Explorador de registros en Google Cloud Console.

También puedes leer registros mediante la API de Logging y el SDK de Cloud.

Comenzar

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

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

  • Ten en cuenta que si usas Amazon Web Services Elastic Compute Cloud (AWS EC2), tus entradas de registro se encuentran en el proyecto del conector de AWS que vincula tu cuenta de AWS a Google Cloud. servicios.

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

  • Navega al Explorador de registros:

    Ir al Explorador de registros.

    Selecciona el proyecto de Cloud adecuado.

Interfaz del explorador de registros

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

Interfaz de usuario para el explorador de registros

El Explorador de registros contiene los siguientes paneles, que se detallan en las siguientes secciones:

  1. Barra de acciones
  2. Compilador de consultas
  3. Campos de registro
  4. Histograma
  5. Resultados de la consulta

Barra de acciones

Panel de barra de acciones

El panel Barra de acciones ofrece las siguientes funciones:

  1. Opciones: Te permite ir al visor de registros heredado, enviar comentarios y ver un resumen de las nuevas funciones de Logging.
  2. Definir mejor el permiso: Te permite definir el permiso de la búsqueda según los registros del proyecto de Cloud actual o solo una o más vistas de almacenamiento. Para obtener más información sobre el permiso, consulta Define mejor el permiso.
  3. Compartir vínculo: Te permite crear una URL abreviada de la consulta actual y copiarla en el portapapeles, lo que facilita compartir una consulta. Se proporcionan dos opciones: Copiar con un intervalo de tiempo absoluto y Copiar con un intervalo de tiempo relativo. Si seleccionas Copiar con un intervalo de tiempo absoluto, la URL copiada debe tener el intervalo de tiempo absoluto correspondiente representado por el intervalo de tiempo actual, por ejemplo, 7:49:37 PM - 8:49:37 PM. Si seleccionas Copiar con un intervalo de tiempo relativo, la URL copiada tendrá seleccionado el intervalo de tiempo relativo actual, por ejemplo, 1 hour.
  4. Selector de intervalo de tiempo: Te permite restringir los resultados de la búsqueda por intervalo de tiempo. El intervalo de tiempo predeterminado es de una hora.
  5. Diseño de página: Te permite habilitar o inhabilitar los paneles Histograma y Explorador del campo de registro.
  6. Aprende: Te permite ver los vínculos a la documentación relevante.

Ten en cuenta que si tienes una consulta con una marca de tiempo, el selector de rango de tiempo está inhabilitado y la consulta usa la expresión de marca de tiempo como su restricción de rango de tiempo. Si una consulta no usa una expresión de marca de tiempo, la consulta usa el selector de rango de tiempo como su restricción de rango de tiempo.

Define mejor el permiso

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

  1. En el panel Barra de acciones, selecciona Definir mejor el permiso.

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

    Cuadro de diálogo Definir mejor el permiso

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

    • Alcance por almacenamiento Te permite buscar registros en función de una o más vistas de almacenamiento. Para obtener más información sobre las vistas de registro, consulta Administra vistas de registro en tus buckets de registro.

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

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

    • El usuario tiene acceso a la vista de almacenamiento.
    • Los buckets de registro pertenecen al proyecto de Cloud seleccionado o el proyecto de Cloud seleccionado ya enruta registros a los buckets de almacenamiento.
  4. Haz clic en Aplicar.

Compilador de consultas

Compilador de consultas

En el panel Compilador de consultas, puedes hacer lo siguiente:

  1. Campo Compilador de consultas: Te permite compilar consultas mediante el lenguaje de consultas de Logging.
  2. Menús desplegables del compilador de consultas: Te permite agregar expresiones de consulta basadas en Recurso, Nombre del registro y Gravedad. Para obtener más información, consulta Menús desplegables del compilador de consultas.
  3. Recientes: Te permite ver tus consultas recientes. Para obtener más información, lee Consultas recientes.
  4. Guardadas: Te permite ver tus consultas guardadas y las consultas que otros usuarios del proyecto de Cloud han compartido contigo. Para obtener más información, lee Consultas guardadas y Consultas compartidas.
  5. Sugeridas: Te permite ver las consultas sugeridas en función de los recursos en tu proyecto de Cloud. Para obtener más información, le Consultas sugeridas.
  6. Guardar: Te permite guardar las consultas que se pueden ver y ejecutar desde la pestaña Guardados.
  7. Transmitir registros: Te permite ver las entradas de registro a medida que Logging las transfiere. Para obtener más información, consulta Transmite registros.
  8. Ejecutar: Te permite ejecutar tus consultas después de haberlas creado en el campo de compilador de consulta.

Transmitir registros (Stream logs)

Puedes transmitir tus registros a medida que Logging los transfiere o puedes agregar una consulta para transmitir solo los registros que coinciden con ella.

Para transmitir registros basados en una consulta, agrega una consulta al campo del compilador de consultas y, luego, selecciona Transmitir registros. A medida que Logging transfiere los datos de los registros, solo se muestran en el panel Resultado de la consulta los registros que coinciden con la consulta. Si no se proporciona una consulta, Logging muestra cada registro a medida que se transfiere.

Agrega una consulta antes de seleccionar la transmisión de registros

Para detener la transmisión, selecciona Detener transmisión o desplázate hacia abajo dentro del panel Resultados de la consulta.

El panel Campos de registro

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

Habilita el panel Campos de registro

Para habilitar el panel Campos de registro, selecciona Diseño de página y, luego, la casilla de verificación Campos de registro. Aparecerá el panel Campos de registro.

Panel Campos de registro seleccionado

Para inhabilitar el panel Campos de registro, desmarca la casilla de verificación Campos de registro.

Características del panel Campos de registro

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

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

Panel de campo de registro.

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

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

Agrega campos al panel Campos de registro

Puedes agregar algunos pares clave-valor LogEntry al panel Campo de registros desde las entradas de registro propagadas en el panel Resultados de la consulta. Para agregar un campo al panel Campos de registro, haz lo siguiente:

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

  2. Haz clic con el botón izquierdo en el valor de un campo. En el menú, selecciona Agregar campo al panel Campos de registro (Add field to Log fields pane).

    Menú con opción para agregar un campo.

    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. También puedes quitar un campo personalizado de la lista si haces clic con el botón izquierdo en el panel Resultados de la consulta y seleccionas Quitar de campos de registro.

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

  • Campos relacionados con la hora, por ejemplo, receiveTimestamp y protoPayload.startTime.
  • Campos con alta cardinalidad, por ejemplo, insertId y protoPayload.latency.
  • Campos con índices de array en su ruta de acceso, por ejemplo, protoPayload.authorizationInfo[0].resource.

Analiza registros con el panel Campos de registro

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

Puedes agregar pares de valor de campo anidados, además de pares de valor de campo de nivel superior, al panel Campos de registro.

Por ejemplo, supongamos que agregaste jsonPayload.message al panel Campos de registro. Si seleccionas un valor jsonPayload.message en particular, se propaga el panel del Compilador de consultas:

Los paneles Campos de registro y Compilador de consultas con un campo personalizado agregado

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

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

Histograma

El panel Histograma te permite visualizar la distribución de los registros en el tiempo. El histograma se vuelve a generar cuando ejecutas una consulta, lo que facilita la visualización de tendencias en los datos de tus registros y la solución de problemas.

Habilita el panel de histograma

Para habilitar el panel de histograma, selecciona Diseño de página (Page Layout) y, luego, marca la casilla de verificación Histograma (Histogram). Aparecerá el panel Histograma (Histogram).

Está abierto el diseño de la página y seleccionado histograma

Para inhabilitar el panel de histograma, desmarca la casilla de verificación Histograma (Histogram).

Características del histograma

Panel de histograma

  1. Barras del histograma: Cada barra del histograma representa un intervalo de tiempo. Cada barra contiene un desglose de tres colores para los niveles de gravedad del registro capturados en el intervalo de tiempo de cada barra. Los colores representan las siguientes gravedades del registro:

    • Azul: Gravedad baja, como Predeterminada, Depuración, Información y Aviso.
    • Amarillo: Gravedad media, como Advertencia.
    • Rojo: Gravedad alta, como Error, Crítico, Alerta y Emergencia.

    Cada barra del histograma cuenta con un menú con opciones para analizar tus registros.

  2. Controles de tiempo: Te permiten ajustar el intervalo de tiempo de los registros que ves en el panel Resultados de la consulta. Para obtener detalles sobre estas opciones, consulta Analiza registros mediante los controles de tiempo.

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

Analiza registros con controles de tiempo

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

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

Ajusta el tiempo rápidamente

El histograma proporciona controles de tiempo que te permiten ajustar rápidamente los datos que ves en el Explorador de registros.

En el cronograma del panel de histograma, se muestran los controles de tiempo rápidos.

  • Controladores de tiempo: Arrastra los controladores del cronograma hacia adentro a fin de limitar los datos o hacia fuera para ampliar los datos en el cronograma del histograma. Haz clic en Ejecutar.

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

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

Las modificaciones de la línea de tiempo están limitadas a estar entre la hora actual (“ahora”) y hace 30 días.

Desplázate o ve registros del período

Además de los controles de tiempo anteriores, el histograma proporciona las funciones Desplazarse por registros (Scroll to time) y Ver registros del período (Zoom to time) para darte un control más detallado del histograma y los datos que ves en otros paneles en el explorador de registros.

Cronograma del panel de histograma con los controles Desplazarse por registros y Ver registros del período.

Quizás una barra de histograma en particular te interese según su tamaño relativo o sus niveles de gravedad. Puedes seleccionar esa barra de histograma para ajustar los datos de los registros que ves en el Explorador de registros.

La función Desplazarse por registros te permite explorar los datos de tus registros sin cambiar los valores en los paneles Histograma y Campos de registro. Cuando seleccionas la función Desplazarse por registros, sucede lo siguiente:

  • Los datos de registros que ves en el panel Resultados de la consulta se ajustan según el intervalo de tiempo que captura la barra de histograma seleccionada.

    La consulta no se ejecuta, pero puede que se realice una carga parcial de los datos para garantizar que veas registros en el panel Resultados de la consulta que correspondan al intervalo de tiempo de la barra de histograma seleccionada.

  • La URL de la consola se actualiza para contener el timestamp del registro más reciente capturado por el intervalo de tiempo de la barra de histograma seleccionada.

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

  1. Coloca el cursor sobre una barra en el cronograma del Histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Desplazarse por registros.

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

La función Ver registros del período es similar a Desplazarse por registros, pero ejecuta una consulta en tus datos de registros según el intervalo de tiempo que captura una barra de histograma seleccionada. Cuando seleccionas la función Ver registros del período, ocurre lo siguiente:

  • Los datos de registros que ves en el panel Resultados de la consulta se vuelven a limitar y reducir según la restricción de intervalo de tiempo de la barra de histograma seleccionada.
  • La URL de la consola se actualiza para contener el timestamp del registro más reciente capturado por el intervalo de tiempo de la barra de histograma seleccionada.
  • El histograma cambia para mostrar solo los registros que tienen un valor timestamp que se encuentra dentro del intervalo de tiempo de la barra de histograma seleccionada, según la barra de histograma seleccionada.
  • Los datos del panel Campos de registro se ajustan según el intervalo de tiempo que captura la barra de histograma seleccionada.

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

  1. Coloca el cursor sobre una barra en el cronograma del Histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

  2. En el panel, selecciona Ver registros del período.

Resultados de la consulta

Panel de resultados de la consulta

El panel Resultados de la consulta te permite explorar las entradas de registro que coinciden con las expresiones de la consulta y el intervalo de tiempo que seleccionaste mediante los controles de tiempo o el selector de intervalo de tiempo del histograma.

  1. Query results (Resultados de consultas): Te permite ver los registros recuperados de tu consulta.
  2. Entradas de registro: Te permite ver las entradas de registro en el formato JSON estructurado.
  3. Expandir y contraer los resultados de la consulta: Te permite expandir el panel de resultados de la consulta para ver más entradas de registro.
  4. Zona horaria: Te permite cambiar la zona horaria en la que se muestran los registros.
  5. Datos de seguimiento: Te permite ver los detalles de seguimiento y definir mejor tu consulta en función del seguimiento. Para obtener más información, consulta Ver los datos de seguimiento.
  6. Ocultar resumen de registros: Te permite ocultar la línea de resumen de registros de los resultados de la consulta.
  7. Expandir o contraer los campos de registro anidados: Te permite expandir o contraer los campos anidados.
  8. Copiar en el portapapeles: Te permite copiar la entrada de registro en su formato JSON.
  9. Copiar vínculo a una entrada de registro: Te permite compartir un vínculo a una entrada de registro. Para obtener más información, consulta Copia un vínculo a una entrada de registro.
  10. Pasar a los más recientes: Te permite realizar una actualización forzada para incluir la hora actual. Si el selector de intervalo de tiempo usa un intervalo personalizado y se establece una hora de finalización, ejecuta la consulta con un intervalo de tiempo predeterminado de una hora. De lo contrario, se actualiza con la fecha de inicio o la duración actuales y ejecuta la consulta. Ten en cuenta que la expresión de consulta no se modifica cuando usas esta función.
  11. Acciones: Te permite configurar una métrica basada en registros, crear un destino de receptor o descargar tus registros. Para obtener más información sobre cómo descargar registros, consulta Descarga registros.
  12. Configuración: Te permite agregar el valor de un campo de registro a la línea de resumen al comienzo o al final de la entrada de registro. También te permite optar por mostrar los registros más recientes, ya sea el primero o el último. Para obtener más información sobre cómo agregar un campo de resumen, consulta Agrega campos de resumen.
  13. Fijar la entrada de registro: Te permite fijar una entrada de registro en los paneles Histograma y Resultados de la consulta. Para obtener más información, consulta Fija registros.
  14. Desplazamiento del cursor: Cuando te desplazas por los registros en Resultados de la consulta, la URL se ajusta para incluir cursorTimestamp, que indica la timestamp del registro más reciente que se muestra en panel de Resultados de la consulta más recientes.

Dentro del panel de resultados de la consulta, puedes hacer clic en los valores de un campo para realizar alguna de las siguientes acciones:

Opciones después de seleccionar el valor del campo

  1. Mostrar las entradas coincidentes: Te permite consultar entradas de registro coincidentes.
  2. Ocultar las entradas coincidentes: Te permite consultar entradas de registro que no coinciden con la expresión seleccionada.
  3. Add field to summary line (Agregar campo a línea de resumen): Te permite agregar el campo como una línea de resumen para registrar entradas.

Agrega campos de resumen

Los campos de resumen te ayudan a detectar patrones en tus registros con mayor rapidez. Por ejemplo, en la siguiente imagen, se muestra el valor del campo de resumen resource.labels.pod_name agregado antes de los registros que contienen ese valor.

El explorador de registros muestra registros precedidos por texto verde que muestra nombres de pod.

Agrega un campo de resumen a partir de una entrada de registro

Para agregar un campo de resumen a una entrada de registro, completa los siguientes pasos:

  1. Haz clic en el botón expandir  para expandir una entrada de registro.

  2. Haz clic en el valor de un campo y, luego, selecciona Agregar campo a la línea de resumen.

    El campo de resumen ahora aparece antes de las entradas de registro que contienen ese campo.

Agrega un campo de resumen mediante el botón Configurar.

Para agregar un campo de resumen mediante el botón Configurar, completa los siguientes pasos:

  1. Haz clic en Configure (Configurar) y selecciona Manage Summary Fields (Administrar campos de resumen).

    Administrar campos de resumen se selecciona en el menú desplegable configurar

  2. Agrega campos.

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

    • Completar automáticamente mediante los registros que se muestran en el momento
    • Corrección de campos para caracteres legales entre comillas

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

  3. Haz clic en Truncar los campos de resumen para acortar la vista de los valores del campo de resumen. Luego, elige cuántos caracteres mostrar antes de que se trunque el campo y si debe mostrarse el principio o el final del campo.

  4. Haz clic en Aplicar.

    El campo de resumen ahora aparece antes de las entradas de registro que contienen ese campo.

Fija las entradas de registro

Fijar una entrada de registro te permite destacar una entrada de registro de interés.

Para fijar una entrada de registro, desplázate sobre la entrada de registro que quieres fijar y, luego, selecciona el ícono de fijar . Después de fijar una entrada de registro, se oscurece el fondo y se muestra un ícono de fijar .

Si fijas una entrada de registro y vuelves a ejecutar tu consulta, la entrada de registro fijada aparecerá en la parte superior o inferior del panel Resultados de la consulta, según cómo se configuren los datos de registros. También aparece un ícono de fijar en el panel Histograma según la timestamp de la entrada de registro fijada.

El explorador de registros muestra una entrada de registro fijada en el panel “Resultados” y en el panel del histograma.

Para dejar de fijar el registro, selecciona el ícono de fijar y, luego, No fijar entrada de registro.

Visualiza una entrada de registro fijada en su contexto de recursos

Para ver el registro fijado en el contexto de los recursos, selecciona el ícono de fijar y, luego, selecciona Fijar y mostrar entradas de registro del recurso.

Se selecciona la opción de fijar y mostrar en el contexto de recursos.

Logging propaga el Compilador de consultas con el campo resource.type de la entrada de registro fijada y ejecuta la consulta. Ahora puedes ver la relación de entrada de registro fijada con el tipo de recurso.

Visualiza una entrada de registro fijada en el panel Histograma

Puedes usar el panel Histograma para destacar, desplazarte y examinar más una entrada de registro fijada.

Con el panel Histograma, selecciona el ícono de fijar y, luego, elige una de las siguientes opciones del menú:

  • Desplázate hasta la entrada de registro: Esta opción lleva la entrada de registro al panel Resultados de la consulta actual y te permite ver la entrada de registro fijada en el contexto de los registros cercanos.
  • Hacer zoom a la entrada de registro: Esta opción reduce el intervalo de tiempo que se muestra el panel Histograma y te permite definir mejor tu consulta para aislar los registros cerca del registro fijado.

Se redujo el plazo del histograma.

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.

Pantalla de entrada de registro que contiene datos de seguimiento

Cuando una entrada de registro contiene solo el campo trace, solo aparecerá el ícono de seguimiento.

Pantalla de entrada de registro que contiene solo el campo de seguimiento, tiene el ícono de seguimiento.

Para ver los datos de seguimiento relacionados con la entrada de registro, haz clic en el ícono de seguimiento. Tienes las siguientes opciones:

  • Ver detalles de seguimiento: Muestra el intervalo superior y los seguimientos secundarios junto con los detalles sobre el seguimiento. Para ver más detalles sobre el seguimiento, haz clic en Ver en Trace a fin de navegar a Cloud Trace. Para obtener más información sobre el contenido del panel de detalles, consulta Ver detalles de seguimiento.
.
  • Mostrar todos los registros de este seguimiento: Define mejor y ejecuta la consulta. Para ello, agrega el campo trace configurado al identificador de seguimiento asociado con la entrada de registro.

  • Mostrar solo las solicitudes con seguimiento: Define mejor y ejecuta la consulta. Para ello, agrega el campo traceSampled configurado como True. Para obtener más información sobre el muestreo, consulta Tasa de muestreo.

Visualiza los datos de Monitoring

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

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

Se muestra el menú de Explorador de registros para los recursos de GKE.

Para compartir un vínculo a un registro, expande una entrada de registro y, luego, selecciona Copiar vínculo. El vínculo se copió en el portapapeles. Ahora puedes enviar el vínculo a los usuarios que tienen acceso al proyecto de Cloud. Cuando un usuario pega el vínculo en un navegador o lo selecciona, Logging fija la entrada de registro en su panel Resultados de la consulta.

Copia el vínculo para compartir la entrada de registro con otros.

Descargar registros

Puedes descargar tus registros en formato CSV o JSON. Necesitas una de las siguientes funciones de Identity and Access Management para descargar registros:

  • Administrador de Logging (roles/logging.admin)
  • Descriptor de acceso de vista de registros (roles/logging.viewAccessor)

Para descargar tus registros, haz lo siguiente:

  1. Selecciona Acciones (Actions) y, luego, Descargar registros (Download Logs).

    Descarga registros con el botón Acciones.

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

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

    • Descarga los datos en tu computadora.
    • Descarga los datos en Drive.
    • Ve los datos en una pestaña nueva.

    Cuando guardas un archivo CSV y seleccionas Drive, puedes abrir el archivo en Hojas de cálculo.

Consultas de ejemplo

La página Obtén consultas de muestra con el Explorador de registros proporciona consultas sugeridas para que puedas encontrar registros que te podrían interesar. Por ejemplo, puedes ejecutar consultas relacionadas con Kubernetes para encontrar los registros de Google Kubernetes Engine.

Soluciona problemas

En esta sección, se proporcionan instrucciones para solucionar problemas habituales cuando se usa el Explorador de registros.

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

Para obtener un ID de organización o del proyecto de Cloud desde Google Cloud Console, expande la lista de proyectos de Cloud del selector de proyecto y organización, y busca el ID del proyecto de Cloud en la columna ID:

Se muestra el ID del proyecto

No se pueden ver las entradas de registro

Si no ves ninguna entrada de registro, verifica lo siguiente:

  • ¿Se seleccionó el proyecto de Cloud correcto? Si no es así, selecciona el proyecto de Cloud correcto del selector de proyectos y organización de Cloud.

  • ¿Tu proyecto de Cloud usa recursos que generan registros? ¿Hay actividad en esos recursos? Incluso si el proyecto de Cloud es nuevo, debe tener registros de auditoría que registren su creación. Para verificar que estás usando un recurso que genera registros, ve a la sección "Asigna servicios a tipos de recursos" en la página Lista de recursos supervisados.

  • ¿El intervalo de tiempo es demasiado reducido? Verifica que el intervalo de tiempo en tu consulta sea correcto.

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

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 a fin de 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 registro 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. Ajusta el cronograma del histograma mediante los controles de tiempo del histograma o el selector de rango de tiempo. Ajustar estos controles de tiempo no altera la expresión de consulta en el panel Compilador de consultas.

Si tienes una consulta con una marca de tiempo, el selector de intervalos de tiempo se inhabilita y la consulta usa la expresión de marca de tiempo como su restricción de intervalo de tiempo. Si una consulta no usa una expresión de marca de tiempo, usará el selector de intervalos de tiempo como su restricción de intervalo de tiempo.

Obtenga asistencia

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