Puedes consultar y analizar tus datos de registros y seguimientos con SQL en Estadísticas de observabilidad para descubrir tendencias de rendimiento, generar estadísticas agregadas y mostrar resultados en gráficos y tablas.
También puedes guardar los resultados de las consultas en tus paneles personalizados. Si quieres ver entradas de registro individuales o inspeccionar seguimientos y intervalos específicos, usa la página Explorador de registros o la página Explorador de seguimiento.
Acerca de los conjuntos de datos de BigQuery vinculados
No necesitas un conjunto de datos de BigQuery vinculado para consultar tus datos de registro, tus datos de seguimiento o ambos tipos de datos cuando usas la página Estadísticas de observabilidad.
Necesitas un conjunto de datos de BigQuery vinculado cuando quieras realizar alguna de las siguientes acciones:
- Unir datos de registro o de seguimiento con otros conjuntos de datos de BigQuery
- Consulta tus datos de registro o seguimiento desde otro servicio, como la página de BigQuery Studio o Data Studio.
- Ejecuta consultas de Estadísticas de observabilidad en el motor de BigQuery con ranuras a pedido o ranuras reservadas de BigQuery.
- Crea una política de alertas que supervise el resultado de una consulta en SQL. Para obtener más información, consulta Logging: Supervisa los resultados de tus consulta en SQL en SQL y Trace: Supervisa los resultados de tus consulta en SQL en SQL.
En este documento, no se describe cómo crear un conjunto de datos de BigQuery vinculado, que es un proceso específico para cada tipo de datos. Para obtener información sobre cómo crear un conjunto de datos de BigQuery vinculado, consulta Consulta datos de registro con un conjunto de datos de BigQuery vinculado o Consulta datos de seguimiento con un conjunto de datos de BigQuery vinculado.
Antes de comenzar
- Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Observability API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Observability API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Para obtener los permisos que necesitas para cargar la página Estadísticas de observabilidad, escribir, ejecutar y guardar consultas privadas en tus datos de seguimiento, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Descriptor de acceso de la vista de observabilidad (
roles/observability.viewAccessor) en las vistas de observabilidad que quieres consultar. Este rol admite las condiciones de IAM, que te permiten restringir el otorgamiento a una vista específica. Si no adjuntas una condición al otorgamiento del rol, la principal puede acceder a todas las vistas de observabilidad. - Usuario de Estadísticas de observabilidad (
roles/observability.analyticsUser) en tu proyecto. Este rol contiene los permisos necesarios para guardar y ejecutar consultas privadas, y para ejecutar consultas compartidas. - Visor de registros (
roles/logging.viewer) en tu proyecto - Descriptor de acceso de vista de registros (
roles/logging.viewAccessor) en el proyecto que almacena las vistas de registro que deseas consultar.
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 a través de roles personalizados o cualquier otro rol predefinido.
- Descriptor de acceso de la vista de observabilidad (
Consulta datos de registro y seguimiento
En esta sección, se describen los enfoques que puedes usar para consultar tus datos de registro y seguimiento:
- 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
-
En la Google Cloud consola, ve a la página manage_search 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.
En el menú Vistas, selecciona una vista.
Para encontrar la vista que deseas consultar, usa la barra filter_list Filtro o desplázate por la lista:
- Las vistas de registros, que se enumeran en la sección Registros del , se ordenan por los IDs de bucket y de vista.
- Las vistas de Analytics, que se enumeran en la sección Vistas de Analytics de , se ordenan por ubicación y por ID de la vista.
- Hay una vista de seguimiento, que se muestra en la sección
Seguimientos.
Si no ves una vista llamada
_Trace.Spans._AllSpans, tu proyecto de Google Cloud no contiene un bucket de observabilidad llamado_Trace. Para obtener información sobre cómo resolver este error, consulta No se puede inicializar el almacenamiento de seguimiento.
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 tune 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 code SQL.
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 code SQL.
Opcional: Modifica la consulta.
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 settings Configuración y, luego, selecciona Analytics (predeterminado).
Ingresa y ejecuta una consulta personalizada
Para ingresar una consulta en SQL, haz lo siguiente:
-
En la Google Cloud consola, ve a la página manage_search 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.
En el panel Consulta, haz clic en code SQL.
Para especificar un período, te recomendamos que uses el selector de período. Si agregas una cláusula
WHEREque especifique el campotimestamp, 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.
La vista que consultas determina el formato de la cláusula
FROM:Datos de registros
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 deFROMdebe contener exactamente una vista de registro.Datos de seguimiento
El editor de SQL muestra el nombre completamente calificado de la vista
_Trace.Spans._AllSpans, que tiene el siguiente formato:FROM `PROJECT_ID.LOCATION._Trace.Spans._AllSpans`
Los campos de la expresión anterior tienen el siguiente significado:
- PROJECT_ID: Es el identificador del proyecto.
- LOCATION: Es la ubicación del bucket de observabilidad.
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 Mensaje de error que indica que no existe una vista.- Vistas de registro:
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 settings 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 tus 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:
-
En la Google Cloud consola, ve a la página manage_search 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.
Si en el panel Consulta se muestra un editor de SQL, selecciona tune Compilador, que abre el panel Compilador de consultas.
Usa el menú Fuente para seleccionar la vista que quieres consultar. Tus selecciones se asignan a la cláusula
FROMen la consulta en SQL.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
WHEREen la consulta en SQL.Columnas: Selecciona las columnas que aparecen en la tabla de resultados. Tus selecciones se asignan a las cláusulas
SELECTen 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
WHEREen 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 BYen 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
LIMITen la consulta en SQL.
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 settings 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 los siguientes ejemplos, se muestra cómo puedes crear una consulta que agrupe entradas y, luego, realice algún tipo de agregación.
Ejemplo de agregación de datos de registro
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:
En el menú Columnas, selecciona los campos
timestamp,severityyhttp_request.response_size.Para agrupar tus datos, haz clic en el campo
timestamppara 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 enHOUR. 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ú.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.
En el menú Filtros, agrega
http_request.response_sizey establece el comparador enIS NOT NULL. Este filtro coincide con las entradas de registro que contienen un valorresponse_size.Los menús del compilador de consultas se ven de forma similar a la siguiente:

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
Ejemplo de agregación de datos de seguimiento
En este ejemplo, se muestra cómo usar el Compilador de consultas para agrupar los intervalos por hora de inicio, nombre y tipo, y, luego, calcular la duración promedio en nanosegundos para cada grupo:
- En el menú Columnas, selecciona los campos
start_time,name,kindyduration_nano. - Para truncar la hora de inicio a la hora, expande el menú en la columna
start_timey selecciona Agrupar por. Asegúrate de que el menú de nivel de detalle esté configurado en Hora. Haz clic en Aplicar.
Cuando seleccionas Agrupar por para cualquier columna, el sistema agrupa las entradas por todas las columnas. En este ejemplo, las entradas se agrupan por el valor truncado de
start_time, el nombre del intervalo, el tipo de intervalo y el valor de la duración.Sin embargo, el objetivo de este ejemplo es agrupar las entradas por la hora truncada, el nombre del intervalo y el tipo de intervalo y, luego, para cada grupo, calcular la duración promedio. En el siguiente paso, modificarás la agrupación y agregarás una agregación.
Expande el menú en el campo
duration_nano, selecciona Agregación y, luego, establece el campo Agregación en Promedio.Cuando ejecutas la consulta, cada fila corresponde a un grupo, que consta de una hora truncada, un nombre de intervalo y un tipo de intervalo. La entrada final de cada fila es la duración promedio de todas las entradas de ese grupo.
El resultado de esta consulta es similar al siguiente:
+-----------------------------------+----------------+----------+-----------------------+ | Row | hour_timestamp | span_name | kind | average_duration_nano | | | TIMESTAMP | STRING | INTEGER | FLOAT | +-----+-----------------------------+-----------+---------------+-----------------------+ | 1 | 2025-10-09 13:00:00.000 EDT | http.receive | 3 | 122138.22813990474 | 2 | 2025-10-09 13:00:00.000 EDT | query.request | 1 | 6740819304.390297 | 3 | 2025-10-09 13:00:00.000 EDT | client.handler | 2 | 6739339098.409376Tu consulta puede incluir varias agregaciones. Por ejemplo, para agregar una columna que cuente la cantidad de entradas en cada grupo, haz lo siguiente:
- En el elemento Columns, haz clic en Add column.
- Selecciona Todas (*).
- En el cuadro de diálogo, selecciona Agregar, selecciona Recuento para la Agregación y, luego, selecciona Aplicar.
Con este cambio, la agrupación sigue siendo la misma. Las entradas se agrupan por la hora de inicio truncada, el nombre del intervalo y el tipo de intervalo. Sin embargo, para cada grupo, la consulta calcula la duración promedio y la cantidad de entradas.
La consulta en SQL correspondiente para el ejemplo anterior es la siguiente:
WITH
scope_query AS (
SELECT
*
FROM
`PROJECT_ID.us._Trace.Spans._AllSpans` )
SELECT
-- Report the truncated start time, span name, span kind, average duration and number
-- of entries for each group.
TIMESTAMP_TRUNC( start_time, HOUR ) AS hour_start_time,
name AS span_name,
kind,
AVG( duration_nano ) AS average_duration_nano,
COUNT( * ) AS count_all
FROM
scope_query
GROUP BY
TIMESTAMP_TRUNC( start_time, HOUR ),
name,
kind
LIMIT
100
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:
-
En la Google Cloud consola, ve a la página manage_search 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.
En el menú Vistas, selecciona una vista.
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 more_vert Opciones y selecciona Ver información y descripción.
Datos de registros
Para las vistas de registro, el esquema es fijo y corresponde a
LogEntry. En el caso de las vistas de análisis, puedes modificar la consulta en SQL para cambiar el esquema.Datos de seguimiento
Para obtener información sobre el esquema, consulta Esquema de almacenamiento para los datos de seguimiento.
Si no ves una vista llamada
_Trace.Spans._AllSpans, tu proyecto de Google Cloud no contiene un bucket de observabilidad llamado_Trace. Para obtener información sobre cómo resolver este error, consulta No se puede inicializar el almacenamiento de seguimiento.
Restricciones
Si quieres consultar varias vistas, estas deben residir en la misma
ubicación. Por ejemplo, si almacenas dos vistas en la ubicación us-east1, una consulta puede consultar ambas vistas. También puedes consultar dos vistas almacenadas en la
multirregión us. Sin embargo, si la ubicación de una vista es global, esa vista
puede residir en cualquier ubicación física. Por lo tanto, las uniones entre dos vistas que
tienen la ubicación de global podrían fallar.
Para obtener una lista de las restricciones que se aplican a los datos de registro, consulta Estadísticas de observabilidad: Restricciones.