En este documento, se describe cómo consultar, ver y analizar entradas de registro con la Google Cloud consola. Tienes dos interfaces disponibles: el Explorador de registros y Estadísticas de observabilidad. 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 registro, usa el Explorador de registros.
Para unir tus datos de registro y seguimiento, o para generar estadísticas y tendencias, usa Estadísticas de observabilidad.
Puedes consultar tus registros y guardar tus consultas con la emisión de comandos de la API de Logging. También puedes consultar tus registros con Google Cloud CLI.
Usa el 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 en los errores o algo interesante, puedes ubicar y ver las entradas de registro correspondientes. Cuando una entrada de registro está asociada con un grupo de errores, la entrada de registro 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 consulta. Para simplificar la construcción de consultas cuando usas el Explorador de registros, puedes compilar consultas con menús, ingresar texto y, en algunos casos, usar opciones incluidas en la visualización de una entrada de registro individual.
El Explorador de registros no admite operaciones agregadas, como contar la cantidad de entradas de registro que contienen un patrón específico. Para realizar operaciones agregadas, habilita el análisis en el bucket de registros y, luego, usa Estadísticas de observabilidad.
Para obtener detalles sobre cómo buscar y ver registros con el Explorador de registros, consulta Visualiza registros con el Explorador de registros.
Explora Estadísticas de observabilidad
Con Estadísticas de observabilidad, puedes generar estadísticas mediante la ejecución de consultas que agrupan y agregan tus datos de registro. Estas estadísticas pueden ayudarte a reducir el tiempo que dedicas a solucionar problemas. Para ver los resultados de la consulta, usa una tabla, un gráfico o ambos. Los gráficos pueden ayudarte a identificar patrones y tendencias en tus datos de registro. Por ejemplo, en la siguiente captura de pantalla, se muestra un resultado de la consulta que se muestra como una tabla y un gráfico:
Estadísticas de observabilidad admite lo siguiente:
Agrupar y agregar datos de registro
Por ejemplo, puedes ejecutar una consulta de SQL que agrupe las entradas de registro por hora y, luego, calcule, para cada grupo, la latencia promedio de las solicitudes HTTP emitidas a una URL específica.
Consultas de SQL que usan sintaxis de canalización.
Consultas de vistas de registros y vistas de análisis.
Las vistas de registros tienen un esquema definido por el sistema. Tú defines el esquema para las vistas de análisis.
Uniones de datos de registro y seguimiento
Para obtener información sobre cómo consultar tus datos de seguimiento, consulta Consulta y analiza seguimientos.
Cloud Logging también te permite consultar tus datos de registro desde BigQuery, sin exportar esos datos a BigQuery. Después de actualizar tu bucket de registros para usar Estadísticas de observabilidad, crea un conjunto de datos de BigQuery vinculado. Puedes consultar el conjunto de datos de BigQuery vinculado con los servicios de BigQuery.
La actualización de un bucket de registros no afecta el uso del Explorador de registros. El Explorador de registros solo requiere que tus datos de registro se almacenen en un bucket de registros.
Restricciones
Para actualizar un bucket de registros existente para usar Estadísticas de observabilidad, se aplican las siguientes restricciones:
- El bucket de registros se creó en el Google Cloud nivel de proyecto.
- El bucket de registros está desbloqueado, a menos que sea el
_Requiredbucket. - No hay actualizaciones pendientes para el bucket.
Las entradas de registro escritas antes de que se actualice un bucket no están disponibles de inmediato. Sin embargo, cuando se completa la operación de relleno, puedes analizar estas entradas de registro. El proceso de relleno puede tardar varios días.
No puedes usar la página Estadísticas de observabilidad para consultar vistas de registros cuando el bucket de registros tiene controles de acceso a nivel de campo configurados. Sin embargo, puedes emitir consultas a través de la página Explorador de registros y puedes consultar un conjunto de datos de BigQuery vinculado. Como BigQuery no respeta los controles de acceso a nivel de campo, si consultas un conjunto de datos de BigQuery vinculado, puedes consultar todos los campos de las entradas de registro.
Las entradas de registro duplicadas no se quitan antes de que se ejecute una consulta. Este comportamiento es diferente de 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 Estadísticas de observabilidad.
Restricciones en las uniones
Para unir vistas, se aplican las siguientes restricciones:
-
Las ubicaciones de las vistas satisfacen una de las siguientes condiciones:
- Todas las vistas tienen la misma ubicación.
- Todas las vistas están en la ubicación
globalous.
-
Cuando los recursos de almacenamiento usan claves de encriptación administradas por el cliente (CMEK), se cumple una de las siguientes condiciones:
- Los recursos de almacenamiento que usan CMEK usan la misma clave de Cloud KMS.
- Los recursos de almacenamiento que usan CMEK tienen un principal común, y ese principal especifica una clave de Cloud KMS predeterminada que se encuentra en la misma ubicación que los recursos de almacenamiento.
Cuando uno o más recursos de almacenamiento usan CMEK, el sistema encripta los datos temporales generados por la unión con la clave de Cloud KMS común o la clave de Cloud KMS predeterminada del ancestro.
Por ejemplo, supongamos que tienes dos vistas que residen en la misma ubicación. Luego, puedes unir estas vistas cuando se cumpla alguna de las siguientes condiciones:
- Los recursos de almacenamiento no usan CMEK.
- Un recurso de almacenamiento usa CMEK y el otro no.
- Ambos recursos de almacenamiento usan CMEK y ambos usan la misma clave de Cloud KMS.
Ambos recursos de almacenamiento usan CMEK, pero usan claves diferentes. Sin embargo, los recursos comparten un principal que especifica una clave de Cloud KMS predeterminada que se encuentra en la misma ubicación que los recursos de almacenamiento.
Por ejemplo, supongamos que la jerarquía de recursos para un bucket de registros y un bucket de observabilidad incluye la misma organización. Puedes unir vistas en esos buckets cuando, para esa organización, hayas configurado los parámetros de configuración de recursos predeterminados para Cloud Logging y para los buckets de observabilidad con la misma clave de Cloud KMS predeterminada para la ubicación de almacenamiento.
Precios
Para obtener información sobre los precios, consulta la página de precios de Google Cloud Observability. Si enrutas datos de registro a otros Google Cloud servicios, consulta los siguientes documentos:
No hay costos de almacenamiento ni de ingesta de BigQuery cuando actualizas un bucket para usar Estadísticas de observabilidad y, luego, creas un conjunto de datos de BigQuery vinculado. Cuando creas un conjunto de datos de BigQuery vinculado para un bucket de registros, no ingresas tus datos de registro en 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 de BigQuery vinculado.
Se aplican cargos de análisis de BigQuery cuando ejecutas consultas de SQL en conjuntos de datos de BigQuery vinculados a BigQuery, lo que incluye el uso de la página BigQuery Studio , la API de BigQuery y la herramienta de línea de comandos de BigQuery.
Blogs
Para obtener más información sobre Estadísticas de observabilidad, consulta las siguientes entradas de blog:
- Para obtener una descripción general de Estadísticas de observabilidad, consulta Estadísticas de observabilidad en Cloud Logging ahora tiene disponibilidad general.
- Para obtener información sobre cómo crear gráficos generados por consultas de Estadísticas de observabilidad y guardar esos gráficos en paneles personalizados, consulta Anuncio de gráficos y paneles de Estadísticas de observabilidad en Cloud Logging en versión preliminar pública.
- Para obtener información sobre cómo analizar registros de auditoría con Estadísticas de observabilidad, consulta Genera estadísticas de seguridad a partir de registros de auditoría con Estadísticas de observabilidad.
- Si enrutas registros a BigQuery y quieres comprender la diferencia entre esa solución y el uso de Estadísticas de observabilidad, consulta Migra a Estadísticas de observabilidad para usuarios de BigQuery Export.
¿Qué sigue?
- Crea un bucket de registros y actualízalo para usar Estadísticas de observabilidad.
- Actualiza un bucket existente para usar Estadísticas de observabilidad.
Consulta y visualiza registros:
Ejemplos de búsquedas: