Attributs et événements de portée de trace

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 spans 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 portées 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 portée

ID du délai ID unique de cette étendue
ID du délai parent ID du segment parent (non défini pour le segment racine)
ID du projet Google Cloud ID du projet qui a ingéré la trace
Heure de début Heure de début de la période
Heure de fin Heure de fin de la période

Attributs de portée

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 string
Google Cloud ID du projet contenant la base de données Firestore
gcp.firestore.settings.database_id string
ID externe (nom) de la base de données
Paramètres de nouvelle tentative RPC du client
gcp.firestore.settings.retrySettings.initial_retry_delay string
Durée en secondes (par exemple, 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 string
Durée en secondes (par exemple, 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 string
Durée en secondes
Configuration OpenTelemetry
otel.scope.name chaîne Ex. "com.google.cloud.firestore"
service.name Sparky
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, par exemple 1, 2
message.type ENVOYÉ ou REÇU

Événements AggregateQuery

Événement : "Le flux RunAggregationQuery a démarré."
Tentative Nombre entier supérieur ou égal à 0 (par exemple, 2). 0 pour la première tentative
Événement : "Réponse RunAggregationQuery reçue"
Tentative Nombre entier supérieur ou égal à 0 (par exemple, 2). 0 pour la première tentative
Événement : "RunAggregationQuery : erreur pouvant être corrigée."
error.message chaîne
Événement : "RunAggregationQuery : erreur"
error.message chaîne

Événements BatchGetDocuments

Événement : "BatchGetDocuments : Start"
doc_count Integer
transactionnelles booléen
Événement : "BatchGetDocuments : première réponse reçue"
// Une fois que 100 réponses ont été reçues
Événement : "BatchGetDocuments : 100 réponses reçues"
Événement : "BatchGetDocuments : terminé avec ${N} réponses"
response_count Integer

Événements RunQuery

Événement : "RunQuery"
transactionnelles booléen
retry_query_with_cursor booléen
Événement : "RunQuery: First Response Received"
// Une fois que 100 réponses ont été reçues
Événement : "RunQuery : 100 documents reçus"
// Only if/when half-close is performed by the server
Event: "RunQuery: Received RunQueryResponse.Done"
Événement : "RunQuery : erreur pouvant être corrigée par une nouvelle tentative"
error.message chaîne
Événement : "RunQuery : erreur"
error.message chaîne
Événement : "RunQuery : terminé"
response_count Integer

Événements de transaction

Span : "Transaction.Run"
transaction_type string ("READ_ONLY" ou "READ_WRITE")
attempts_allowed Integer
attempts_remaining Integer
// Only if/when a transaction is retried
Event: "Initiate transaction retry"

Événements de commit

Span: "BulkWriter.Commit"
doc_count Integer
Span: "Batch.Commit"
doc_count Integer
Span : "Transaction.Commit"
doc_count Integer

Événement exceptionnel

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