Acerca de las vistas de análisis

En este documento, se describen las vistas de estadísticas y cuándo es posible que desees crearlas. También se describen las diferencias entre las vistas de estadísticas y las consultas guardadas.

Descripción general

Una vista de estadísticas es un recurso que puedes consultar. Es decir, después de definir una vista de estadísticas, puedes escribir consultas en las que la especifiques en la cláusula FROM.

El principal beneficio de usar vistas de estadísticas es que no estás limitado a consultar los datos en el formato que define una API o un sistema. Una vista de estadísticas te permite definir un esquema, lo que te permite simplificar tus consultas o reducir el tiempo que dedicas a escribirlas. La consulta en una vista de estadísticas puede realizar acciones como conservar solo campos específicos, cambiar el nombre de los campos, mover campos anidados a una columna de nivel superior y realizar agrupaciones y agregaciones.

Las vistas de estadísticas no son vistas materializadas. Una vista de estadísticas no es una vista procesada previamente que almacena en caché de forma periódica los resultados de la consulta. Por lo tanto, consultar una vista de estadísticas equivale a consultar las vistas que se enumeran en la consulta de la vista de estadísticas.

Las vistas de estadísticas son más potentes que las consultas guardadas, que son consultas que ejecutas en la página Análisis de registros y, luego, guardas. Puedes volver a ejecutar una consulta guardada, pero no puedes consultar los resultados de una consulta guardada.

Tipos de vistas de estadísticas

Existen dos tipos de vistas de estadísticas: definidas por el usuario y definidas por el sistema:

Las vistas de estadísticas definidas por el usuario son todas las vistas de estadísticas que creas. Puedes consultar, editar y borrar vistas de estadísticas definidas por el usuario.
Las vistas de estadísticas definidas por el sistema son vistas de estadísticas creadas por Google Cloud los servicios. Puedes consultar vistas de estadísticas definidas por el sistema. Sin embargo, no puedes editarlas ni borrarlas.

Para obtener información sobre cómo enumerar las vistas de estadísticas de tu Google Cloud proyecto, consulta Enumera vistas de estadísticas.

Ubicación de las vistas de estadísticas

La ubicación de una vista de estadísticas está determinada por la ubicación de los recursos que consulta. Por ejemplo, si una vista de estadísticas consulta una vista de observabilidad que se encuentra en la ubicación global, la ubicación de la vista de estadísticas también debe ser global. Cuando usas la Google Cloud consola para crear una vista de estadísticas, la ubicación se establece automáticamente.

Ejemplos de casos de uso

El principal beneficio de una vista de estadísticas es que no estás limitado a consultar los datos en el formato que define el sistema. Una vista de estadísticas te permite definir un esquema, lo que te permite simplificar tus consultas o reducir el tiempo que dedicas a escribirlas.

Extrae el nombre del servicio de seguimiento

Supongamos que deseas escribir consultas que analicen tus datos de seguimiento y que deseas mostrar o agrupar por un nombre de servicio sintetizado. La consulta de tu vista de estadísticas determina el nombre del servicio para un intervalo mediante la función COALESCE, que evalúa una lista de expresiones, en orden, y muestra el valor de la primera expresión que no se evalúa como NULL:

SELECT
  start_time,
  -- Set the value of service name based on the first non-null value in the list.
  COALESCE(
    JSON_VALUE(resource.attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
  name AS span_name,
  duration_nano,
  status.code AS status,
  trace_id,
  span_id
FROM
  `PROJECT_ID.us._Trace.Spans._AllSpans`
LIMIT 10

Antes de usar la consulta, reemplaza PROJECT_ID por el ID de tu Google Cloud proyecto.

Limitaciones

Se aplican las siguientes limitaciones a las vistas de estadísticas:

Una vista de estadísticas solo puede consultar vistas de observabilidad.
El recurso superior de una vista de estadísticas debe ser un Google Cloud proyecto.
Solo puedes consultar una vista de estadísticas con la página Análisis de registros y solo cuando usas el motor de consultas Análisis de registros (predeterminado).
Todas las vistas que consulta una vista de estadísticas deben estar en la misma ubicación.
Debes usar la Google Cloud consola para crear o administrar tus vistas de estadísticas.
Puedes crear como máximo 100 vistas de estadísticas por Google Cloud proyecto.
Puedes crear como máximo 50 vistas de estadísticas por región.
Por Google Cloud proyecto, como máximo 10 regiones pueden contener una vista de estadísticas.