Attributs et événements de délai de trace

Les traces côté client, collectées en exécutant des RPC, fournissent plusieurs informations pour chaque requête d'un client, y compris des délais 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 délais 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 de délai

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

Attributs de délai

Version du client
otel.scope.version Chaîne
Environnement client
gcp.firestore.memory_utilization double (pourcentage)
Propriétés de connexion du 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 chaîne Ex. : "grpc"
gcp.firestore.settings.credentials.authentication_type chaîne Ex. : "OAuth2"
gcp.firestore.settings.host chaîne Ex. : "firestore.googleapis.com:443"
Propriétés de la base de données
gcp.firestore.settings.project_id chaîne
Google Cloud ID du projet 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 de nouvelle tentative RPC du client
gcp.firestore.settings.retrySettings.initial_retry_delay chaîne
Durée en secondes Ex. : 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 Ex. : 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 OpenTelemetry
otel.scope.name chaîne Ex. : "com.google.cloud.firestore"
service.name Médor
telemetry.sdk.language chaîne Ex. : "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 entier, Ex. : 1, 2
message.type SENT ou RECEIVED

Événements AggregateQuery

Événement : "RunAggregationQuery Stream Started."
Tentative Entier supérieur ou égal à 0 (Ex. : 2). 0 pour la tentative initiale
Événement : "RunAggregationQuery Response Received."
Tentative Entier supérieur ou égal à 0 (Ex. : 2). 0 pour la tentative initiale
Événement : "RunAggregationQuery: Retryable Error."
error.message chaîne
Événement : "RunAggregationQuery: Error."
error.message chaîne

Événements BatchGetDocuments

Événement : "BatchGetDocuments: Start"
doc_count Entier
transactionnelles booléen
Événement : "BatchGetDocuments: First Response Received"
// Une fois toutes les 100 réponses reçues
Événement : "BatchGetDocuments: Received 100 responses"
Événement : "BatchGetDocuments: Completed with ${N} responses"
response_count Entier

Événements RunQuery

Événement : "RunQuery"
transactionnelles booléen
retry_query_with_cursor booléen
Événement : "RunQuery: First Response Received"
// Une fois tous les 100 documents reçus
Événement : "RunQuery: Received 100 documents"
// Uniquement si/lorsque le serveur effectue une fermeture partielle
Événement : "RunQuery: Received RunQueryResponse.Done"
Événement : "RunQuery: Retryable Error."
error.message chaîne
Événement : "RunQuery: Error."
error.message chaîne
Événement : "RunQuery: Completed."
response_count Entier

Événements de transaction

Délai : "Transaction.Run"
transaction_type chaîne ("READ_ONLY" ou "READ_WRITE")
attempts_allowed Entier
attempts_remaining Entier
// Uniquement si/lorsqu'une nouvelle tentative de transaction est effectuée
Événement : "Initiate transaction retry"

Événements de commit

Délai : "BulkWriter.Commit"
doc_count Entier
Délai : "Batch.Commit"
doc_count Entier
Délai : "Transaction.Commit"
doc_count Entier

Événement exceptionnel

État du délai = ERROR
exception.message chaîne
exception.type chaîne
exception.stacktrace chaîne