Dépannage

Ce document vous aidera à résoudre les problèmes courants lorsque vous utilisez Cloud Trace, comme les données de span manquantes, les échecs de requêtes dans Observability Analytics et les erreurs de validation lors de la création de règles d'alerte.

Problèmes connus

Cette section répertorie les problèmes connus :

  • Les spans écrits dans votre projet Google Cloud à l'aide de l'API Telemetry ne sont pas accessibles à l'API Cloud Trace. Par exemple, si vous essayez de lister ces traces, la commande échoue et renvoie une erreur 404 Not Found.

Résoudre les problèmes liés à Observability Analytics

Cette section explique comment résoudre les échecs que vous pouvez rencontrer lorsque vous utilisez Observability Analytics pour interroger vos données de trace.

Vous ne pouvez pas enregistrer votre règle d'alerte en raison d'une erreur de validation.

Vous essayez d'enregistrer une règle d'alerte qui surveille vos données de trace et vous recevez une erreur semblable à la suivante :

The following error occurred when validating your SQL Alert: Error authenticating service account `service-12345@gcp-sa-monitoring-notification.iam.gserviceaccount.com`. BigQuery returned an error.

Ce message d'erreur indique que le compte de service de surveillance ne dispose pas des autorisations requises ou n'existe pas. Ce compte est créé automatiquement par le système lorsque certaines actions initiées par l'utilisateur se produisent. Toutefois, si l'API Cloud Monitoring est désactivée, le système ne peut pas créer le compte de service.

Pour résoudre ce problème, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page API et services, puis activez l'API Cloud Monitoring :

    Accéder à API et services

  2. Dans la console Google Cloud , accédez à la page IAM :

    Accéder à IAM

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

  3. Sur la page IAM, procédez comme suit :

    1. Sélectionnez Inclure les attributions de rôles fournies par Google.

    2. Si le compte de service Monitoring n'est pas listé, créez une règle d'alerte basée sur SQL et essayez de l'enregistrer.

      Lorsque vous enregistrez la règle, le système crée le compte de service de surveillance. L'action d'enregistrement échoue, car ce compte de service ne dispose pas des rôles IAM requis.

    3. Attribuez les rôles suivants au compte de service Monitoring :