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

Vous pouvez configurer Observability Analytics pour exécuter des requêtes de trace 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 ou 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.

Sauf si vous modifiez la configuration, la page Observability Analytics exécute les requêtes sur le moteur de requêtes par défaut, qui utilise des emplacements par défaut. Si vous modifiez la page Observability Analytics pour exécuter des requêtes sur le moteur BigQuery, vous pouvez configurer l'utilisation d'emplacements réservés. 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. 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'octroi à une vue spécifique. Si vous n'associez pas de condition à l'octroi 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 via 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é à 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 configurez la page Observability Analytics pour qu'elle utilise le moteur BigQuery dans un Google Cloud projet protégé par VPC Service Controls (contrôles de service de cloud privé virtuel), 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 Tarifs BigQuery.

Étape suivante