Acerca de las vistas de análisis

En este documento, se describen las vistas de Analytics y cuándo te conviene crearlas. También se describen las diferencias entre las vistas de Analytics y las consultas guardadas.

Descripción general

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

El principal beneficio de usar vistas de Analytics es que no estás limitado a consultar los datos en el formato que define una API o un sistema. Una vista de Analytics 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 Analytics puede hacer cosas 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 Analytics no son vistas materializadas. Una vista de Analytics no es una vista procesada previamente que almacena en caché los resultados de las consultas de forma periódica. Por lo tanto, consultar una vista de Analytics equivale a consultar las vistas que se enumeran en la consulta de la vista de Analytics.

Las vistas de Analytics 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 Analytics

Existen dos tipos de vistas de Analytics: definidas por el usuario y definidas por el sistema:

Las vistas de Analytics definidas por el usuario son las vistas de Analytics que creas. Puedes consultar, editar y borrar las vistas de análisis definidas por el usuario.
Las vistas de Analytics definidas por el sistema son vistas de Analytics creadas por losGoogle Cloud servicios. Puedes consultar vistas de análisis definidas por el sistema. Sin embargo, no puedes editarlos ni borrarlos.

Para obtener información sobre cómo enumerar las vistas de Analytics en tu proyecto deGoogle Cloud , consulta Enumera las vistas de Analytics.

Ubicación de las vistas de Analytics

La ubicación de una vista de Analytics se determina según la ubicación de los recursos que consulta. Por ejemplo, si una vista de Analytics consulta una vista de observabilidad que se encuentra en la ubicación global, la ubicación de la vista de Analytics también debe ser global. Cuando usas la consola de Google Cloud para crear una vista de Analytics, la ubicación se establece automáticamente.

Ejemplos de casos de uso

El principal beneficio de una vista de Analytics es que no estás limitado a consultar los datos en el formato que define el sistema. Una vista de Analytics 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 Analytics determina el nombre del servicio para un intervalo con la función COALESCE, que evalúa una lista de expresiones, en orden, y devuelve 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 proyecto deGoogle Cloud .

Limitaciones

Se aplican las siguientes limitaciones a las vistas de Analytics:

Una vista de Analytics solo puede consultar vistas de observabilidad.
El recurso principal de una vista de Analytics debe ser un proyecto de Google Cloud .
Solo puedes consultar una vista de Analytics 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 Analytics deben estar en la misma ubicación.
Debes usar la consola de Google Cloud para crear o administrar tus vistas de Analytics.
Puedes crear como máximo 100 vistas de Analytics por proyecto de Google Cloud .
Puedes crear un máximo de 50 vistas de Analytics por región.
Por Google Cloud proyecto, como máximo 10 regiones pueden contener una vista de Analytics.