Description des métriques côté client

Cette page fournit une description détaillée de chaque métrique côté client proposée par Spanner. Pour en savoir plus sur l'affichage et la gestion des métriques côté client, consultez la section Afficher et gérer les métriques côté client.

Les métriques côté client fournissent des informations sur la latence des tentatives et des opérations de requêtes RPC du client auprès de Spanner.

Une tentative correspond à une seule requête RPC du client à Spanner. Le client peut effectuer plusieurs tentatives si une requête échoue.

Une opération représente l'achèvement de toutes les requêtes RPC, y compris toutes les tentatives du client auprès de Spanner. Une opération est terminée lorsque le client reçoit une réponse ou a épuisé toutes les tentatives.

Ces métriques incluent les types de valeurs de métrique DISTRIBUTION et INT64. Pour en savoir plus, consultez la section Types de valeurs et genres de métriques.

Les métriques côté client sont disponibles lorsque vous utilisez la bibliothèque cliente Spanner pour Java ou Go.

Les métriques côté client sont compatibles avec toutes les méthodes Spanner disponibles dans l'API RPC google.spanner.v1.Spanner.

Latences des opérations

La métrique "Latences des opérations" mesure l'aller-retour d'une opération depuis la couche gRPC du client vers Spanner, puis vers le client.

Cette métrique comporte les attributs suivants:

  • Metric name : spanner.googleapis.com/client/operation_latencies
  • Metric value type : DISTRIBUTION
  • Dimensions disponibles :
    • project ID: l' ID de projet .
    • instance ID: ID de l'instance Spanner.
    • database ID: ID de la base de données Spanner.
    • location: région Google Cloud dans laquelle les métriques côté client sont publiées. Si votre application est déployée en dehors de Google Cloud, les métriques sont publiées dans la région global.
    • method: nom de la méthode RPC (par exemple, spanner.commit).
    • status: état de la RPC (par exemple, OK ou INTERNAL).
    • client_name: nom et version de la bibliothèque (par exemple, spanner-java/6.70.1).

Nombre d'opérations

La métrique "Nombre d'opérations" enregistre le nombre d'opérations effectuées.

Cette métrique comporte les attributs suivants:

  • Metric name : spanner.googleapis.com/client/operation_count
  • Metric value type : INT64
  • Dimensions disponibles :
    • project ID: l' ID de projet .
    • instance ID: ID de l'instance Spanner.
    • database ID: ID de la base de données Spanner.
    • location: région Google Cloud dans laquelle les métriques côté client sont publiées. Si votre application est déployée en dehors de Google Cloud, les métriques sont publiées dans la région global.
    • method: nom de la méthode RPC (par exemple, spanner.commit).
    • status: état de la RPC (par exemple, OK ou INTERNAL).
    • client_name: nom et version de la bibliothèque. Exemple : spanner-java/6.70.1.

Latences des tentatives

La métrique "Latences des tentatives" mesure la durée nécessaire pour qu'une seule requête RPC atteigne Spanner à partir du client. La valeur attempt_latencies est généralement identique à la valeur operation_latencies. Si le client reçoit des erreurs temporaires, la valeur operation_latencies correspond à la somme de toutes les valeurs attempt_latencies.

Cette métrique comporte les attributs suivants:

  • Metric name : spanner.googleapis.com/client/attempt_latencies
  • Metric value type : DISTRIBUTION
  • Dimensions disponibles :
    • project ID: l' ID de projet .
    • instance ID: ID de l'instance Spanner.
    • database ID: ID de la base de données Spanner.
    • location: région Google Cloud où les métriques côté client sont publiées. Si votre application est déployée en dehors de Google Cloud, les métriques sont publiées dans la région global.
    • method: nom de la méthode RPC (par exemple, spanner.commit).
    • status: état de la RPC (par exemple, OK ou INTERNAL).
    • client_name: nom et version de la bibliothèque. Exemple : spanner-java/6.70.1.

Nombre de tentatives

La métrique "Nombre de tentatives" enregistre le nombre de tentatives effectuées. La valeur attempt_count est généralement identique à la valeur operation_count. Si le client reçoit des erreurs temporaires, la valeur attempt_count correspond à la somme de toutes les tentatives.

Cette métrique comporte les attributs suivants:

  • Metric name : spanner.googleapis.com/client/attempt_count
  • Metric value type : INT64
  • Dimensions disponibles :
    • project ID: l' ID de projet .
    • instance ID: ID de l'instance Spanner.
    • database ID: ID de la base de données Spanner.
    • location: région Google Cloud où les métriques côté client sont publiées. Si votre application est déployée en dehors de Google Cloud, les métriques sont publiées dans la région global.
    • method: nom de la méthode RPC (par exemple, spanner.commit).
    • status: état de la RPC (par exemple, OK ou INTERNAL).
    • client_name: nom et version de la bibliothèque. Exemple : spanner-java/6.70.1.

Étape suivante