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.

Les vues d'analyse dans Analyse de l'observabilité vous permettent de définir une requête SQL avec un schéma personnalisé sur vos données Cloud Logging afin de simplifier et de réutiliser des transformations complexes. Une fois que vous avez créé une vue d'analyse, vous pouvez interroger ses résultats dans la clause FROM d'autres requêtes SQL, de la même manière que vous interrogez des vues de journaux.

Pour en savoir plus sur les vues d'analyse, consultez À propos des vues d'analyse.

Avant de commencer

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

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 de l'analyse de l'observabilité (roles/observability.analyticsUser)
   • Accesseur de vues de journaux (roles/logging.viewAccessor)

   Vous pouvez limiter l'accès d'un compte principal à 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 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 Analyse de l'observabilité. Pour en savoir plus sur cette étape, consultez Configurer des buckets de journaux.

Créer une vue d'analyse

Remarque : Une vue d'analyse peut interroger des vues de journaux. Si une vue d'analyse 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 d'analyse qui interroge les vues de journaux sur ces deux buckets de journaux.

Pour créer une vue d'analyse, procédez comme suit :

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

   Accéder à Analyse de l'observabilité

   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 l'observabilité :
   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 l'observabilité (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 d'analyse.

   Vous pouvez charger et modifier la requête par défaut de la vue de journaux que votre vue d'analyse 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. Mettez à jour la requête jusqu'à ce que vous soyez satisfait des résultats.

4. Créez une vue d'analyse :

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

   2. Saisissez un nom et une description pour la vue d'analyse.

      Le nom est limité à 100 caractères et ne peut inclure 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 d'analyse.

   3. Cliquez sur Enregistrer.

   Le système crée votre vue d'analyse et l'affiche dans le volet Vues, dans la section Vues d'analyse data_table.

Interroger une vue d'analyse

Vous interrogez une vue d'analyse de la même manière que vous interrogez des vues de journaux. Pour interroger des vues d'analyse, 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 d'analyse.
• ANALYTICS_VIEW_ID : ID de la vue d'analyse, 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.

Répertorier les vues d'analyse

Pour lister les vues d'analyse de votre projet Google Cloud , procédez comme suit :

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

   Accéder à Analyse de l'observabilité

   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 l'observabilité :
   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 l'observabilité (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 section data_table Vues d'analyse.

Obtenir des détails sur une vue d'analyse

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

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

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

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

Modifier une vue d'analyse

Pour modifier une vue d'analyse, procédez comme suit :

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

   Accéder à Analyse de l'observabilité

   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 l'observabilité :
   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 l'observabilité (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 section Vues d'analyse data_table, puis sélectionnez la vue d'analyse que vous souhaitez modifier.

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

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

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

Supprimer une vue d'analyse

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

Pour supprimer une vue d'analyse, procédez comme suit :

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

   Accéder à Analyse de l'observabilité

   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 l'observabilité :
   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 l'observabilité (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 section data_table Vues d'analyse, puis sélectionnez la vue d'analyse que vous souhaitez supprimer.
4. Dans la barre d'outils Schéma, cliquez sur Afficher les options de la vue d'analyse, sélectionnez Supprimer la vue, puis complétez la boîte de dialogue.

Limites

Les limites suivantes s'appliquent aux vues d'analyse :

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

É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