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

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation 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 présentation des vues analytiques, consultez À propos des vues analytiques.

Avant de commencer

Connectez-vous à votre Google Cloud compte. 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'attribution à 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 d'Observability Analytics (roles/observability.analyticsUser) on your project. Ce rôle contient les autorisations requises pour enregistrer et exécuter des requêtes privées, ainsi que 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 de disposer d'une vue d'observabilité. Pour en savoir plus, consultez le modèle de stockage Cloud Trace.

Créer une vue analytique

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

Pour créer une vue analytique, procédez comme suit :

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

   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 Observability Analytics :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, alors cliquez sur Paramètres et sélectionnez Observability Analytics (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation, puis 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 cliquez sur Écraser.

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

   3. Mettez à jour 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 analytique.

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

      Le nom est limité à 100 caractères et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des traits d'union. 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 analytique et la liste dans le volet Vues, dans la section data_table Vues analytiques.

Interroger une vue analytique

Vous interrogez une vue analytique de la même manière que les vues d'observabilité. Pour interroger des vues analytiques, 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 analytique.
• ANALYTICS_VIEW_ID : ID de la vue analytique, limité à 100 caractères et ne pouvant contenir que des lettres, des chiffres, des traits de soulignement et des traits d'union.

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

Répertorier les vues analytiques

Pour répertorier les vues analytiques de votre Google Cloud projet, procédez comme suit :

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

   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 Observability Analytics :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, alors cliquez sur Paramètres et sélectionnez Observability Analytics (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation, puis cliquez sur Vues et schéma.

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

Obtenir des informations sur une vue analytique

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 analytique, répertoriez les vues analytiques de votre projet, puis procédez comme suit :

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

Modifier une vue analytique

Pour modifier une vue analytique, procédez comme suit :

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

   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 Observability Analytics :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, alors cliquez sur Paramètres et sélectionnez Observability Analytics (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation, puis cliquez sur Vues et schéma.

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

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

   Une boîte de dialogue s'ouvre et affiche des informations sur la vue analytique. 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 analytique

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

Pour supprimer une vue analytique, procédez comme suit :

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

   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 Observability Analytics :
   1. Assurez-vous que la barre d'outils affiche Exécuter la requête. Si la barre d'outils affiche Exécuter dans BigQuery, alors cliquez sur Paramètres et sélectionnez Observability Analytics (par défaut).
   2. Si le menu Vues ne s'affiche pas, accédez au volet de navigation, puis cliquez sur Vues et schéma.

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

Limites

Les limites suivantes s'appliquent aux vues analytiques :

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

Étape suivante

• Interroger et analyser des 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.