Exécuter des requêtes de trace sur le moteur BigQuery

Ce document explique comment configurer la page Observability Analytics pour exécuter des requêtes sur le moteur BigQuery. Vous devez exécuter des requêtes sur le moteur BigQuery lorsque vous avez des règles d'alerte basées sur SQL. Vous devez également utiliser ce moteur de requête lorsque vous enregistrez des graphiques basés sur SQL dans un tableau de bord et que la requête joint des données d'observabilité et d'autres données d'entreprise.

Par défaut, la page Observability Analytics exécute des requêtes sur le moteur de requêtes par défaut, qui utilise les emplacements par défaut pour exécuter vos requêtes. Le moteur BigQuery exécute également des requêtes sur les emplacements par défaut, sauf si vous réservez des emplacements. La réservation d'emplacements peut éliminer les retards qui peuvent survenir lorsque les emplacements par défaut sont occupés au moment où vous envoyez votre requête.

Que vous utilisiez le moteur de requête par défaut ou le moteur BigQuery, vous pouvez interroger les vues d'observabilité, les vues sur les buckets de journaux et les vues d'analyse.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  6. Pour obtenir les autorisations nécessaires pour exécuter des requêtes à partir d'Observability Analytics à l'aide du moteur BigQuery, demandez à votre administrateur de vous accorder les rôles IAM suivants :

    • Accesseur de vue d'observabilité (roles/observability.viewAccessor) sur les vues d'observabilité que vous souhaitez interroger. Ce rôle est compatible avec les conditions IAM, qui vous permettent de limiter l'accès à une vue spécifique. Si vous n'associez pas de condition à l'attribution de rôle, le compte principal peut accéder à toutes les vues d'observabilité.
    • Utilisateur BigQuery (roles/bigquery.user) sur votre projet
    • Utilisateur de job BigQuery (roles/bigquery.jobUser) sur votre projet

    Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

    Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

  7. Vérifiez que vous disposez d'un ensemble de données BigQuery associé dans votre ensemble de données d'observabilité, qui stocke vos données de trace. Si l'ensemble de données BigQuery associé n'existe pas, créez-le.

Si vous prévoyez de configurer la page Observability Analytics pour exécuter des requêtes sur le moteur BigQuery et si vous utilisez des projets avec VPC Service Controls, vérifiez que vous utilisez l'édition Enterprise de BigQuery. Pour en savoir plus, consultez Comprendre les éditions BigQuery.

Exécuter des requêtes sur le moteur BigQuery

Pour exécuter une requête sur le moteur BigQuery lorsque vous utilisez la page Analyse de l'observabilité, procédez comme suit :

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

    Accéder à Observability Analytics

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez ou chargez une requête. Pour en savoir plus, consultez Interroger et analyser des traces.

    Vous pouvez enregistrer un graphique dans un tableau de bord où il affiche le résultat d'une jointure entre les données d'observabilité et d'autres données d'entreprise. Dans ce cas, la clause FROM doit spécifier une vue sur un ensemble de données d'observabilité ou une vue sur un bucket de journaux. De plus, un ensemble de données associé doit exister pour les données interrogées. L'instruction JOIN peut spécifier une table BigQuery. Toutefois, vous devez disposer des autorisations IAM requises pour interroger la table BigQuery.

  3. Accédez à la barre d'outils et vérifiez qu'un bouton intitulé Exécuter sur BigQuery s'affiche.

    Si la barre d'outils affiche Exécuter la requête, cliquez sur Paramètres, puis sélectionnez BigQuery.

    Si le bouton Exécuter sur BigQuery est désactivé, cela signifie qu'aucun ensemble de données n'est associé. Pour résoudre ce problème, créez l'ensemble de données BigQuery associé.

  4. Cliquez sur Exécuter sur BigQuery.

Tarifs

Pour en savoir plus sur les coûts associés à l'utilisation de BigQuery, consultez la page Tarifs de BigQuery.

Étapes suivantes