Visualiza registros con el explorador de registros

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

Para realizar operaciones agregadas en tus entradas de registro, como contar el número de que contengan un patrón específico, actualiza el bucket de registros para Análisis de registros y, luego, ejecuta consultas desde el Análisis de registros de la consola de Google Cloud. Puedes continuar usando Explorador de registros para ver registros en buckets de registros que se actualizaron para usar el Análisis de registros. Para obtener más información, consulta Descripción general del Análisis de registros.

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

Antes de comenzar

Si quieres obtener los permisos que necesitas para usar el Explorador de registros para ver las entradas de registro, solicita a tu administrador que te otorgue el 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 permiso de registro: Visor de registros (roles/logging.viewer) en tu proyecto, organización o carpeta.
• Para ver todas las entradas de registro en los buckets de _Required y _Default, haz lo siguiente: Visor de registros privados (roles/logging.privateLogViewer) en tu proyecto, organización o carpeta.
• 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 las entradas de registro almacenadas en una vista de registro en un bucket de registros, haz lo siguiente: Descriptor de acceso de 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 Cómo controlar 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 buscaron entradas de registro.
   • El parámetro de configuración del intervalo de tiempo
   • Tus roles de Identity and Access Management (IAM) en los recursos buscados.
   • Tu consulta filtra los resultados. Por ejemplo, agregar la consulta severity>=ERROR da como resultado la pantalla que enumere únicamente las entradas de registro con un nivel de gravedad de ERROR como mínimo.

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

   Después de que se abra la página Explorador de registros puedes usar el botón Refine Scope. para seleccionar los recursos que se buscan. Los cambios que realices con el botón Refine Scope se aplica solo a su sesión actual.

Interfaz del explorador de registros

La interfaz del Explorador de registros te permite mostrar, analizar y analizar entradas de registro y especificar los parámetros de consulta.

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

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

Barra de herramientas de acciones

Con las funciones de la barra de herramientas Acción, puedes hacer lo siguiente:

• Definir mejor el alcance: Configura en qué recursos se buscarán las entradas de registro. Tu consulta filtra los resultados. Para obtener más información, consulta Define mejor el permiso.
• Obtener información: Consulta los vínculos a documentación y temas relevantes.
• Compartir vínculo: Crea una URL abreviada de la consulta. cópiala en tu portapapeles, para que sea más fácil compartir una consulta. La URL copiada tiene el intervalo de tiempo absoluto correspondiente representado por el intervalo de tiempo de tu consulta; por ejemplo, 7:49:37 PM - 8:49:37 PM.

Nota: Si los datos se administran a través de un Entorno de Assured Workloads, esta función podría verse afectada o restringida. Para obtener más información, consulta Restricciones y limitaciones de Assured Workloads.

Definir mejor el permiso

Cuando abres la página Explorador de registros, se recuperan las entradas de registro. que se originan en el recurso que seleccionaste que tengas permiso para ver. Para los proyectos de Google Cloud, la capa las entradas de registro también incluyen aquellas que un receptor enruta al proyecto en otro proyecto. Si ingresas una consulta, el Explorador de registros mostrará solo los las entradas de registro recuperadas que también coinciden con la consulta. Por ejemplo, agregar la consulta severity>=ERROR da como resultado la pantalla que enumere únicamente las entradas de registro con un nivel de gravedad de ERROR como mínimo.

Nota: Para configurar qué recursos se buscan cuando se abre la página del Explorador de registros, establece el ámbito de registro predeterminado. Para obtener más información, consulta Cómo crear y administrar alcances de registro.

En tu sesión actual, puedes configurar en qué recursos el Explorador de registros busca entradas de registro con el menú Definir mejor el alcance. Por ejemplo, cuando solucionas problemas, quizás quieras examinar solo las entradas de registro que están incluidas en un vista de registro o que se originen en un proyecto específico de Google Cloud.

