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 de journaux. Si vous ne connaissez pas les vues analytiques, consultez À propos des vues analytiques.

Avant de commencer

1. Vérifiez que la facturation est activée pour votre Google Cloud projet.

2. 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 sur votre projet :

   • Utilisateur Observability Analytics (roles/observability.analyticsUser)
   • Accesseur de vues de journaux (roles/logging.viewAccessor)

   Vous pouvez limiter un principal à une vue de journaux spécifique en ajoutant une condition IAM à l'attribution du rôle Accesseur de vues de journaux effectuée 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 journaux.

   Pour en savoir plus sur les rôles supplémentaires dont vous avez besoin pour interroger des vues sur des 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 Observability Analytics. Pour en savoir plus, consultez Configurer les buckets de journaux.

Créer une vue analytique

Remarque : Une vue analytique peut interroger des vues de journaux. Lorsqu'une vue analytique interroge plusieurs vues, celles-ci doivent se trouver au même emplacement. Par exemple, si vous disposez de 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 de journaux.

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 de 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, recherchez et sélectionnez la vue de journaux que vous souhaitez interroger.

   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 de journaux. 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 Présentation de l'interrogation et de l'analyse des journaux.

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 de journaux.
• 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

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