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

La configuration d'Analyse de l'observabilité pour exécuter vos requêtes Cloud Trace sur le moteur BigQuery vous permet de créer des règles d'alerte basées sur SQL et d'enregistrer des graphiques de tableau de bord dont les requêtes associent les données d'observabilité à d'autres données d'entreprise. Lorsque des requêtes sont exécutées sur le moteur BigQuery, elles utilisent par défaut des emplacements à la demande ou des emplacements réservés si votre projet dispose d'une attribution de réservation au même emplacement que l'ensemble de données associé.

Sauf si vous modifiez la configuration, la page Analyse de l'observabilité exécute des requêtes sur le moteur de requête par défaut, qui utilise des emplacements par défaut. Les deux moteurs vous permettent d'interroger des vues d'observabilité, des vues sur des buckets de journaux et des vues d'analyse.

Avant de commencer

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

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

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

    • Lecteur d'observabilité (roles/observability.viewer) sur le projet
    • 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'attribution à une vue spécifique. Si vous n'associez pas de condition à l'attribution du rôle, le compte principal peut accéder à toutes les vues d'observabilité.
    • Lecteur de données BigQuery (roles/bigquery.dataViewer) sur votre projet ou l'ensemble de données associé
    • 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.

  4. Vérifiez que vous disposez d'un ensemble de données BigQuery associé sur l'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 Analyse de l'observabilité pour utiliser le moteur BigQuery dans un projet Google Cloud protégé par Cloud privé virtuel (VPC) Service Controls, 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. 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 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 Tarifs de BigQuery.

Étapes suivantes