À propos des vues analytiques

Ce document décrit les vues d'analyse et les cas dans lesquels vous pouvez être amené à en créer. Il décrit également les différences entre les vues d'analyse et les requêtes enregistrées.

Présentation

Une vue d'analyse est une ressource que vous pouvez interroger. Autrement dit, une fois que vous avez défini une vue d'analyse, vous pouvez écrire des requêtes dans lesquelles vous spécifiez votre vue d'analyse dans la clause FROM.

L'avantage principal de l'utilisation des vues d'analyse est que vous n'êtes pas limité à l'interrogation des données au format défini par une API ou un système. Une vue d'analyse vous permet de définir un schéma, ce qui vous permet de simplifier vos requêtes ou de réduire le temps que vous passez à les écrire. La requête d'une vue d'analyse peut, par exemple, ne conserver que des champs spécifiques, renommer des champs, déplacer des champs imbriqués vers une colonne de premier niveau, et effectuer des regroupements et des agrégations.

Les vues d'analyse ne sont pas des vues matérialisées. Une vue d'analyse n'est pas une vue précalculée qui met régulièrement en cache les résultats des requêtes. Par conséquent, interroger une vue d'analyse revient à interroger les vues listées dans la requête de la vue d'analyse.

Les vues d'analyse sont plus puissantes que les requêtes enregistrées, qui sont des requêtes que vous exécutez sur la page Observability Analytics (Analyse de l'observabilité), puis que vous enregistrez. Vous pouvez réexécuter une requête enregistrée, mais vous ne pouvez pas interroger ses résultats.

Types de vues d'analyse

Il existe deux types de vues d'analyse : celles définies par l'utilisateur et celles définies par le système :

  • Les vues d'analyse définies par l'utilisateur sont toutes les vues d'analyse que vous créez. Vous pouvez interroger, modifier et supprimer les vues d'analyse définies par l'utilisateur.

  • Les vues d'analyse définies par le système sont des vues d'analyse créées par Google Cloud des services. Vous pouvez interroger les vues d'analyse définies par le système. Toutefois, vous ne pouvez pas les modifier ni les supprimer.

Pour savoir comment lister les vues d'analyse de votre Google Cloud projet, consultez la page Lister les vues d'analyse.

Emplacement des vues d'analyse

L'emplacement d'une vue d'analyse est déterminé par l'emplacement des ressources qu'elle interroge. Par exemple, si une vue d'analyse interroge une vue d'observabilité qui se trouve à l'emplacement global, l'emplacement de la vue d'analyse doit également être global. Lorsque vous utilisez la Google Cloud console pour créer une vue d'analyse, l'emplacement est défini automatiquement.

Exemples de cas d'utilisation

L'avantage principal d'une vue d'analyse est que vous n'êtes pas limité à l'interrogation des données au format défini par le système. Une vue d'analyse vous permet de définir un schéma, ce qui vous permet de simplifier vos requêtes ou de réduire le temps que vous passez à les écrire.

Extraire le nom du service de trace

Supposons que vous souhaitiez écrire des requêtes qui analysent vos données de trace et que vous souhaitiez afficher ou regrouper les données par nom de service synthétisé. La requête de votre vue d'analyse détermine le nom du service pour un segment à l'aide de la fonction COALESCE, qui évalue une liste d'expressions, dans l'ordre, et renvoie la valeur de la première expression qui n'est pas évaluée sur 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

Avant d'utiliser la requête, remplacez PROJECT_ID par l'ID de votre Google Cloud projet.

Limites

Les limites suivantes s'appliquent aux vues d'analyse :

  • Une vue d'analyse ne peut interroger que des vues d'observabilité.
  • La ressource parente d'une vue d'analyse doit être un Google Cloud projet.
  • Vous ne pouvez interroger une vue d'analyse qu'à l'aide de la page Observability Analytics (Analyse de l'observabilité) et uniquement lorsque vous utilisez le moteur de requête Observability Analytics (default) (Analyse de l'observabilité (par défaut)).
  • Toutes les vues interrogées par une vue d'analyse doivent se trouver au même emplacement.
  • Vous devez utiliser la Google Cloud console pour créer ou gérer vos vues d'analyse.
  • Vous pouvez créer au maximum 100 vues d'analyse par Google Cloud projet.
  • Vous pouvez créer au maximum 50 vues d'analyse par région.
  • Par Google Cloud projet, au maximum 10 régions peuvent contenir une vue d'analyse.

Étape suivante