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 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ê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 le Global Front End (GFE), puis l'interface de l'API Spanner (AFE). Pour en savoir plus, consultez 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
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 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.directpath_enabled: indique si la bibliothèque cliente est configurée pour accéder directement à Spanner sans passer par l'interface.directpath_used: indique si la requête actuelle a été envoyée directement à Spanner sans passer par l'interface. Une valeurfalselorsquedirectpath_enabledesttrueindique que la requête est revenue au chemin standard passant par le GFE.
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 possède 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 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 possède 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 valeur operation_count.
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 possède 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 seule requête RPC pour atteindre Spanner depuis le 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.
La métrique des latences des tentatives possède 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 possède 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 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 au handshake TCP/SSL.
La métrique des latences GFE possède 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 possède 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 possède les attributs suivants :
Metric name:spanner.googleapis.com/client/operation_latenciesMetric value type:DISTRIBUTION