Afficher et gérer les métriques côté client

Cette page fournit des informations sur l'affichage et la gestion des métriques côté client. Les métriques côté client offrent des informations sur la latence des requêtes RPC du client à Spanner.

Spanner fournit des métriques côté client que vous pouvez utiliser avec des métriques côté serveur pour optimiser les performances et résoudre les problèmes de performances, le cas échéant.

Les métriques côté client sont mesurées entre le moment où une requête quitte votre application et le moment où votre application reçoit la réponse. En revanche, les métriques côté serveur sont mesurées entre le moment où Spanner reçoit une requête et celui où le dernier octet de données est envoyé au client.

Accéder aux métriques côté client

Les métriques côté client sont disponibles dans les bibliothèques clientes suivantes:

  • Java version 6.81.0 et ultérieure
  • Go version 1.71.0 et ultérieure.

Les métriques côté client sont disponibles une fois que vous avez activé l'API Cloud Monitoring.

Activer l'API Monitoring

Les métriques côté client sont disponibles pour les utilisateurs ou les comptes de service auxquels l'autorisation IAM monitoring.timeSeries.create est accordée. Cette autorisation est incluse dans les rôles IAM Spanner suivants:

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

Vous pouvez également obtenir l'autorisation IAM monitoring.timeSeries.create requise via des rôles personnalisés.

Afficher les métriques dans l'Explorateur de métriques

  1. Dans la console Google Cloud , accédez à la page "Explorateur de métriques".

    Accéder à l'explorateur de métriques

  2. Sélectionnez votre projet.

  3. Cliquez sur Sélectionner une métrique.

  4. Recherchez spanner.googleapis.com/client.

  5. Sélectionnez la métrique, puis cliquez sur Appliquer.

Pour en savoir plus sur le regroupement ou l'agrégation de votre métrique, consultez la page Créer des requêtes à l'aide de menus.

Votre application doit s'exécuter pendant au moins une minute avant que vous puissiez afficher les métriques publiées.

Désactiver les métriques côté client

Si vous utilisez déjà OpenTelemetry pour capturer des métriques client personnalisées, vous pouvez choisir de ne pas utiliser les métriques côté client à l'aide du code suivant:

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Go

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Coûts

L'affichage des métriques côté client dans Cloud Monitoring est gratuit. L'utilisation de l'API Monitoring peut entraîner des frais. Pour en savoir plus, consultez les tarifs de Google Cloud Observability.

Étape suivante