El menú Definir mejor el permiso te permite buscar por el rango proyecto, por vista de registro o por 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ú Refinar 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. Para los proyectos de Google Cloud, la búsqueda resultados también incluyen las entradas de registro que se enrutan al proyecto por un receptor en otro proyecto.

• Para buscar vistas de registro, expande el menú Define mejor el permiso, selecciona Vista de registro. y, luego, selecciona una o más vistas de registro en el 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ú enumera Vistas de registros en buckets de registros almacenados en el proyecto seleccionado. Sin embargo, cuando una carpeta u organización, el menú enumera todos que almacenan entradas de registro originadas en esos recursos.

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

• Para buscar los recursos incluidos en un alcance de registro, que pueden incluir proyectos y vistas de registro, expande el menú Define mejor el permiso Selecciona Alcance de registros y, luego, un ámbito de registros.

  Si quieres configurar los permisos de los registros, haz clic en Administra los permisos. Para obtener más información, consulta Crea y administra permisos de registros.

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

Panel Consulta

Usa las funciones del panel Consulta (Query) para realizar cualquiera de las siguientes acciones:

• Pestaña Consulta: Crea y define mejor las consultas con las siguientes funciones:

  • Selector de intervalo de tiempo: Especifica un intervalo de tiempo para las entradas de registro que deseas ver. Para obtener más información, consulta Usa el selector de intervalo de tiempo.

  • Cuadro de texto de búsqueda: Encuentra entradas de registro que coincidan con tus términos o frases de búsqueda. Para obtener más detalles, consulta Busca texto en los campos de registro.

    Nota: El comportamiento de las búsquedas de texto cambió. Cuando no enrolles el términos de búsqueda entre comillas dobles, Función SEARCH se invoca automáticamente.

  • Menús de filtro: Crea consultas en función de Recurso, Nombre del registro y Gravedad. Para obtener más información, consulta Usa menús de filtro.

  • Query-Editor field: crear consultas avanzadas con el Lenguaje de consulta de Logging. Para obtener más información, consulta Escribe consultas avanzadas.

    Nota: El Explorador de registros agrega de forma implícita el restricción conjuntiva, AND, entre las sentencias que se muestran en el panel de consultas. Por ejemplo, si la línea uno es resource.type = "gce_instance" y la línea dos es severity >= "ERROR", la consulta se resource.type = "gce_instance" AND severity >= "ERROR" Si deseas usar una consulta que muestra el Explorador de registros en otro contexto, por ejemplo, para el filtro de inclusión o exclusión de un receptor, debes modificar la consulta y agregar las restricciones conjuntivas. Para obtener más información, consulta la Lenguaje de consulta de Logging.

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

• Pestaña Guardados: Visualiza las consultas guardadas y las consultas que otras que los usuarios del proyecto de Google Cloud compartieron contigo. Para ver más información, consulta Guardar consultas y Compartir consultas.

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

• Pestaña Library: Consulta y ejecuta las consultas proporcionadas por Google según tus casos de uso. Para obtener más información, consulta Selecciona consultas de la biblioteca.

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

• Borrar consulta: Borra y restablece las selecciones que realizaste cuando creaste una consulta en el panel Consulta.

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

• Run query: Ejecuta tus consultas después de haberlas creado en el panel Query.

Si no ves el campo del editor de consultas, habilita Mostrar consulta. Si agregas alguno términos de búsqueda en el cuadro de texto de búsqueda, esos términos también aparecen en query-editor y se evalúan como parte de la expresión de consulta.

Después de revisar tu consulta, haz clic en Ejecutar consulta. Registros que coinciden tu consulta aparecen en el panel Resultados de la consulta. El Paneles Histograma y Campos de registro ajustar de acuerdo con la expresión de la consulta.

Transmitir registros (Stream logs)

Puedes transmitir los registros como Logging los almacena en buckets de registros, o puedes agregar una consulta transmitir solo aquellos registros que coinciden con la consulta.

Para transmitir registros basados en una consulta, agrega una consulta al panel Consulta. Luego, selecciona Transmitir registros. 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 está almacenada.

