Consulta y analiza registros con Estadísticas de observabilidad

En este documento, se describe cómo consultar y analizar los datos de tus registros con Estadísticas de observabilidad, que proporciona una interfaz de consultas basada en SQL. Con SQL, puedes realizar tareas como contar las entradas de registro con un campo que coincida con un patrón. Estadísticas de observabilidad proporciona un editor de SQL y un sistema basado en menús para compilar consultas. Para ver los resultados de la consulta, puedes usar el formato tabular o visualizar los datos como un gráfico. Puedes guardar los gráficos en tus paneles personalizados.

Puedes consultar una vista de registro en un bucket de registros o una vista de estadísticas. Cuando consultas una vista de registro, el esquema corresponde al de la LogEntry estructura de datos. Debido a que el creador de una vista de estadísticas determina el esquema, un caso de uso para las vistas de estadísticas es transformar los datos de registro del formato LogEntry a un formato que sea más adecuado para ti.

También puedes usar Estadísticas de observabilidad para consultar tus datos de seguimiento. Para obtener más información, consulta Consulta y analiza seguimientos.

Estadísticas de observabilidad no anula la duplicación de las entradas de registro, lo que podría afectar la forma en que escribes tus consultas. Además, existen algunas restricciones cuando se usa Estadísticas de observabilidad. Para obtener más información sobre estos temas, consulta los siguientes documentos:

Acerca de los conjuntos de datos vinculados

No necesitas un conjunto de datos de BigQuery vinculado cuando deseas consultar los datos de tus registros o los datos de tus registros y seguimientos. Para esas situaciones, puedes usar la página Estadísticas de observabilidad. También puedes guardar y compartir tus consultas, y puedes guardar la consulta en un panel personalizado. Para obtener información sobre cómo consultar tus datos de seguimiento, consulta Consulta y analiza seguimientos.

Necesitas un conjunto de datos de BigQuery vinculado cuando deseas realizar cualquiera de las siguientes acciones:

Si eliges crear un conjunto de datos vinculado en un bucket de registros, expandes el límite de seguridad de tus datos de registro para incluir los servicios de BigQuery. Es decir, los servicios de BigQuery ahora pueden consultar tus datos de registro si emiten una consulta al conjunto de datos vinculado. Antes de crear un conjunto de datos vinculado, te recomendamos que revises Seguridad de los datos con Estadísticas de observabilidad.

Antes de comenzar

En esta sección, se describen los pasos que debes completar antes de poder usar Estadísticas de observabilidad.

Configura buckets de registros

Asegúrate de que tus buckets de registros se hayan actualizado para usar Estadísticas de observabilidad:

  1. En la Google Cloud consola de, ve a la página Almacenamiento de registros:

    Ir al Almacenamiento de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Para cada bucket de registros que tenga una vista de registro que deseas consultar, asegúrate de que la columna Estadísticas de observabilidad disponibles muestre Abrir. Si se muestra Actualizar, haz clic en Actualizar y completa el diálogo.

Configura roles y permisos de IAM

En esta sección, se describen los roles o permisos de IAM que se requieren para usar Estadísticas de observabilidad:

  • Para obtener los permisos que necesitas para usar Estadísticas de observabilidad y consultar vistas de registro, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

    Puedes restringir una principal a una vista de registro específica agregando una condición de IAM al otorgamiento del rol Descriptor de acceso de vista de registros que se realiza a nivel del proyecto o agregando una vinculación de IAM al archivo de política de la vista de registro. Para obtener más información, consulta Controla el acceso a una vista de registros.

    Estos son los mismos permisos que necesitas para ver las entradas de registro en la página Explorador de registros. Para obtener información sobre roles adicionales que necesitas para consultar vistas en buckets definidos por el usuario o para consultar la vista _AllLogs del _Default bucket de registros, consulta Roles de Cloud Logging.

  • Para obtener los permisos que necesitas para consultar vistas de estadísticas, pídele a tu administrador que te otorgue el rol de IAM Usuario de Estadísticas de observabilidad (roles/observability.analyticsUser) en tu proyecto.

Datos de registro de consultas

