Consulta y analiza registros con Estadísticas de observabilidad

En este documento, se describe cómo consultar y analizar tus datos de registro con las Estadísticas de observabilidad, que proporcionan una interfaz de consulta 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 tu consulta, puedes usar el formato tabular o visualizar los datos como un gráfico. Puedes guardar tus gráficos en tus paneles personalizados.

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

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

Las Estadísticas de observabilidad no anulan 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 usan las estadísticas de observabilidad. Para obtener más información sobre estos temas, consulta los siguientes documentos:

Acerca de los conjuntos de datos de BigQuery vinculados

No necesitas un conjunto de datos de BigQuery vinculado cuando quieres consultar tus datos de registro o tus datos de registro y seguimiento. En esos casos, 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 quieras realizar cualquiera de las siguientes acciones:

Si eliges crear un conjunto de datos de BigQuery 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 emitiendo una consulta al conjunto de datos de BigQuery vinculado. Antes de crear un conjunto de datos de BigQuery 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 las 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 consola de Google Cloud , ve a la página Explorador 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 quieras 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 las Estadísticas de observabilidad:

  • Para obtener los permisos que necesitas para usar las Estadísticas de observabilidad y consultar las vistas de registros, 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 de descriptor de acceso a la vista de registros realizado 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 los roles adicionales que necesitas para consultar vistas en buckets definidos por el usuario o para consultar la vista _AllLogs del bucket de registros _Default, consulta Roles de Cloud Logging.

  • Para obtener los permisos que necesitas para consultar vistas de análisis, pídele a tu administrador que te otorgue el rol de IAM de 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.
  • Ingresar y ejecutar una consulta personalizada Por ejemplo, puedes pegar una consulta que tengas o escribir una. Las consultas personalizadas pueden incluir uniones, consultas anidadas y otras sentencias de SQL complejas. Para ver ejemplos, consulta Consultas en SQL de muestra.
  • Crea una consulta seleccionando opciones del menú y, luego, ejecútala. Las Estadísticas de observabilidad convierten 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, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

    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 a la sección Registros o Vistas de análisis 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, donde estos campos hacen referencia a los IDs del bucket de registros y de la vista de registro.
    • Las vistas de Analytics se enumeran por LOCATION.ANALYTICS_VIEW_ID, donde estos campos se refieren a la ubicación y el ID de una vista de Analytics. Las vistas de análisis se encuentran en versión preliminar pública.

  3. Realiza una de las siguientes acciones:

    • Para cargar una consulta definida por el sistema que se base 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, haz clic en  Creador.

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

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

    En el panel Consulta, se muestra una consulta definida por el sistema. Si seleccionaste el modo Compilador de consultas, pero quieres 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.

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

    Si en la barra de herramientas se muestra Ejecutar en BigQuery, debes cambiar las 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 Analytics (predeterminado).

Ingresa y ejecuta una consulta personalizada

Para ingresar una consulta en SQL, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

    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íodo. Si agregas una cláusula WHERE que especifique el campo timestamp, ese valor anulará el parámetro de configuración en el selector de período y ese selector se inhabilitará.

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

    • Puedes consultar vistas de registros o vistas de análisis. Usa el siguiente formato para la cláusula FROM:

      • Vistas de registro: 
        FROM `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
      • Vistas de Analytics: 
        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 de análisis.
      • 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 análisis, que está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

      Si en el panel de consultas se 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 este error, consulta La cláusula FROM de FROM debe contener exactamente una vista de registro.

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

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

    Si en la barra de herramientas se muestra Ejecutar en BigQuery, debes cambiar las 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 Analytics (predeterminado).

Crea, edita y ejecuta una consulta

La interfaz del Compilador de consultas te permite crear una consulta seleccionando opciones de los menús. Las Estadísticas de observabilidad convierten tus selecciones en una consulta en SQL, que puedes ver y editar. Por ejemplo, puedes comenzar con la interfaz del Compilador de consultas y, luego, cambiar al editor de SQL para definir mejor tu consulta.

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

Para crear una consulta, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

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

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

  3. Usa el menú Fuente para seleccionar la vista que quieres 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 que coincidan. 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 agrupación que apliques a una columna también se aplica automáticamente a otras columnas. Para ver un ejemplo de cómo agregar y agrupar entradas, consulta Agrupa y agrega 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 documentación de CAST.

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

    • Filtros: Agrega filtros cuando quieras restringir la consulta a los intervalos que contienen un atributo o un ID de intervalo específicos. 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.

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

    Si en la barra de herramientas se muestra Ejecutar en BigQuery, debes cambiar las 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 Analytics (predeterminado).

Ejemplo: Agrupa y agrega 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 agrupaciones y agregaciones. La agrupación 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 devolver 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.
  • Agregación: Agrupa los campos que se indican en el elemento Columnas, excepto cuando el campo tiene una selección de Agregación. Para esos campos, calcula el valor realizando una operación en todas las entradas de cada agrupación. La operación puede ser calcular el promedio de un campo o hacer algo como contar la cantidad de entradas en cada agrupación.
  • Agrupar por: Agrupa las entradas por todos los campos que se indican en el elemento Columnas.

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

  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 el Nivel de detalle de truncamiento en HOUR. Luego, la agrupación 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 la agrupación, verás un mensaje de error. Para resolver este error, quita los campos no válidos del menú.

    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 cuadro de 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 de forma similar a la siguiente:

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

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

    El resultado de esta consulta es similar al siguiente:

    +-----------------------------------+----------+---------------+
| 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 para el 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 en 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 en un valor numérico antes de calcular un promedio.

Para identificar el esquema, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

    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 a la sección Registros o Vistas de análisis y selecciona la vista que deseas consultar.

    Se actualiza el panel Esquema. Las Estadísticas de observabilidad infieren 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 al LogEntry. En el caso de las vistas de análisis, puedes modificar la consulta en SQL para cambiar el esquema.

¿Qué sigue?