Para detener la transmisión, haz clic en Detener transmisión o desplázate dentro del Panel Resultados de la consulta

Barra de herramientas de Resultados

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

• Campo de registros: Oculta o muestra el panel Campo de registros. del diseño de la página del Explorador de registros. Para obtener más información, consulta la sección Panel de campo de registros de este documento.
• Histograma: Oculta o muestra el panel Histograma. del diseño de la página del Explorador de registros. Para obtener más información, consulta la Histograma de este documento.
• Analizar los resultados: Agrupa y crea gráficos con los resultados de tus consultas con Análisis de registros. Esta solo es visible si el permiso que seleccionaste contiene un bucket de registros que se actualizó para usar el Análisis de registros. Para obtener más información, consulta la sección Cómo analizar los resultados de este documento.
• Crear métrica: Configura una métrica basada en registros.
• Crear alerta: Configura una Política de alertas basada en registros.
• Pasar a los más recientes: Realiza una actualización forzada de los resultados de tus consultas para incluir la hora actual. Si el selector de intervalo de tiempo usa un un rango personalizado y se configura una hora de finalización, ejecuta la consulta con una hora predeterminada rango de una hora. De lo contrario, se actualizará con la fecha de inicio actual. duración y ejecuta la consulta. Ten en cuenta que la expresión de la consulta no se modificó cuando uses esta función.

• Más acciones: Usa estas opciones adicionales para administrar políticas de alertas basadas en registros crea un receptor.

Analizar resultados

Puedes agregar, analizar y graficar tus datos de registro con consultas en SQL en la página Análisis de registros cuando el proyecto contenga buckets de registros que se actualicen para usar el Análisis de registros. Para ir a la página Análisis de registros desde el Explorador de registros, en la barra de herramientas Resultados, haz clic en Analiza los resultados.

El botón Analyze results solo será visible cuando el permiso que seleccionaste contiene un bucket de registros que se actualizó para usar Análisis de registros. Por ejemplo, si seleccionaste Vista de registro Para ello, usa el botón Refine scope y, luego, . El botón Analizar resultados se muestra cuando hay al menos un bucket en el almacenamiento. permiso se actualiza 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.

Lo siguiente ocurre cuando haces clic en Analizar resultados:

• El intervalo de tiempo en el Explorador de registros puede ajustarse automáticamente que haya datos de registro significativos en la página Análisis de registros.

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

• El recurso seleccionado por el selector de proyectos de Google Cloud y el valor del La configuración de Definir mejor el permiso determina cómo la cláusula FROM. en la consulta en SQL. El recurso seleccionado puede ser un proyecto, organización o carpeta:

  • Cuando el menú Definir mejor el permiso muestra la lista Proyecto, Luego, se consultan los buckets _Required y _Default del recurso.

  • Cuando el menú Definir mejor el permiso muestra la opción Ver, las vistas de registro de y los buckets de registros en el proyecto actual. Se ignoran las vistas de registros en buckets de registros almacenados por diferentes recursos.

  • Cuando el parámetro de configuración Definir mejor el permiso muestra el nombre de un ámbito de registros, y el anterior se aplican a los recursos enumerados en la lista permiso de registro. Por ejemplo, si el ámbito de registros contiene vistas de registro, entonces solo aquellas se consultan vistas de registro en buckets de registros almacenados por el recurso. Los permisos de registro están en versión preliminar pública.
  Nota: El Análisis de registros no admite consultas en proyectos o regiones. Cuando el parámetro de configuración Definir mejor el permiso incluye entradas de registro que se almacenan en varios proyectos o regiones, es posible que el Análisis de registros muestre entradas de registro diferentes a las de la página Explorador de registros.

En la página Análisis de registros, puedes ver tus resultados en forma de tabla, 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 información sobre cómo crear gráficos a partir de los resultados de tu consulta y cómo guardar gráficos en un panel personalizado, consulta Gráfico de los resultados de la consulta con el Análisis de registros.