En esta sección, se describen los enfoques que puedes usar para consultar tus datos de registro:

  • Carga una consulta definida por el sistema, edítala y, luego, ejecútala.
  • Ingresa y ejecuta una consulta personalizada. Por ejemplo, puedes pegar una consulta que tengas o escribir una. Las consultas personalizadas pueden incluir uniones, consultas anidadas y otras instrucciones de SQL complejas. Para ver ejemplos, consulta Consultas de SQL de muestra.
  • Compila una consulta haciendo selecciones de menú y, luego, ejecuta esa consulta. Estadísticas de observabilidad convierte tus selecciones en una consulta en SQL, que puedes ver y editar.

Carga, edita y ejecuta la consulta definida por el sistema

  1. En la Google Cloud consola de, ve a la página Análisis de registros:

    Ir a Análisis de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En el menú Vistas, ve al Registros o a la Vistas de estadísticas y selecciona la vista que deseas consultar.

    Para encontrar la vista que deseas consultar, usa la barra Filtro o desplázate por la lista:

    • Las vistas de registro se enumeran por BUCKET_ID.LOG_VIEW_ID, en las que estos campos hacen referencia a los IDs del bucket de registros y la vista de registro.

    • Las vistas de estadísticas se enumeran por LOCATION.ANALYTICS_VIEW_ID, donde estos campos hacen referencia a la ubicación y el ID de una vista de estadísticas. Las vistas de estadísticas están en versión preliminar pública.

  3. Realiza una de las siguientes acciones:

    • Para cargar una consulta definida por el sistema que se basa en el Compilador de consultas, que te permite definir la consulta con selecciones de menú, asegúrate de que el panel Consulta muestre Compilador de consultas. Si se muestra un editor de SQL, entonces haz clic en  Compilador.

    • Para cargar una consulta definida por el sistema que extrae valores JSON, asegúrate de que el panel Consulta muestre el editor de SQL. Si este panel muestra Compilador de consultas, haz clic en  SQL.

  4. En el panel Esquema, selecciona Consulta y, luego, haz clic en Reemplazar.

    El panel Consulta muestra una consulta definida por el sistema. Si seleccionaste el Compilador de consultas pero deseas ver la consulta en SQL, haz clic en  SQL.

  5. Opcional: Modifica la consulta.

  6. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Estadísticas de observabilidad presenta los resultados de la consulta en una tabla. Sin embargo, puedes crear un gráfico y también puedes guardar la tabla o el gráfico en un panel personalizado. Para obtener más información, consulta Resultados de consulta en SQL gráficos.

    Si la barra de herramientas muestra Ejecutar en BigQuery, debes cambiar Estadísticas de observabilidad para usar el motor de consultas predeterminado. Para realizar este cambio, en la barra de herramientas del panel Consulta, haz clic en Configuración y, luego, selecciona Estadísticas (predeterminado).

Ingresa y ejecuta una consulta personalizada

Para ingresar una consulta en SQL, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Análisis de registros:

    Ir a Análisis de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En el panel Consulta, haz clic en  SQL.

    • Para especificar un período, te recomendamos que uses el selector de períodos. Si agregas una cláusula WHERE que especifica el campo timestamp, ese valor anula la configuración en el selector de períodos y ese selector se inhabilita.

    • Para ver ejemplos, consulta Consultas de SQL de muestra.

    • Puedes consultar vistas de registro o vistas de estadísticas. Usa el siguiente formato para la cláusula FROM:

      • Vistas de registro:

        FROM `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`

      • Vistas de estadísticas:

        FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

      Los campos de las expresiones anteriores tienen el siguiente significado:

      • PROJECT_ID: Es el identificador del proyecto.
      • LOCATION: Es la ubicación de la vista de registro o la vista de estadísticas.
      • BUCKET_ID: Es el nombre o el ID del bucket de registros.
      • LOG_VIEW_ID: Es el identificador de la vista de registro, que está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.
      • ANALYTICS_VIEW_ID: Es el ID de la vista de estadísticas, que está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

      Si el panel de consultas muestra un mensaje de error que hace referencia a la instrucción FROM, no se puede encontrar la vista. Para obtener información sobre cómo resolver esta falla, consulta Error FROM cláusula debe contener exactamente una vista de registro.

  3. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Estadísticas de observabilidad presenta los resultados de la consulta en una tabla. Sin embargo, puedes crear un gráfico y también puedes guardar la tabla o el gráfico en un panel personalizado. Para obtener más información, consulta Resultados de consulta en SQL gráficos.

    Si la barra de herramientas muestra Ejecutar en BigQuery, debes cambiar Estadísticas de observabilidad para usar el motor de consultas predeterminado. Para realizar este cambio, en la barra de herramientas del panel Consulta, haz clic en Configuración y, luego, selecciona Estadísticas (predeterminado).

