Suivre les attributs et les événements de la période

Les traces côté client, qui sont collectées en exécutant des RPC, fournissent plusieurs informations pour chaque requête d'un client, y compris des étendues avec des codes temporels indiquant quand le client a envoyé la requête RPC et quand il a reçu la réponse RPC. Les plages incluent la latence introduite par le réseau et le système client.

Les traces côté client peuvent inclure les informations suivantes:

Métadonnées du segment

ID du délai ID unique de ce segment
ID du délai parent ID du segment parent, non défini pour le délai racine
ID du projet ID du projet Google Cloud ayant ingéré la trace
Heure de début Heure de début de la période
Heure de fin Heure de fin du segment

Attributs du segment

Version du client
otel.scope.version Chaîne
Environnement client
gcp.firestore.memory_utilization double (pourcentage)
Propriétés de la connexion client
gcp.firestore.settings.channel.needs_credentials booléen
gcp.firestore.settings.channel.needs_endpoint booléen
gcp.firestore.settings.channel.needs_headers booléen
gcp.firestore.settings.channel.should_auto_close booléen
gcp.firestore.settings.channel.transport_name Exemple de chaîne "grpc"
gcp.firestore.settings.credentials.authentication_type par ex. : "OAuth2"
gcp.firestore.settings.host par ex. : "firestore.googleapis.com:443"
Propriétés de la base de données
gcp.firestore.settings.project_id chaîne
ID de projet Google Cloud contenant la base de données Firestore
gcp.firestore.settings.database_id chaîne
ID externe de la base de données (nom)
Paramètres des nouvelles tentatives RPC du client
gcp.firestore.settings.retrySettings.initial_retry_delay chaîne
Durée en secondes 0,01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts Entier (nombre)
gcp.firestore.settings.retrySettings.max_retry_delay chaîne
Durée en secondes 0,1 s
gcp.firestore.settings.retrySettings.max_rpc_timeout
gcp.firestore.settings.retrySettings.retry_delay_multiplier double
gcp.firestore.settings.retrySettings.rpc_timeout_multiplier double
gcp.firestore.settings.retrySettings.total_timeout chaîne
Durée en secondes
Configuration d'OpenTelemetry
otel.scope.name par ex. : "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language Exemple de chaîne "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version Ex. : 1.29.0

Journaux et événements

Les traces côté client fournissent les journaux et événements suivants.

Événements gRPC

Propriétés RPC
message.id Nombre entier, Ex. : 1, 2
message.type ENVOYÉ ou REÇU

Événements AggregateQuery

Événement : "RunAggregationQuery Stream Started" (Flux RunAggregationQuery démarré)
Tentative Nombre entier supérieur ou égal à 0 (ex. : 2). 0 pour la première tentative
Événement : "RunAggregationQuery Response Received."
Tentative Nombre entier supérieur ou égal à 0 (ex. : 2). 0 pour la première tentative
Événement : "RunAggregationQuery: Retryable Error."
error.message chaîne
Événement : "RunAggregationQuery : erreur"
error.message chaîne

Événements BatchGetDocuments

Événement : "BatchGetDocuments: Start"
doc_count Integer
transactional booléen
Événement : "BatchGetDocuments: First Response Received"
// Une fois toutes les 100 réponses reçues
Événement : "BatchGetDocuments : 100 réponses reçues"
Événement : "BatchGetDocuments: terminé avec ${N} réponses"
response_count Integer

Événements d'exécution de requête

Événement : "RunQuery"
transactional booléen
retry_query_with_cursor booléen
Événement : "RunQuery: First Response Received"
// Une fois toutes les 100 réponses reçues
Événement : "RunQuery: Received 100 documents" (Exécuter la requête : 100 documents reçus)
// Uniquement si/lorsque la demi-fermeture est effectuée par le serveur
Événement : "RunQuery : RunQueryResponse.Done reçu"
Événement : "RunQuery: Retryable Error" (Exécuter une requête : erreur pouvant être réessayée)
error.message chaîne
Événement : "RunQuery: Error."
error.message chaîne
Événement : "RunQuery: Completed."
response_count Integer

Événements de transaction

Portée : "Transaction.Run"
transaction_type chaîne ("READ_ONLY" ou "READ_WRITE")
attempts_allowed Integer
attempts_remaining Integer
// Uniquement si/quand une nouvelle tentative de transaction est effectuée
Événement : "Lancer une nouvelle tentative de transaction"

Valider les événements

Portée : "BulkWriter.Commit"
doc_count Integer
Span : "Batch.Commit"
doc_count Integer
Span : "Transaction.Commit"
doc_count Integer

Événement exceptionnel

État du segment = ERREUR
exception.message chaîne
exception.type chaîne
exception.stacktrace chaîne