Attributi e eventi di span traccia

Le tracce lato client, che vengono raccolte tramite l'esecuzione di RPC, forniscono diverse informazioni per ogni richiesta di un client, inclusi gli intervalli con i timestamp del momento in cui il client ha inviato la richiesta RPC e quando ha ricevuto la risposta RPC. Gli intervalli includono la latenza introdotta dalla rete e dal sistema client.

Le tracce lato client possono includere le seguenti informazioni:

Metadati degli intervalli

ID intervallo ID univoco di questo intervallo
ID intervallo padre ID dell'intervallo principale, non impostato per l'intervallo radice
ID progetto Google Cloud ID progetto che ha importato la traccia
Ora di inizio Ora di inizio dell'intervallo
Ora di fine Ora di fine intervallo

Attributi intervallo

Versione client
otel.scope.version Stringa
Ambiente client
gcp.firestore.memory_utilization Doppio (percentuale)
Proprietà di connessione dei clienti
gcp.firestore.settings.channel.needs_credentials boolean
gcp.firestore.settings.channel.needs_endpoint boolean
gcp.firestore.settings.channel.needs_headers boolean
gcp.firestore.settings.channel.should_auto_close boolean
gcp.firestore.settings.channel.transport_name Es. di stringa "grpc"
gcp.firestore.settings.credentials.authentication_type Es. di stringa "OAuth2"
gcp.firestore.settings.host Es. di stringa "firestore.googleapis.com:443"
Proprietà del database
gcp.firestore.settings.project_id stringa
Google Cloud ID progetto contenente il database Firestore
gcp.firestore.settings.database_id string
ID esterno (nome) del database
Impostazioni di ripetizione RPC del client
gcp.firestore.settings.retrySettings.initial_retry_delay stringa
Durata in secondi Es. 0,01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts numero intero (conteggio)
gcp.firestore.settings.retrySettings.max_retry_delay stringa
Durata in secondi Es. 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 stringa
Durata in secondi
Configurazione di OpenTelemetry
otel.scope.name Es. di stringa "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language Es. di stringa "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version Ad es. 1.29.0

Log ed eventi

Le tracce lato client forniscono i seguenti log ed eventi.

Eventi gRPC

Proprietà RPC
message.id numero intero, ad es. 1, 2
message.type INVIATE o RICEVUTE

Eventi AggregateQuery

Evento: "RunAggregationQuery Stream Started".
tentativo Numero intero maggiore o uguale a 0 (ad es. 2). 0 per il tentativo iniziale
Evento: "RunAggregationQuery Response Received".
tentativo Numero intero maggiore o uguale a 0 (ad es. 2). 0 per il tentativo iniziale
Evento: "RunAggregationQuery: Retryable Error".
error.message string
Evento: "RunAggregationQuery: Error".
error.message string

Eventi BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count Numero intero
transactional boolean
Evento: "BatchGetDocuments: First Response Received"
// Ogni 100 risposte ricevute
Evento: "BatchGetDocuments: Received 100 responses"
Evento: "BatchGetDocuments: Completed with ${N} responses"
response_count Numero intero

Eventi RunQuery

Evento: "RunQuery"
transactional boolean
retry_query_with_cursor boolean
Evento: "RunQuery: First Response Received"
// Una volta ogni 100 risposte ricevute
Evento: "RunQuery: Received 100 documents"
// Solo se/quando la chiusura parziale viene eseguita dal server
Evento: "RunQuery: Received RunQueryResponse.Done"
Evento: "RunQuery: Retryable Error".
error.message string
Evento: "RunQuery: Error".
error.message string
Evento: "RunQuery: Completed".
response_count Numero intero

Eventi di transazione

Intervallo: "Transaction.Run"
transaction_type stringa ("READ_ONLY" o "READ_WRITE")
attempts_allowed Numero intero
attempts_remaining Numero intero
// Solo se/quando viene eseguito un nuovo tentativo di transazione
Evento: "Avvia nuovo tentativo di transazione"

Eventi commit

Span: "BulkWriter.Commit"
doc_count Numero intero
Intervallo: "Batch.Commit"
doc_count Numero intero
Spazio: "Transaction.Commit"
doc_count Numero intero

Evento eccezionale

Stato intervallo = ERROR
exception.message string
exception.type string
exception.stacktrace string