Si deseas obtener información sobre el uso de SQL para escribir consultas, consulta Consulta y visualiza registros en el Análisis de registros.

El panel Campos de registro

El panel Campos de registro ofrece un resumen de alto nivel de los datos de registro y y proporciona una forma eficiente de definir mejor una consulta. El panel muestra las entradas de registro dañadas según diferentes dimensiones, correspondientes a los campos de estas entradas.

Después de que ejecutes la consulta en el campo de editor de consultas, en el panel Campos de registro se propaga en función de los resultados de la consulta. Este panel muestra los recuentos de de registros 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, Luego, selecciona el tipo de recurso Nodo genérico.

• Gravedad

  Si quieres que tu consulta filtre por varios niveles de gravedad, usa el menú Gravedad.

Es posible que veas una dimensión Servicio:

• Si tienes registros cuyo tipo de recurso es Contenedor de Kubernetes, y si no filtraste los registros por tipo de recurso, entonces, se completa el menú Servicio. Las entradas de este menú se se determina de forma dinámica según los valores de la configuración k8s-pod/app etiqueta.

  Por ejemplo, si como resultado se muestra una entrada de registro similar a la siguiente 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 Recurso auditado, entonces, se completa el menú Servicio. Las entradas de este menú se se determina de forma dinámica mediante los valores de la etiqueta service del recurso.

Otras dimensiones, como el ID del proyecto, se muestran según tu selecciones. Por ejemplo, la dimensión ID del proyecto aparece cuando tu restringe las entradas de registro a aquellas cuyo tipo de recurso Contenedor de Kubernetes, o cuando seleccionaré 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, la se actualizó el panel de consultas para incluir severity=ERROR.

En la siguiente captura de pantalla, se ilustra el campo de editor de consultas después de la gravedad y el tipo de recurso se seleccionaron mediante el panel Campos de registro:

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

Agrega campos al panel Campos de registro

Puedes agregar algunos pares clave-valor LogEntry al panel Campo de registros desde las entradas de registro propagadas en el panel Resultados de la consulta. Por ejemplo: Si filtras con frecuencia por el valor del campo jsonPayload.message, entonces y agregarla al panel Campo de registros.

Para agregar un campo al panel Campo de registro, haz lo siguiente:

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

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

Histograma

Nota: Cada elemento del histograma muestra la cantidad aproximada de las entradas de registro recibidas 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 Histograma, puedes visualizar la distribución de los registros en tiempo. El histograma se vuelve a generar cuando ejecutas una consulta, lo que facilita la visualización de tendencias en los datos de tus registros y la solución de problemas.

Para ocultar o mostrar el panel Histograma, haz clic en Histograma en en la barra de herramientas Resultados.

Funciones de histograma

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

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

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

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

3. Cronograma: Te muestra el intervalo de tiempo de los registros, representado por de barras de histogramas, que se muestran en los Resultados de la consulta del panel de control. El cronograma te ayuda a orientarte con los registros que estás viendo dentro del intervalo de tiempo mayor de tu consulta.

Analiza registros con controles de tiempo

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

Sugerencia: Cuando ajustas los controles de tiempo del histograma, los datos de registro del Los paneles Resultados de la consulta y Campos de registro se ajustan en función del intervalo de tiempo. capturada por la línea de tiempo del histograma. Ajusta los controles de tiempo del histograma no modifica la expresión de consulta en el panel Consulta.

Ajusta el tiempo rápidamente

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

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

• Para deslizar la línea de tiempo hacia adelante y hacia atrás, haz clic en Flecha hacia delante para deslizar el cronograma a otro momento. 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 Acercamiento para acotar los datos que se muestran en el cronograma.

Las modificaciones del cronograma solo deben realizarse 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 mencionados anteriormente, el histograma proporciona la opción Desplazarse para funciones de tiempo y Zoom al momento para brindarte un control más detallado del el histograma y los datos que ves en otros paneles del Explorador de registros.

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

