Cette page fournit une description détaillée de chaque métrique côté client proposée par Spanner. Pour savoir comment afficher et gérer les 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 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'exécution 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 Google 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 ou Go.
Les métriques côté client sont compatibles avec toutes les méthodes Spanner de l'API RPC google.spanner.v1.Spanner.
Toutes les métriques côté client comportent les dimensions suivantes :
project ID: ID du projet Google Cloud .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égionglobal.method: nom de la méthode RPC, par exemplespanner.commit.status: état du RPC (par exemple,OKouINTERNAL).client_name: nom et version de la bibliothèque, par exemple,spanner-java/6.70.1.
Nombre d'erreurs de connectivité AFE
La métrique "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 "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 de latence 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 de latence AFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/afe_latenciesMetric value type:DISTRIBUTION
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.
La métrique "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 de latence 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 "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 "Nombre d'erreurs de connectivité GFE" enregistre le nombre de requêtes RPC qui n'ont pas pu atteindre le GFE.
La métrique "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 de latence GFE mesure le temps écoulé entre le moment où le GFE reçoit la requête RPC du client et celui 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 de latence GFE présente les attributs suivants :
Metric name:spanner.googleapis.com/client/gfe_latenciesMetric value type:DISTRIBUTION
Nombre d'opérations
La métrique "Nombre d'opérations" enregistre le nombre d'opérations effectuées toutes les 60 secondes.
La métrique "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 de latence 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 "Latences des opérations" présente les attributs suivants :
Metric name:spanner.googleapis.com/client/operation_latenciesMetric value type:DISTRIBUTION