Ce document explique comment capturer des métriques personnalisées côté client à l'aide d'OpenCensus. Les métriques personnalisées côté client peuvent vous aider à identifier la source de la latence dans votre système. Pour en savoir plus, consultez Identifier le point de latence.
Les bibliothèques clientes Spanner fournissent également des statistiques et des traces à l'aide du framework d'observabilité OpenCensus. Par défaut, le framework est désactivé.
Avant de capturer des métriques personnalisées, vous devez vous familiariser avec les métriques personnalisées associées à OpenCensus et disposer des bibliothèques de métriques OpenCensus et de l'exportateur Google Cloud Observability pour votre application.
Capturer la latence aller-retour du client
La latence aller-retour client correspond à la durée en millisecondes entre le premier octet de la requête API Spanner que le client envoie à la base de données et le dernier octet de la réponse que le client reçoit de la base de données. La requête API peut être envoyée via Google Front End (GFE) ou l'interface de l'API Cloud Spanner.
Vous pouvez capturer la latence aller-retour du client à l'aide du code suivant :
Java
Go
L'exemple de code ajoute la chaîne roundtrip_latency
au nom de la métrique lorsqu'elle est exportée vers Cloud Monitoring. Vous pouvez rechercher cette métrique dans Cloud Monitoring à l'aide de la chaîne ajoutée.
Capturer la latence GFE
La latence GFE correspond à la durée en millisecondes entre le moment où le réseau Google reçoit un appel de procédure à distance du client et le moment où le GFE reçoit le premier octet de la réponse.
Vous pouvez capturer la latence GFE à l'aide du code suivant :
Java
Go
L'exemple de code ajoute la chaîne spanner/gfe_latency
au nom de la métrique lorsqu'elle est exportée vers Cloud Monitoring. Vous pouvez rechercher cette métrique dans Cloud Monitoring à l'aide de la chaîne ajoutée.
Capturer la latence des requêtes API Cloud Spanner
La latence des requêtes de l'API Cloud Spanner correspond au temps en secondes entre le premier octet de la requête client reçu par l'interface de l'API Cloud Spanner et le dernier octet de la réponse envoyée par l'interface de l'API Cloud Spanner.
Cette métrique de latence est disponible dans les métriques Spanner de Cloud Monitoring.
Capturer la latence des requêtes
La latence des requêtes correspond à la durée (en millisecondes) d'exécution des requêtes SQL dans la base de données Spanner.
Vous pouvez capturer la latence des requêtes à l'aide du code suivant :
Java
Go
L'exemple de code ajoute la chaîne spanner/query_stats_elapsed
au nom de la métrique lorsqu'elle est exportée vers Cloud Monitoring. Vous pouvez rechercher cette métrique dans Cloud Monitoring à l'aide de la chaîne ajoutée.
Afficher les métriques dans l'explorateur de métriques
Dans la console Google Cloud , accédez à la page "Explorateur de métriques".
Sélectionnez votre projet.
Cliquez sur Sélectionner une métrique.
Recherchez une métrique de latence à l'aide des chaînes suivantes :
roundtrip_latency
: pour la métrique de latence aller-retour du client.spanner/gfe_latency
: pour la métrique de latence GFE.spanner/query_stats_elapsed
: pour la métrique de latence des requêtes.
Sélectionnez la métrique, puis cliquez sur Appliquer.
Pour en savoir plus sur le regroupement ou l'agrégation de votre métrique, consultez Créer des requêtes à l'aide de menus.
Étapes suivantes
Apprenez-en plus sur OpenCensus.
Découvrez comment utiliser les métriques pour diagnostiquer la latence.