Puedes usar la función Desplazarse hacia abajo para explorar los datos de 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. Mantén el puntero sobre una barra en el cronograma del histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

2. En el panel, selecciona Desplazarse por registros.

   Alternativamente, hacer clic en una barra de histograma es equivale a seleccionar Desplazarse al tiempo.

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

• Los datos de registros que ves en el panel Resultados de la consulta se vuelven a limitar y reducir según la restricción de intervalo de tiempo de la barra de histograma seleccionada.
• La URL de la consola se actualiza para contener el timestamp del registro más reciente capturado por el intervalo de tiempo de la barra de histograma seleccionada.
• El histograma cambia para mostrar solo los registros que tienen un valor timestamp que se encuentra dentro del intervalo de tiempo de la barra de histograma seleccionada. por 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. Mantén el puntero sobre una barra en el cronograma del Histograma. Aparecerá un panel que contiene información resumida sobre los datos de los registros para el intervalo de tiempo especificado.

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

Resultados de la consulta

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

Configura la columna Time

La columna Tiempo en el panel Resultados de la consulta muestra las marcas de tiempo de tus entradas de registro. Puedes personalizar la columna Tiempo para que solo ciertos partes de la marca de tiempo sean visibles. Esto crea más espacio horizontal para que puedes ver más información en la entrada de registro.

Para seleccionar qué partes de la marca de tiempo quieres mostrar, haz clic en Menú Opciones de hora adicionales en Time y, luego, selecciona una de las siguientes opciones:

• Fecha, hora y zona horaria

• Fecha y hora (predeterminadas)

• Solo hora

Busca patrones en tus registros mediante campos de resumen

Supongamos que buscas en las entradas de registro en los resultados de la consulta y quieres hacer una lectura rápida de los resultados por un determinado campo LogEntry. O quizás debes agrupar tus entradas de registro por un par campo-valor determinado. Puedes agregar campos de resumen a tus resultados, que aparecen como chips al comienzo de cada línea de entrada de registro. Por ejemplo, en la siguiente imagen, se muestran los resultados de la consulta con el Se agregó el campo de resumen resource.type a cada línea de entrada de registro:

El Explorador de registros ofrece campos de resumen predeterminados y campos de resumen personalizados. Los campos de resumen predeterminados dependen de los resultados de la consulta actual y del resumen personalizado. Los campos te permiten seleccionar cualquier campo en LogEntry.

Para ocultar campos de resumen en los resultados de tu consulta, usa las Botón de activación de Campos de resumen. Cuando se habilita este botón, los resultados se muestran en formato de texto sin procesar. De forma predeterminada, el contenido de cada entrada de registro se trunque para que quepa en una línea. Para mostrar hasta 10 líneas por cada entrada de registro, Usa el botón de activación Ajustar líneas. Los espacios en blanco son en cada entrada de registro.

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 Editar en la columna Resumen para abrir el menú de edición.

   

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

   • Agrega cualquier nombre de campo personalizado a Campos de resumen personalizados.

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

     • Completar automáticamente con los registros que se muestran en los resultados de la consulta
     • Corrección de campos para caracteres legales entre comillas

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

     También puedes seleccionar cualquier campo LogEntry, independientemente de si se te sugiere con la función de autocompletar.

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

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

     Para acortar la vista de los valores del campo de resumen, usa el El botón de activación junto al botón Truncar los campos de resumen personalizados Puedes elegir cuántos caracteres mostrar antes de que el campo truncados y si el principio o el final del campo que se muestra.

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

   • Ocultar o mostrar los campos de resumen predeterminados:

     Para personalizar qué campos de resumen predeterminados se muestran en los resultados de las consultas, sigue estos pasos: Expande el menú Ocultar o mostrar los campos de resumen predeterminados.

3. Haz clic en Aplicar.

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

Busca los resultados de tu consulta

