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

Ce document explique comment créer, gérer et interroger des vues d'analyse. Pour obtenir une présentation conceptuelle, consultez la section À propos des vues d'analyse.

Avant de commencer

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

  • 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 d'analyse de l'observabilité (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 d'analyse. 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 des journaux et utiliser Log Analytics, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet:

    Vous pouvez limiter un principal à une vue de journaux spécifique en ajoutant une condition IAM à l'attribution du rôle "Accès aux 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 la page 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 la section Rôles Cloud Logging.

Créer une vue d'analyse

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

  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 du , puis sélectionnez la vue de journal à interroger.

    Pour rechercher une vue de journal, vous pouvez utiliser la barre Filtrer ou faire défiler la liste des vues de journal. Chaque entrée de la liste est au format BUCKET_ID.LOG_VIEW_ID, où ces champs font référence aux ID du bucket de journaux et de la vue des 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 Log Analytics (par défaut).

  5. Modifiez 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, puis sélectionnez Enregistrer en tant que vue Analytics.

  7. Saisissez un nom et une description pour la vue d'analyse, 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.

    Votre vue Analytics est créée et listée dans le volet Vues, dans la section Vues Analytics. Chaque entrée de la liste se présente au format LOCATION.ANALYTICS_VIEW_ID, où ces champs font référence à l'emplacement et à l'ID d'une vue d'analyse. Par exemple, si vous avez créé une vue Analytics nommée my-analytic-view qui interroge une vue de journal 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 d'analyse existe, vous pouvez l'interroger de la même manière que vous le feriez pour une vue de journal. Pour obtenir la liste des documents qui expliquent comment utiliser la page Log Analytics, consultez la section Étapes suivantes de ce document.

Pour exécuter la requête par défaut d'une vue d'analyse, procédez comme suit:

  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 d'analyse. L'emplacement d'une vue d'analyse est hérité de la ressource qu'elle interroge. Par exemple, si une vue d'analyse interroge une vue de journal située dans l'emplacement global, l'emplacement de la vue d'analyse est également global.
    • ANALYTICS_VIEW_ID: ID de la vue d'analyse, limité à 100 caractères et ne pouvant contenir 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

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

    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 Analytics 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 Log Analytics (par défaut).

Répertorier les vues Analytics

Pour afficher 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 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.

    Une liste de vues Analytics s'affiche. Chaque entrée de la liste est au format LOCATION.ANALYTICS_VIEW_ID suivant, où ces champs font référence à l'emplacement et à l'ID d'une vue d'analyse. Par exemple, si vous avez créé une vue d'analyse nommée my-analytic-view qui interroge une vue de journal 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 d'analyse spécifique, procédez comme suit:

    1. Sélectionnez la vue "Analytics".

      Le schéma de la vue d'analyse s'affiche 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 d'analyse

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

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

  3. Dans la barre d'outils Schema (Schéma), cliquez sur View analytics view options (Afficher les options de vue des données analytiques), puis sélectionnez Edit view (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.

  4. Une fois les modifications effectuées, cliquez sur Remplacer la vue enregistrée.

Supprimer une vue d'analyse

Pour supprimer une vue d'analyse:

  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 de , puis sélectionnez la vue Analytics que vous souhaitez interroger.
  3. Dans la barre d'outils Schéma, cliquez sur Afficher les options de vue d'analyse, sélectionnez Supprimer la vue, puis renseignez la boîte de dialogue.

Limites

Les limites suivantes s'appliquent aux vues Analytics:

  • Une vue d'analyse ne peut pas interroger une autre vue d'analyse.
  • Une vue d'analyse 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 endroit. Par exemple, imaginons que vous disposiez de deux buckets de journaux, l'un dans us-east1 et l'autre dans asia-east1. Vous ne pouvez pas créer de vue d'analyse qui interroge les vues de journaux sur ces buckets de journaux.
  • La ressource parente d'une vue d'analyse 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 d'analyse que sur la page Analyse de journaux. Vous devez également exécuter ces requêtes sur le service Cloud Logging par défaut.
  • Les API ne permettent pas de créer ni de gérer des vues d'analyse.

  • Les limites suivantes s'appliquent aux vues Analytics:

    • Nombre maximal de vues Analytics par projet Google Cloud : 100
    • Nombre maximal de vues Analytics par région et par projet Google Cloud : 50
    • Nombre maximal de régions pouvant stocker des vues d'analyse par projet Google Cloud : 10

Étape suivante