Cette page fournit des informations générales sur la collecte de traces avec OpenTelemetry. Pour surveiller et déboguer les requêtes Spanner, vous pouvez activer les traces dans le Bibliothèques clientes Spanner. Le traçage côté client et de bout en bout peut vous aider à surveiller les performances et à déboguer les problèmes.
Les traces fournissent des informations pertinentes pour chaque requête d'un client, telles que:
Les segments avec les horodatages du moment où le client a envoyé une requête RPC et du moment où le client a reçu la réponse RPC, y compris la latence causée par le le réseau et le système client.
Attributs (paires clé-valeur) qui fournissent des informations sur le client et sa configuration.
Annotations avec des événements importants dans les segments
Pour en savoir plus sur les segments et les attributs, consultez les sections Segments et Attributs dans la documentation OpenTelemetry.
Traçage de bout en bout
En plus du traçage côté client, vous pouvez activer le traçage de bout en bout (Preview). Le traçage de bout en bout vous aide à comprendre et à déboguer les problèmes de latence spécifiques à Spanner, par exemple :
Déterminez si la latence est due à la latence réseau entre votre application et Spanner, ou si elle se produit dans Spanner.
Identifier les régions Google Cloud dans lesquelles sont traitées les requêtes de votre application et en cas de requête interrégionale. Une requête interrégionale entraîne généralement des latences plus élevées entre votre application et Spanner.
OpenTelementry
Les bibliothèques clientes Spanner prennent en charge la collecte de traces à l'aide des API OpenTelemetry. OpenTelemetry est un framework d'observabilité Open Source. OpenTelemetry propose un large éventail de configurations, telles que des exportateurs pour des backends spécifiques, des ratios d'échantillonnage et des limites de span.
Exporter des traces avec des exportateurs et des collecteurs
Dans le cadre de vos configurations, vous pouvez exporter vos traces vers un outil d'observabilité backend. La plupart des fournisseurs de services d'observabilité proposent des exportateurs à utiliser, comme l'exportateur de traces.
En plus d'un exportateur, OpenTelemetry recommande de configurer un collecteur. Un collecteur permet à votre service de décharger rapidement les données et de s'occuper de la gestion supplémentaire, comme les nouvelles tentatives, le traitement par lot et le chiffrement. Un collecteur s'exécute à côté de votre application. La le collecteur reçoit les messages OLTP, les traite et les exporte backend d'observabilité.
Limites
Les traces Spanner présentent les limites suivantes:
- Les plages de traçage ne sont disponibles que pour les bibliothèques clientes Java et Go.
- Les traces de bout en bout ne peuvent être exportées que vers Cloud Trace.
Facturation
Outre l'utilisation de Spanner, le traçage peut entraîner via votre backend d'observabilité.
L'ingestion de délais de trace dans le backend d'observabilité est facturée. Par exemple, si vous utilisez Cloud Trace comme backend, vous êtes facturé selon les tarifs de Cloud Trace.
Pour mieux comprendre la facturation, commencez par un faible ratio d'échantillonnage des traces en fonction de votre trafic.
Étape suivante
Pour configurer le traçage côté client et de bout en bout, consultez la page Configurer la collecte des traces à l'aide d'OpenTelemetry.