Para buscar el contenido de los Resultados de la consulta, haz clic en Buscar en los resultados. en el panel Resultados de la consulta y, luego, ingresa el término de búsqueda. Este filtro te permite encontrar información en tus entradas de registro sin crear una nueva consulta.

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:

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 en 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ó
   • El porcentaje de entradas de registro que contienen el patrón
   • Ejemplos de entradas de registro que contienen el patrón

   En este diálogo, puedes ocultar o mostrar entradas de registro:

   

Ocultar entradas de registro similares

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

Hay dos maneras de ocultar entradas de registro similares:

• Oculta grandes cantidades de entradas de registro agrupadas automáticamente. Cuando ejecutar una consulta, los resultados de la consulta se analizan los patrones y las entradas de registro se agrupan automáticamente según registros el contenido del campo.

  Si se detecta un patrón significativo, aparecerá un banner El panel Resultados de la consulta, en el que se muestra el porcentaje de resultados que se pueden oculto:

  

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

  Vista previa: Se abrirá una ventana separada que describe el patrón encontrado. se muestran ejemplos de las entradas.

  Cuando ocultas registros similares, no se guarda información fuera del sesión del Explorador de registros. Cada consulta produce un nuevo análisis, 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 entradas de registro similares a una específica. Cómo ocultar entradas de registro similar a una entrada de registro, haz lo siguiente:

  1. En la entrada de registro, haz clic en 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. Entradas de registro similares a la entrada de registro seleccionada,

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

Puedes ver u ocultar entradas de registro que coincidan con un campo en una entrada de registro, lo que te permite te enfocas en entradas que contengan el mismo contenido del 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.

   Verás el siguiente menú:

   

3. Selecciona Ocultar entradas coincidentes o Mostrar entradas coincidentes.

   La consulta se actualiza con una que oculta o muestra entradas similares. 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. El elemento fijado entrada de registro permanece centrada en el panel Resultados de la consulta. Si ejecutas una consulta nueva si la entrada de registro fijada no está incluida, se te pedirá que dejes de fijar el registro entrada.

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, su fondo se oscurece Se muestra el ícono de Fijar de . Un ícono de fijar también aparece en el panel Histograma según el ID de la entrada de registro fijada timestamp:

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 las 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 la flecha hacia abajo. junto al registro fijado para expandir el menú de fijar.

2. En el menú de fijar, realiza una selección:

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

     Por ejemplo, supongamos que fijas una entrada de registro con un resource.type de k8s_node Si seleccionas Same resource.type, la consulta será 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 como elemento fijado registro, selecciona Mismo seguimiento.
   • Para borrar la consulta y mostrar todas las entradas de registro, selecciona Mostrar todo.

Visualiza una entrada de registro fijada en el panel Histograma

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

En el panel Histograma, haz clic en Fijar. y elige una de las siguientes opciones del menú:

• Desplazarse hasta la entrada de registro: Coloca la entrada de registro en el lugar actual. Resultados de la consulta y visualiza la entrada de registro fijada en el el contexto de los registros cercanos.
• Zoom a la entrada de registro: Limita el intervalo de tiempo que El panel Histograma muestra y define mejor tu consulta para aislar la cerca del registro fijado.

Visualiza datos de seguimiento

Cuando una entrada de registro contiene trace y el campo relacionado con la latencia, aparecen los íconos de latencia y de seguimiento.

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

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

• Ver detalles de seguimiento: Muestra el intervalo superior y los seguimientos secundarios junto con los detalles sobre el seguimiento. Para ver más detalles sobre el seguimiento, haz clic en Ver en Trace a fin de navegar a Cloud Trace. Para obtener más información sobre el contenido en el panel de detalles, consulta Cómo buscar y explorar seguimientos

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.

Copia un vínculo a una entrada de registro

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

Descargar registros

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 a un bucket de Cloud Storage.

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

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

Para descargar tus registros, haz lo siguiente:

1. Haz clic en Descargar en la barra de herramientas de Panel Resultados de la consulta.

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.
   • Descargar los datos en Google Drive
   • Ve los datos en una pestaña nueva.

   Cuando guardas un archivo CSV y seleccionas Google Drive, puedes abrir el archivo en Google Sheets.

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

