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 fournissent des informations sur la latence des requêtes RPC du client adressées à 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.

Avant de commencer

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

    Activer l'API Monitoring

  2. Pour vous assurer que votre compte de service dispose des autorisations nécessaires pour accéder aux métriques côté client, demandez à votre administrateur d'attribuer le rôle IAM Rédacteur de métriques Monitoring (roles/monitoring.metricWriter) à votre compte de service sur le projet.

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

    Ce rôle prédéfini contient l' monitoring.timeSeries.create autorisation, qui est requise pour accéder aux métriques côté client.

    Votre administrateur peut également attribuer cette autorisation à votre compte de service avec des rôles personnalisés ou d'autres rôles prédéfinis.

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

Vous pouvez accéder aux métriques côté client à l'aide des bibliothèques clientes suivantes :

  • Go en version 1.71.0 et ultérieure
  • Java en version 6.81.0 et ultérieure
  • Node en version 8.1.0 ou ultérieure
  • Python en version 3.60.0 ou ultérieure

Pour afficher les métriques côté client dans l'explorateur de métriques, procédez comme suit :

  1. Dans la Google Cloud console, 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 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 :

Go 

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

Java 

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

Node.js 

  const spanner = new Spanner({
      disableBuiltInMetrics: true
  });

Python 

spanner_client = spanner.Client(
    disable_builtin_metrics=True
)

Tarifs

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

Étape suivante