Exécuter des requêtes 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 disposez de règles d'alerte basées sur SQL. Vous devez également utiliser ce moteur de requêtes 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 supprimer les retards qui peuvent survenir, car les emplacements par défaut sont occupés lorsque vous envoyez votre requête.

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

Avant de commencer

  1. Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. 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. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. 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

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

  7. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

  8. Pour obtenir les autorisations nécessaires pour exécuter des requêtes à partir d'Observability Analytics à l'aide d'emplacements 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'octroi à 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.

  9. Vérifiez que l' ensemble de données BigQuery associé au bucket d'observabilité nommé _Trace existe. 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 vos emplacements BigQuery et que 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 Observability Analytics, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la Observability Analytics page :

    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 des 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, et il doit également exister un ensemble de données associé 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 libellé Exécuter sur BigQuery s'affiche.

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

    Un bouton Exécuter sur BigQuery désactivé indique qu'il n'existe pas d'ensemble de données 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.

Étape suivante