Consultas de ejemplo

Para ver consultas sugeridas, organizadas por producto y caso de uso de Google Cloud, visita Consultas de muestra con el Explorador de registros. Por ejemplo, puedes ejecutar operaciones relacionadas con Kubernetes consultas para encontrar 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 subtexto en en varios lugares del Explorador de registros. Por ejemplo, para gce_instance tipo de recurso, verás el nombre de la VM junto con su ID. Los nombres de recursos ayudan a identificar el ID de recurso correcto, sobre el que se pueden crear consultas.

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

• Menús de filtro del panel Consulta: Compute Engine tipos de recursos muestran los nombres de los recursos, con sus IDs de recurso correspondientes, como subtexto.
• Campos de registro: Tipos de recursos de Compute Engine muestra el nombre del recurso, en lugar del ID del recurso, en las dimensiones del campo.
• Resultados de la consulta: Para los registros de instancias de VM de Compute Engine, la El campo resource.labels muestra los metadatos con el nombre del recurso correspondiente.
• Campos de resumen: Para la instancia de VM de Compute Engine registros, 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.

Falla la descarga de registros

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 Prueba lo siguiente:

• En el diálogo Descargar registros, reduce el valor de Cantidad máxima de entradas de registro.
• Reduce el período durante el cual se consultan los registros.
• En la barra de herramientas de los resultados de la consulta, haz clic en Ocultar entradas similares antes de comenzar la descarga.

• Modifica tu consulta para usar campos indexados.

Nota: La función de descarga no está diseñada para la descarga masiva de registros. Tú que pueden copiar registros a un bucket de Cloud Storage.

No se pueden encontrar registros de la consola de una instancia de VM

Es posible que los registros escritos en la consola de una instancia de Compute Engine no estén disponibles en el Explorador de registros. Para ver estos registros, haz lo siguiente:

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 las instancias para que la salida del puerto en serie sea enviados a Cloud Logging. Para obtener más información, consulta Habilita o inhabilita el registro de salidas de puertos en serie.

Obtener el ID de la organización o del proyecto de Google Cloud

Para obtener un ID de organización o proyecto de Google Cloud desde cualquier parte del consola de Google Cloud, expande la lista de proyectos de Google Cloud desde el selector de proyectos y organizaciones de Google Cloud y busca 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 se generan los registros y que no hay es la actividad en esos recursos. Incluso si el proyecto de Google Cloud está nuevo, debería tener registros de auditoría que registren su creación. Para obtener información sobre cómo verificar que Si usas un recurso que genera registros, consulta Asigna servicios a tipos de recursos.

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

• 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 Vistas de registro a las que se hace referencia mediante la configuración del menú Definir 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 era demasiado grande y no se pudo completar con una cantidad razonable de tiempo. Es posible que veas esto como “un plazo vencido antes de que la operación se pueda completar”. Trata de hacer que tu consulta sea más específica o reducir el intervalo de tiempo.

La consulta muestra un error

Si realizas una consulta sobre un recurso sin especificar un bucket, Cloud Logging usa el historial de los receptores en el proyecto de Google Cloud para determinar dónde se podrían haber escrito entradas para ese recurso. Si Cloud Logging identifica más de 200 buckets en los que las entradas se haya escrito, la consulta falla y muestra el mensaje Error: Invalid query

A fin de resolver este problema, define mejor el alcance de tu consulta en un subconjunto del almacenamiento. Para obtener más información, consulta Define mejor el permiso.

El intervalo de tiempo de los resultados de la consulta no coincide con la consulta

Los datos de registros que ves en los paneles Resultados de la consulta y Campos de registro se ajustan según el intervalo de tiempo capturado por la línea de tiempo del histograma. Ajustas el de la línea de tiempo del histograma con los controles de tiempo del histograma 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 está inhabilitado. 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.