Utiliser le traçage distribué

Toutes les requêtes entrantes vers une fonction Cloud Run génèrent automatiquement un ensemble de base de données de trace, pour vous aider à mesurer les informations temporelles et à identifier les causes de latence dans votre fonction.

Pour un traçage plus détaillé, vous pouvez ajouter une instrumentation supplémentaire à votre fonction Cloud Run. Cela vous permet de mesurer le temps nécessaire à la requête pour effectuer différentes sous-opérations dans votre fonction, telles que les requêtes de base de données, les requêtes API ou une logique métier complexe. Chacune de ces mesures temporelles spécifiques à une couche est appelée un segment.

Cloud Trace vous permet d'afficher une analyse de vos traces.

Taux d'échantillonnage des traces

Les fonctions Cloud Run effectuent le traçage à une fréquence maximale d'une requête par intervalle de 10 secondes, pour chaque instance de fonction Cloud Run. Vous pouvez également forcer le traçage d'une requête particulière.

Frais

Les traces générées automatiquement, qu'elles résultent d'un échantillonnage ou d'un forçage, n'entraînent pas de frais. Toutefois, si vous utilisez des bibliothèques Cloud Trace et que vous ajoutez vos propres segments en les mettant en corrélation avec les segments fournis par les fonctions Cloud Run, vous serez soumis à facturation via Cloud Trace.

Quand ajouter l'instrumentation ?

Si vous avez besoin de plus d'informations de traçage que celles correspondant aux données de trace générées automatiquement, vous devez ajouter un code d'instrumentation à votre service pour activer le traçage supplémentaire. Vous devez par exemple ajouter une instrumentation en vue de :

  • définir des segments de trace personnalisés, par exemple pour surveiller le temps nécessaire à votre service pour obtenir des résultats à partir des requêtes API ;
  • Propager le contexte de trace afin que Cloud Trace affiche le flux de requêtes sur plusieurs services en une seule requête.

Pour ajouter une instrumentation, consultez la section Instrumenter le traçage des applications.

Afficher vos traces

Pour afficher une analyse de vos données de trace, consultez la section Afficher les traces.