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 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 vers Spanner.

Une tentative est une requête RPC unique du client vers Spanner. Le client peut effectuer plusieurs tentatives en cas d'échec d'une requête.

Une opération représente l'achèvement de toutes les requêtes RPC, y compris toutes les tentatives effectuées par le client vers 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 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.

Le client calcule les métriques de latence GFE et de latence AFE à partir des informations de temps que le GFE et l'AFE ajoutent aux en-têtes de réponse. Si une tentative se termine avant que le client ne reçoive les en-têtes de réponse, le client n'enregistre pas d'échantillon de latence GFE ou AFE pour cette tentative. Par exemple, cela se produit lorsque le délai avant expiration de la requête est dépassé et que le client renvoie une erreur DEADLINE_EXCEEDED. À la place, le client incrémente la métrique de nombre d'erreurs de connectivité correspondante. Par conséquent, les distributions de latence GFE et AFE n'incluent que les tentatives ayant reçu des en-têtes de réponse et peuvent sembler normales même lorsque de nombreuses tentatives expirent.

Le client n'enregistre les métriques GFE que pour les requêtes qui passent par le GFE. Si une requête utilise DirectPath (directpath_used est true), le client n'enregistre pas la latence GFE ni le nombre d'erreurs de connectivité GFE pour cette requête.

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'API RPC google.spanner.v1.Spanner.

Toutes les métriques côté client ont 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égion global.
  • method : nom de la méthode RPC, par exemple spanner.commit.
  • status : état RPC (par exemple, OK ou INTERNAL).
  • client_name : nom et version de la bibliothèque, par exemple spanner-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 valeur false alors que directpath_enabled est true indique que la requête a été redirigée vers le chemin d'accès 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 tentatives pour lesquelles le client n'a pas reçu d'informations de timing AFE Spanner dans les en-têtes de réponse. Cela se produit, par exemple, lorsque la requête n'atteint pas l'AFE ou lorsque la tentative expire avant que le client ne reçoive les en-têtes de réponse. La métrique Latences AFE n'enregistre pas d'échantillon pour ces tentatives.

La métrique du nombre d'erreurs de connectivité AFE comporte les attributs suivants :

  • Metric name : spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type : INT64

Latences du frontal analogique

La métrique des latences AFE mesure le temps écoulé entre la réception de la requête RPC du client par l'AFE Spanner et le début de l'écriture de la réponse par l'AFE Spanner.

Le client calcule cette valeur à partir des informations de temps dans les en-têtes de réponse. Si une tentative se termine avant que le client ne reçoive les en-têtes de réponse, le client n'enregistre pas d'échantillon et incrémente la métrique Nombre d'erreurs de connectivité AFE à la place.

La métrique des latences AFE comporte les attributs suivants :

  • Metric name : spanner.googleapis.com/client/afe_latencies
  • Metric 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 est la somme de toutes les tentatives.

La métrique "Nombre de tentatives" présente les attributs suivants :

  • Metric name : spanner.googleapis.com/client/attempt_count
  • Metric value type : INT64

Latences des tentatives

La métrique des latences de tentative mesure la durée d'une seule tentative RPC, depuis l'envoi de la requête par le client jusqu'à la réussite ou l'échec de la tentative. 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 est 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_latencies
  • Metric value type : DISTRIBUTION

Nombre d'erreurs de connectivité GFE

La métrique du nombre d'erreurs de connectivité GFE enregistre le nombre de tentatives pour lesquelles le client n'a pas reçu d'informations de chronométrage GFE dans les en-têtes de réponse. Cela se produit, par exemple, lorsque la requête n'atteint pas le GFE ou lorsque la tentative expire avant que le client ne reçoive les en-têtes de réponse. La métrique Latences GFE n'enregistre pas d'échantillon pour ces tentatives.

La métrique du nombre d'erreurs de connectivité GFE comporte les attributs suivants :

  • Metric name : spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type : INT64

Latences GFE

La métrique des latences GFE mesure le temps écoulé entre la réception de la requête RPC du client par le GFE et la réception du premier octet de la réponse par le GFE. Cette métrique n'inclut pas le temps nécessaire à l'établissement d'une liaison TCP ou TLS.

Le client calcule cette valeur à partir des informations de temps dans les en-têtes de réponse. Si une tentative se termine avant que le client ne reçoive les en-têtes de réponse, le client n'enregistre pas d'échantillon et incrémente la métrique Nombre d'erreurs de connectivité GFE à la place. Si le nombre d'erreurs de connectivité GFE augmente, les latences GFE qui semblent normales ne signifient pas que la latence est faible.

La métrique des latences GFE comporte les attributs suivants :

  • Metric name : spanner.googleapis.com/client/gfe_latencies
  • Metric 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 "Nombre d'opérations" présente les attributs suivants :

  • Metric name : spanner.googleapis.com/client/operation_count
  • Metric 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 vers le client.

La métrique "Latences des opérations" présente les attributs suivants :

  • Metric name : spanner.googleapis.com/client/operation_latencies
  • Metric value type : DISTRIBUTION

Étapes suivantes