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

Preview

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 de pré-DG sont proposés "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment créer, gérer et interroger des vues analytiques. Pour obtenir une présentation des concepts, consultez À propos des vues "Analytics".

Avant de commencer

Remarque : Il n'existe aucun rôle IAM (Identity and Access Management) Cloud Logging prédéfini qui contienne les autorisations requises pour créer ou interroger une vue analytique.

Étant donné que les vues analytiques interrogent les vues de journaux, vos rôles IAM doivent également vous permettre d'interroger les vues de journaux et d'utiliser l'analyse des journaux pour créer et interroger des vues analytiques. Cette section liste les rôles IAM requis pour créer des vues d'analyse, interroger des vues de journaux et utiliser l'analyse de journaux :

• Pour obtenir les autorisations nécessaires pour créer, gérer et utiliser des vues d'analyse, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur Observability Analytics (roles/observability.analyticsUser) sur votre projet.

  Ce rôle prédéfini contient les autorisations requises pour créer, gérer et utiliser des vues analytiques. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

  Autorisations requises

  Vous devez disposer des autorisations suivantes pour créer, gérer et utiliser des vues d'analyse :

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Pour obtenir les autorisations nécessaires pour interroger une vue de journaux et utiliser Log Analytics, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Pour interroger les buckets de journaux _Required et _Default : Lecteur de journaux (roles/logging.viewer)
  • Pour interroger toutes les vues de journaux d'un projet : Accesseur de vues de journaux (roles/logging.viewAccessor)

  Vous pouvez limiter l'accès d'une entité principale à une vue de journaux spécifique en ajoutant une condition IAM à l'attribution du rôle "Accesseur de vues de journaux" au niveau du projet, ou en ajoutant une liaison IAM au fichier de stratégie de la vue de journaux. Pour en savoir plus, consultez Contrôler l'accès à une vue de journal.

  Pour en savoir plus sur les rôles supplémentaires dont vous avez besoin pour interroger les vues sur les buckets définis par l'utilisateur ou pour interroger la vue _AllLogs du bucket de journaux _Default, consultez Rôles Cloud Logging.

Créer une vue analytique

Remarque : Une vue Analytics ne peut interroger que les vues de journaux. Lorsque plusieurs vues de journaux sont interrogées, les buckets de journaux qui les hébergent doivent se trouver au même emplacement. Par exemple, si vous avez deux buckets de journaux dans l'emplacement us-east1, vous pouvez créer une vue Analytics qui interroge les vues de journaux sur ces buckets de journaux.

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. Dans le menu Vues, accédez à la section Journaux segment, puis sélectionnez la vue de journal à interroger.

   Pour trouver une vue de journal, vous pouvez utiliser la barre de Filtre ou faire défiler la liste des vues de journaux. Chaque entrée de la liste est au format suivant : BUCKET_ID.LOG_VIEW_ID, où ces champs font référence aux ID du bucket de journaux et de la vue de journaux.

3. Dans la barre d'outils Schéma, cliquez sur Requête.

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

4. 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).

5. Mettez à jour la requête SQL dans le volet Requête jusqu'à ce que vous soyez satisfait des résultats de la requête.

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

7. Saisissez un nom et une description pour la vue Analytics, puis cliquez sur Enregistrer.

   Le nom est limité à 100 caractères et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des tirets.

   Remarque : Vous ne pouvez pas modifier le nom d'une vue analytique après sa création. Vous pouvez modifier la description et la requête.

   Votre vue Analytics est créée et listée dans le volet Vues, dans la section Vues Analytics intitulée data_table. Chaque entrée de la liste est au format suivant : LOCATION.ANALYTICS_VIEW_ID, où ces champs font référence à l'emplacement et à l'ID d'une vue Analytics. Par exemple, si vous avez créé une vue Analytics nommée my-analytic-view qui interroge une vue de journaux dont le bucket de journaux se trouve dans la région global, cette section affiche global.my-analytic-view.

Interroger une vue analytique

