Créer, interroger et gérer des vues d'analyse

Aperçu

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment créer et gérer des vues analytiques. Une fois que vous avez créé une vue analytique, vous pouvez l'interroger de la même manière que les vues d'observabilité.

Pour obtenir une vue d'ensemble des vues analytiques, consultez À propos des vues analytiques.

Avant de commencer

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Pour obtenir les autorisations nécessaires pour créer, gérer et utiliser des vues analytiques, demandez à votre administrateur de vous accorder les rôles IAM suivants :

   • Accesseur de vue d'observabilité (roles/observability.viewAccessor) sur les vues d'observabilité que vous souhaitez interroger. Ce rôle est compatible avec les conditions IAM, qui vous permettent de limiter l'accès à une vue spécifique. Si vous n'associez pas de condition à l'attribution de rôle, le compte principal peut accéder à toutes les vues d'observabilité. Les vues d'observabilité sont disponibles en version Preview publique.
   • Utilisateur Observability Analytics (roles/observability.analyticsUser) sur votre projet Ce rôle contient les autorisations requises pour enregistrer et exécuter des requêtes privées, et pour exécuter des requêtes partagées.
   • Lecteur de journaux (roles/logging.viewer) sur votre projet.

   Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

   Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

2. Assurez-vous d'avoir une vue d'observabilité. Pour en savoir plus, consultez Modèle de stockage Cloud Trace.

Créer une vue analytique

Remarque : Une vue Analytics peut interroger des vues d'observabilité. Lorsqu'une vue Analytics interroge plusieurs vues, celles-ci doivent se trouver au même emplacement.

Pour créer une vue analytique :

1. Dans la console Google Cloud , accédez à la page Analyse de journaux :

   Accéder à l'Analyse de journaux

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

2. Configurez la page Analyse de journaux :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, cliquez sur Paramètres, puis sélectionnez Analyse de journaux (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation et cliquez sur Vues et schéma.

3. Saisissez et validez la requête que vous souhaitez enregistrer en tant que vue analytique.

   Vous pouvez charger et modifier la requête par défaut pour la vue d'observabilité que votre vue analytique interrogera. Pour charger la requête par défaut, procédez comme suit :

   1. Dans le menu Vues, accédez à la section Traces , puis sélectionnez _Trace.Spans._AllSpans.

   2. Dans la barre d'outils Schéma, cliquez sur Requête, puis sur Écraser.

      Le volet Requête est mis à jour avec une requête SQL.

   3. Modifiez la requête jusqu'à ce que vous soyez satisfait des résultats.

4. Créez une vue analytique :

   1. Dans la barre d'outils, cliquez sur Enregistrer Enregistrer, puis sélectionnez Enregistrer en tant que vue Analytics.

   2. Saisissez un nom et une description pour la vue Analytics.

      Le nom est limité à 100 caractères et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des tirets. Vous ne pouvez pas modifier le nom après avoir créé la vue analytique.

   3. Cliquez sur Enregistrer.

   Le système crée votre vue Analytics et la liste dans le volet Vues, dans la section Vues Analytics de data_table.

Interroger une vue analytique

Vous interrogez une vue analytique de la même manière que vous interrogez une vue d'observabilité. Pour interroger les vues Analytics, utilisez le format suivant pour la clause FROM :

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

Les champs des expressions précédentes ont la signification suivante :

• PROJECT_ID : identifiant du projet.
• LOCATION : emplacement de la vue Analytics.
• ANALYTICS_VIEW_ID : ID de la vue Analytics, limité à 100 caractères et ne pouvant inclure que des lettres, des chiffres, des traits de soulignement et des traits d'union.

Pour en savoir plus, consultez Interroger et analyser les traces.

Lister les vues Analytics

Pour lister les vues Analytics de votre projet Google Cloud  :

1. Dans la console Google Cloud , accédez à la page Analyse de journaux :

   Accéder à l'Analyse de journaux

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

2. Configurez la page Analyse de journaux :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, cliquez sur Paramètres, puis sélectionnez Analyse de journaux (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation et cliquez sur Vues et schéma.

3. Dans le menu Vues, accédez à la section Vues Analytics data_table.

Obtenir des informations sur une vue Analytics

Vous pouvez utiliser les options du volet Schéma pour afficher les informations suivantes sur une vue analytique :

• Nom.
• Date de création.
• Dernière mise à jour.
• Schéma.
• Requête.

Pour afficher les détails d'une vue Analytics, listez les vues Analytics de votre projet, puis procédez comme suit :

1. Sélectionnez la vue Analytics dont vous souhaitez afficher les informations.
2. Dans la barre d'outils Schéma, cliquez sur Afficher les options de vue des données analytiques, puis sélectionnez Afficher les détails.

Modifier une vue analytique

Pour modifier une vue Analytics :

1. Dans la console Google Cloud , accédez à la page Analyse de journaux :

   Accéder à l'Analyse de journaux

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

2. Configurez la page Analyse de journaux :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, cliquez sur Paramètres, puis sélectionnez Analyse de journaux (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation et cliquez sur Vues et schéma.

3. Dans le menu Vues, accédez à la section Vues Analytics data_table, puis sélectionnez la vue Analytics que vous souhaitez modifier.

4. Dans la barre d'outils Schéma, cliquez sur Afficher les options de la vue analytique, puis sélectionnez Modifier la vue.

   Une boîte de dialogue contenant des informations sur la vue Analytics s'affiche. Vous pouvez modifier la description et la requête.

5. Une fois les modifications terminées, cliquez sur Écraser la vue enregistrée.

Supprimer une vue Analytics

Remarque : Si vous avez écrit des requêtes sur une vue analytique et que vous supprimez cette vue, ces requêtes échoueront.

Pour supprimer une vue Analytics :

1. Dans la console Google Cloud , accédez à la page Analyse de journaux :

   Accéder à l'Analyse de journaux

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

2. Configurez la page Analyse de journaux :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, cliquez sur Paramètres, puis sélectionnez Analyse de journaux (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation et cliquez sur Vues et schéma.

3. Dans le menu Vues, accédez à la section Vues Analytics data_table, puis sélectionnez la vue Analytics que vous souhaitez supprimer.
4. Dans la barre d'outils Schéma, cliquez sur Afficher les options de la vue analytique, sélectionnez Supprimer la vue, puis renseignez la boîte de dialogue.

Limites

Les limites suivantes s'appliquent aux vues analytiques :

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

Étapes suivantes

• Interrogez et analysez les traces.
• Représenter les résultats d'une requête SQL sous forme de graphique
• Enregistrer et partager des requêtes
• Exemples de requêtes SQL