Consulta y visualiza entradas de registro

En este documento, se describe cómo consultar, ver y analizar entradas de registro con la consola de Google Cloud . Tienes a tu disposición dos interfaces: el Explorador de registros y las estadísticas de registros. Puedes consultar, ver y analizar registros con ambas interfaces. Sin embargo, usan diferentes lenguajes de consulta y tienen diferentes capacidades. Para solucionar problemas y explorar datos de registros, recomendamos usar el Explorador de registros. Para generar estadísticas y tendencias, te recomendamos que uses Log Analytics. Puedes consultar tus registros y guardar tus consultas con comandos de la API de Logging. También puedes consultar tus registros con Google Cloud CLI.

Explorador de registros

El Explorador de registros está diseñado para ayudarte a solucionar problemas y analizar el rendimiento de tus servicios y aplicaciones. Por ejemplo, un histograma muestra la tasa de errores. Si ves un aumento repentino de errores o algo interesante, puedes ubicar y ver las entradas de registro correspondientes. Cuando una entrada de registro se asocia con un grupo de errores, se anota con un menú de opciones que te permite acceder a más información sobre el grupo de errores.

La API de Cloud Logging, Google Cloud CLI y el Explorador de registros admiten el mismo lenguaje de consultas. Para simplificar la creación de consultas cuando usas el Explorador de registros, puedes compilar consultas con menús, ingresando texto y, en algunos casos, usando opciones incluidas en la visualización de una entrada de registro individual.

El Explorador de registros no admite operaciones de agregación, como contar la cantidad de entradas de registro que contienen un patrón específico. Para realizar operaciones de agregación, habilita el análisis en el bucket de registros y, luego, usa el Análisis de registros.

Para obtener detalles sobre cómo buscar y ver registros con el Explorador de registros, consulta Visualiza registros con el Explorador de registros.

Análisis de registros

Con el Análisis de registros, puedes ejecutar consultas que analicen tus datos de registros y, luego, puedes ver o graficar los resultados de las consultas. Los gráficos te permiten identificar patrones y tendencias en tus registros a lo largo del tiempo. En la siguiente captura de pantalla, se ilustran las capacidades de creación de gráficos en Log Analytics:

Interfaz de usuario para las estadísticas de registros.

Por ejemplo, supongamos que estás solucionando un problema y deseas conocer la latencia promedio de las solicitudes HTTP que se envían a una URL específica a lo largo del tiempo. Cuando se actualiza un bucket de registros para usar el Análisis de registros, puedes escribir una consulta en SQL o usar el compilador de consultas para consultar los registros almacenados en tu bucket de registros.

Estas consultas SQL también pueden incluir la sintaxis de canalización. Si agrupas y agregas tus registros, puedes obtener estadísticas sobre tus datos de registro que te ayudarán a reducir el tiempo dedicado a solucionar problemas.

El Análisis de registros te permite consultar vistas de registros o una vista de Analytics. Las vistas de registro tienen un esquema fijo que corresponde a la estructura de datos de LogEntry. Dado que el creador de una vista de Analytics determina el esquema, un caso de uso de las vistas de Analytics es transformar los datos de registro del formato LogEntry en un formato más adecuado para ti.

También puedes usar BigQuery para consultar tus datos. Por ejemplo, supongamos que deseas usar BigQuery para comparar las URLs de tus registros con un conjunto de datos públicos de URLs maliciosas conocidas. Para que tus datos de registro sean visibles en BigQuery, actualiza tu bucket para usar el Análisis de registros y, luego, crea un conjunto de datos vinculado.

Puedes seguir solucionando problemas y ver entradas de registro individuales en los buckets de registros actualizados con el Explorador de registros.

Restricciones

  • Para actualizar un bucket de registros existente y usar el Análisis de registros, se aplican las siguientes restricciones:

    • El bucket de registros se creó a nivel del proyecto Google Cloud .
    • El bucket de registros está desbloqueado, a menos que sea el bucket _Required.
    • No hay actualizaciones pendientes en el bucket.

  • Las entradas de registro escritas antes de que se actualice un bucket no están disponibles de inmediato. Sin embargo, cuando se complete la operación de carga retroactiva, podrás analizar estas entradas de registro. El proceso de carga de datos históricos puede tardar varias horas.

  • No puedes usar la página Análisis de registros para consultar vistas de registros cuando el bucket de registros tiene configurados controles de acceso a nivel del campo. Sin embargo, puedes emitir consultas a través de la página del Explorador de registros y consultar un conjunto de datos de BigQuery vinculado. Dado que BigQuery no respeta los controles de acceso a nivel de campo, si consultas un conjunto de datos vinculado, puedes consultar todos los campos de las entradas de registro.

  • Si consultas varios buckets de registros configurados con diferentes claves de Cloud KMS, la consulta fallará, a menos que se cumplan las siguientes restricciones:

    • Los buckets de registros se encuentran en la misma ubicación.
    • Una carpeta o una organización que es un recurso principal de los buckets de registros está configurada con una clave predeterminada.
    • La clave predeterminada se encuentra en la misma ubicación que los buckets de registros.

    Cuando se cumplen las restricciones anteriores, la clave de Cloud KMS de la organización superior encripta los datos temporales que genera una consulta de Log Analytics.

  • Las entradas de registro duplicadas no se quitan antes de que se ejecute una búsqueda. Este comportamiento es diferente al que se produce cuando consultas entradas de registro con el Explorador de registros, que quita las entradas duplicadas comparando los nombres de registro, las marcas de tiempo y los campos de ID de inserción. Para obtener más información, consulta Solución de problemas: Hay entradas de registro duplicadas en mis resultados de Log Analytics.

Precios

Cloud Logging no cobra por enrutar registros a un destino compatible; sin embargo, es posible que el destino aplique cargos. Con la excepción del bucket de registros _Required, Cloud Logging cobra por transmitir registros a los buckets de registros y por el almacenamiento que supere el período de retención predeterminado del bucket de registros.

Cloud Logging no cobra por copiar registros, crear alcances de registros o vistas de análisis, ni por las consultas que se emiten a través de las páginas del Explorador de registros o del Análisis de registros.

Para obtener más información, consulta los siguientes documentos:

No hay costos de almacenamiento ni de transferencia de datos a BigQuery cuando actualizas un bucket para usar el Análisis de registros y, luego, creas un conjunto de datos vinculado. Cuando creas un conjunto de datos vinculado para un bucket de registros, no transfieres tus datos de registros a BigQuery. En cambio, obtienes acceso de lectura a los datos de registro almacenados en tu bucket de registros a través del conjunto de datos vinculado.

Se aplican cargos de análisis de BigQuery cuando ejecutas consultas de SQL en conjuntos de datos vinculados de BigQuery, lo que incluye el uso de la página de BigQuery Studio, la API de BigQuery y la herramienta de línea de comandos de BigQuery.

Blogs

Para obtener más información sobre el Análisis de registros, consulta las siguientes entradas de blog:

¿Qué sigue?