Compila, edita y ejecuta una consulta

La interfaz del Compilador de consultas te permite compilar una consulta haciendo selecciones de los menús. Estadísticas de observabilidad convierte tus selecciones en una consulta en SQL, que puedes ver y editar. Por ejemplo, puedes comenzar usando la interfaz del Compilador de consultas y, luego, cambiar al editor de SQL para refinar tu consulta.

Estadísticas de observabilidad siempre puede convertir tus selecciones de menú de la interfaz del Compilador de consultas en una consulta en SQL. Sin embargo, no todas las consultas en SQL pueden representarse con la interfaz del Compilador de consultas. Por ejemplo, las consultas con uniones no pueden representarse con esta interfaz.

Para compilar una consulta, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Análisis de registros:

    Ir a Análisis de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Si el panel Consulta muestra un editor de SQL, selecciona Compilador, que abre el panel Compilador de consultas.

  3. Usa el menú Fuente para seleccionar la vista que deseas consultar. Tus selecciones se asignan a la cláusula FROM en la consulta en SQL.

  4. Opcional: Usa los siguientes menús para restringir o dar formato a la tabla de resultados:

    • Buscar en todos los campos: Busca cadenas coincidentes. Tus selecciones se asignan a la cláusula WHERE en la consulta en SQL.

    • Columnas: Selecciona las columnas que aparecen en la tabla de resultados. Tus selecciones se asignan a las cláusulas SELECT en la consulta en SQL.

      Cuando seleccionas un nombre de campo en este menú, se abre un diálogo. En este diálogo, puedes hacer lo siguiente:

      • Usa el menú para agregar o agrupar tus datos.

        Para evitar errores de sintaxis, cualquier agregación y agrupamiento que apliques a una columna se aplica automáticamente a otras columnas. Para ver un ejemplo de cómo agregar y agrupar entradas, consulta Agrega y agrupa datos con el Compilador de consultas.

      • Convierte un valor de cualquier tipo en otro tipo de datos especificado. Para obtener más información, consulta la CAST documentación.

      • Extrae una subcadena de valores con expresiones regulares. Para obtener más información, consulta la REGEXP_EXTRACT documentación.

    • Filtros: Agrega filtros cuando desees restringir la consulta a intervalos que contengan un atributo o ID de intervalo específico. En el menú, se enumeran todas las opciones de filtro disponibles. Tus selecciones se asignan a la cláusula WHERE en la consulta en SQL.

    • Ordenar por: Establece las columnas por las que se ordenará y si el orden es ascendente o descendente. Tus selecciones se asignan a la cláusula ORDER BY en la consulta en SQL.

    • Límite: Establece la cantidad máxima de filas en la tabla de resultados. Tus selecciones se asignan a la cláusula LIMIT en la consulta en SQL.

  5. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Estadísticas de observabilidad presenta los resultados de la consulta en una tabla. Sin embargo, puedes crear un gráfico y también puedes guardar la tabla o el gráfico en un panel personalizado. Para obtener más información, consulta Resultados de consulta en SQL gráficos.

    Si la barra de herramientas muestra Ejecutar en BigQuery, debes cambiar Estadísticas de observabilidad para usar el motor de consultas predeterminado. Para realizar este cambio, en la barra de herramientas del panel Consulta, haz clic en Configuración y, luego, selecciona Estadísticas (predeterminado).

Ejemplo: Agrega y agrupa datos con el Compilador de consultas

Cuando seleccionas una columna en el Compilador de consultas, cada campo incluye un menú en el que puedes agregar agrupamiento y agregación. El agrupamiento te permite organizar tus datos en grupos según el valor de una o más columnas, y la agregación te permite realizar cálculos en estos grupos para mostrar un solo valor.

