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 desopérations de requête RPC du client vers Spanner.
Une tentative est une requête RPC unique du client vers 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 effectuées par le client auprès de Spanner. Une opération est terminée lorsque le client reçoit une réponse ou épuise toutes les tentatives.
Une requête RPC atteint d'abord l'interface Google (GFE), puis l' interface de l'API Spanner (AFE). Pour en savoir plus, consultez la section Points de latence dans une requête Spanner.
Ces métriques incluent les types de valeurs de métriques DISTRIBUTION et INT64. Pour en savoir plus, consultez la section
Types de valeurs et genres de métriques.
Vous pouvez accéder aux métriques côté client à l'aide des bibliothèques clientes Spanner pour Java, Go, Node.js et Python.
Les métriques côté client sont compatibles avec toutes les méthodes Spanner de
l'google.spanner.v1.Spanner
API RPC.
Toutes les métriques côté client présentent les dimensions suivantes :
project ID: ID du Google Cloud projet.instance ID: ID de l'instance Spanner.database ID: ID de la base de données Spanner.location: région où les métriques côté client sont publiées. Google Cloud Si votre application est déployée en dehors de cette région Google Cloud, les métriques sont publiées dans la régionglobal.method: nom de la méthode RPC, par exemplespanner.commit.status: état RPC, par exempleOKouINTERNAL.client_name: nom et version de la bibliothèque, par exemplespanner-java/6.70.1.
Nombre d'erreurs de connectivité AFE
La métrique du nombre d'erreurs de connectivité AFE enregistre le nombre de requêtes RPC qui n'ont pas pu atteindre l'AFE Spanner.
La métrique du nombre d'erreurs de connectivité AFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/afe_connectivity_error_countMetric value type:INT64
Latences AFE
La métrique des latences AFE mesure le temps écoulé entre le moment où l'AFE Spanner reçoit la requête RPC du client et le moment où l'AFE Spanner commence à écrire la réponse.
La métrique des latences AFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/afe_latenciesMetric value type:DISTRIBUTION
Nombre de tentatives
La métrique du nombre de tentatives enregistre le nombre de tentatives effectuées. La valeur
attempt_count est généralement identique à la operation_count valeur.
Si le client reçoit des erreurs temporaires, la valeur attempt_count correspond à la somme
de toutes les tentatives.
La métrique du nombre de tentatives présente les attributs suivants :
Metric name:spanner.googleapis.com/client/attempt_countMetric value type:INT64
Latences des tentatives
La métrique des latences des tentatives mesure la durée nécessaire à une requête
RPC unique pour atteindre Spanner depuis le client.
La valeur attempt_latencies est généralement identique à la
operation_latencies valeur. Si le client reçoit des erreurs temporaires, la valeur
operation_latencies correspond à la somme de toutes les valeurs attempt_latencies.
La métrique des latences des tentatives présente les attributs suivants :
Metric name:spanner.googleapis.com/client/attempt_latenciesMetric value type:DISTRIBUTION
Nombre d'erreurs de connectivité GFE
La métrique du nombre d'erreurs de connectivité GFE enregistre le nombre de requêtes RPC qui n'ont pas pu atteindre le GFE.
La métrique du nombre d'erreurs de connectivité GFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/gfe_connectivity_error_countMetric value type:INT64
Latences GFE
La métrique des latences GFE mesure le temps écoulé entre le moment où le GFE reçoit la requête RPC du client et le moment où il reçoit le premier octet de la réponse. Cette métrique ne tient pas compte du temps nécessaire à une négociation TCP/SSL
La métrique des latences GFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/gfe_latenciesMetric value type:DISTRIBUTION
Nombre d'opérations
La métrique du nombre d'opérations enregistre le nombre d'opérations effectuées toutes les 60 secondes.
La métrique du nombre d'opérations présente les attributs suivants :
Metric name:spanner.googleapis.com/client/operation_countMetric value type:INT64
Latences des opérations
La métrique des latences des opérations mesure l'aller-retour d'une opération depuis la couche gRPC du client vers Spanner, puis retourne au client.
La métrique des latences des opérations présente les attributs suivants :
Metric name:spanner.googleapis.com/client/operation_latenciesMetric value type:DISTRIBUTION