Une fois qu'une vue analytique existe, vous pouvez l'interroger de la même manière qu'une vue de journaux. Pour obtenir la liste des documents qui décrivent comment utiliser la page Analyse de journaux, consultez la section Étapes suivantes de ce document.

Pour exécuter la requête par défaut pour 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. Saisissez une requête ou chargez la requête par défaut pour la vue Analytics. La clause FROM de votre requête doit respecter le format suivant :

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   Dans l'expression précédente, les champs ont la signification suivante :

   • PROJECT_ID : identifiant du projet.
   • LOCATION : emplacement de la vue Analytics. L'emplacement d'une vue Analytics est hérité de la ressource qu'elle interroge. Par exemple, si une vue Analytics interroge une vue de journaux qui se trouve dans l'emplacement global, l'emplacement de la vue Analytics est également global.
   • 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 exécuter la requête par défaut, procédez comme suit :

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

      Pour trouver une vue Analytics, vous pouvez utiliser la barre de filtre  ou faire défiler la liste des vues Analytics. Chaque entrée de la liste est au format suivant : LOCATION.ANALYTICS_VIEW_ID, où ces champs font référence à l'emplacement et à l'ID d'une vue Analytics.

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

      Le volet Requête est mis à jour avec une requête SQL qui interroge la vue analytique que vous avez sélectionnée.

3. Cliquez sur 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).

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. Dans le menu Vues, accédez à la section Vues Analytics data_table.

   Une liste de vues Analytics s'affiche. Chaque entrée de la liste est au format suivant : LOCATION.ANALYTICS_VIEW_ID. Ces champs font référence à l'emplacement et à l'ID d'une vue Analytics. Par exemple, si vous avez créé une vue Analytics nommée my-analytic-view qui interroge une vue de journaux dont le bucket de journaux se trouve dans la région global, cette section affiche global.my-analytic-view.

3. Pour afficher les détails d'une vue Analytics spécifique, procédez comme suit :

   1. Sélectionnez la vue Analytics.

      Le schéma de la vue analytique est affiché dans la section Schéma.

   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.

      La boîte de dialogue affiche des informations sur la vue Analytics, y compris la date de création, le schéma et la requête.

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. Dans le menu Vues, accédez à la section Vues Analytics data_table, puis sélectionnez la vue Analytics que vous souhaitez interroger.

3. 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.

4. Une fois les modifications effectué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. Dans le menu Vues, accédez à la section Vues Analytics data_table, puis sélectionnez la vue Analytics que vous souhaitez interroger.
3. 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 pas interroger une autre vue Analytics.
• Une vue Analytics peut interroger plusieurs vues de journaux. Toutefois, les buckets de journaux qui hébergent les vues de journaux interrogées doivent se trouver au même emplacement. Par exemple, supposons que vous ayez deux buckets de journaux, l'un dans us-east1 et l'autre dans asia-east1. Vous ne pouvez pas créer de vue Analytics qui interroge les vues de journaux de ces buckets de journaux.
• La ressource parente d'une vue Analytics doit être un projet Google Cloud . Vous ne pouvez pas créer de vue Analytics dans des dossiers ni des organisations.
• Les ensembles de données associés ne sont pas compatibles avec les vues Analytics. Par conséquent, vous ne pouvez interroger les vues Analytics qu'à l'aide de la page Analyse de journaux. De plus, vous devez exécuter ces requêtes sur le service Cloud Logging par défaut.
• Aucune API ne permet de créer ni de gérer des vues d'analyse.

• Les limites suivantes s'appliquent aux vues analytiques :

  • Nombre maximal de vues Analytics par projet : 100 Google Cloud
  • Par projet Google Cloud , le nombre maximal de vues Analytics par région est de 50.
  • Par projet Google Cloud , le nombre maximal de régions pouvant stocker des vues analytiques est de 10.

Étapes suivantes

• Présentation de l'interrogation et de l'analyse des journaux
• Enregistrer et partager une requête SQL
• Représenter les résultats d'une requête SQL sous forme de graphique
• Exemples de requêtes SQL