Cada campo que selecciones en el elemento Columnas tiene un menú adjunto con las siguientes opciones:

  • Ninguno: No agrupes ni agregues por este campo.
  • Agregar: Agrupa los campos que aparecen en el elemento Columnas, excepto cuando el campo tiene una selección Agregar. Para esos campos, calcula el valor realizando una operación en todas las entradas de cada agrupamiento. La operación podría ser calcular el promedio de un campo o hacer algo como contar la cantidad de entradas en cada agrupamiento.
  • Agrupar por: Agrupa las entradas por todos los campos que aparecen en el elemento Columnas.

En el siguiente ejemplo, se muestra cómo puedes construir una consulta que agrupa entradas y, luego, realiza algún tipo de agregación.

En este ejemplo, se describe cómo usar el Compilador de consultas para agrupar entradas de registro por gravedad y marca de tiempo, y, luego, calcular el promedio del campo http_request.response_size para cada grupo.

Para compilar una consulta que agrupe y agregue tus datos, realiza las siguientes selecciones en los menús del Compilador de consultas:

  1. En el menú Columnas , selecciona los campos timestamp, severity y http_request.response_size.

    1. Para agrupar tus datos, haz clic en el campo timestamp para abrir el diálogo de configuración. En este diálogo, selecciona la opción Agrupar por y establece la Granularidad de truncamiento en HOUR. Luego, el agrupamiento se aplica automáticamente a todos los demás campos para evitar errores de sintaxis. Si hay campos no válidos en los que no se puede aplicar el agrupamiento, verás un mensaje de error. Quita los campos no válidos del menú para resolver este error.

    2. Para realizar la agregación en el campo http_request.response_size, haz clic en el campo para abrir el diálogo de configuración. En este diálogo, selecciona Agregar. En el menú Agregación, haz clic en Promedio.

  2. En el menú Filtros, agrega http_request.response_size y establece el comparador en IS NOT NULL. Este filtro coincide con las entradas de registro que contienen un valor response_size.

    Los menús del Compilador de consultas se ven similares a los siguientes:

    Agrega y agrupa datos con los menús del compilador de consultas.

  3. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Los resultados de esta consulta son similares a los siguientes:

    +-----------------------------------+----------+---------------+
| Row | hour_timestamp              | severity | response_size |
|     | TIMESTAMP                   | STRING   | INTEGER       |
+-----+-----------------------------+----------+---------------+
| 1   | 2025-10-06 16:00:00.000 UTC | NOTICE   | 3082          |
| 2   | 2025-10-06 17:00:00.000 UTC | WARNING  | 338           |
| 3   | 2025-10-06 16:00:00.000 UTC | INFO     | 149           |

La consulta en SQL correspondiente al ejemplo anterior es la siguiente:

SELECT
  -- Truncate the timestamp by hour.
  TIMESTAMP_TRUNC( timestamp, HOUR ) AS hour_timestamp,
  severity,
  -- Compute average response_size.
  AVG( http_request.response_size ) AS average_http_request_response_size
FROM
  `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
WHERE
  -- Matches log entries that have a response_size.
  http_request.response_size IS NOT NULL
GROUP BY
  -- Group log entries by timestamp and severity.
  TIMESTAMP_TRUNC( timestamp, HOUR ),
  severity
LIMIT
  1000

Muestra el esquema

El esquema define cómo se almacenan los datos, lo que incluye los campos y sus tipos de datos. Esta información es importante para ti porque el esquema determina los campos que consultas y si necesitas convertir campos a diferentes tipos de datos. Por ejemplo, para escribir una consulta que calcule la latencia promedio de las solicitudes HTTP , debes saber cómo acceder al campo de latencia y si se almacena como un número entero, como 100, o como una cadena, como "100". Si los datos de latencia se almacenan como una cadena, la consulta debe convertir el valor a un valor numérico antes de calcular un promedio.

Para identificar el esquema, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Análisis de registros:

    Ir a Análisis de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En el menú Vistas, ve al Registros o a la Vistas de estadísticas y selecciona la vista que deseas consultar.

    Se actualiza el panel Esquema. Estadísticas de observabilidad infiere automáticamente los campos de una columna cuando el tipo de datos es JSON. Para ver con qué frecuencia aparecen estos campos inferidos en tus datos, haz clic en Opciones y selecciona Ver información y descripción.

    Para las vistas de registro, el esquema es fijo y corresponde a la LogEntry. Para las vistas de estadísticas, puedes modificar la consulta en SQL para cambiar el esquema.

¿Qué sigue?