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 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 Analytics, vous pouvez l'interroger de la même manière que les vues de journaux. Si vous ne connaissez pas les vues Analytics, consultez À propos des vues Analytics.

Avant de commencer

1. Verify that billing is enabled for your Google Cloud project.

2. Pour obtenir les autorisations nécessaires pour créer, gérer et utiliser des vues d'analyse, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

   • Utilisateur Observability Analytics (roles/observability.analyticsUser)
   • 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.

3. Assurez-vous de disposer d'un bucket de journaux mis à niveau pour utiliser l'Analyse de journaux. Pour en savoir plus sur cette étape, consultez Configurer des buckets de journaux.

Créer une vue analytique

Remarque : Une vue Analytics peut interroger des vues de journaux. Lorsqu'une vue Analytics interroge plusieurs vues, celles-ci 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 analytique qui interroge les vues de journaux de ces deux buckets.

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 des journaux 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 Journaux du segment, puis recherchez et sélectionnez la vue de journal que vous souhaitez interroger.

   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 analytique et la liste dans le volet Vues, dans la section Vues analytiques de data_table.

Interroger une vue analytique

Vous interrogez une vue Analytics de la même manière que vous interrogez des vues de journaux. 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 Présentation de l'interrogation et de l'analyse des journaux.

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 Analytics :

• 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 s'ouvre et affiche des informations sur la vue Analytics. 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 analytiques data_table, puis sélectionnez la vue analytique 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 des vues de journaux.
• La ressource parente d'une vue Analytics 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 analytique.

É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