Attributi ed eventi di intervallo di traccia

Le tracce lato client, raccolte mediante l'esecuzione di RPC, forniscono diverse informazioni per ogni richiesta da un client, inclusi gli intervalli con i timestamp di quando il client ha inviato la richiesta RPC e di 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 dello span

ID intervallo ID univoco di questo intervallo
ID intervallo padre ID dello span padre, non impostato per lo span radice
ID progetto Google Cloud ID progetto che ha importato la traccia
Ora di inizio Ora di inizio intervallo
Ora di fine Ora di fine intervallo

Attributi intervallo

Versione client
otel.scope.version Stringa
Ambiente client
gcp.firestore.memory_utilization raddoppio (percentuale)
Proprietà della connessione client
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 string Ex. "grpc"
gcp.firestore.settings.credentials.authentication_type string Ex. "OAuth2"
gcp.firestore.settings.host string Ex. "firestore.googleapis.com:443"
Proprietà del database
gcp.firestore.settings.project_id string
Google Cloud ID progetto contenente il database Firestore
gcp.firestore.settings.database_id string
ID esterno (nome) del database
Impostazioni di nuovi tentativi RPC client
gcp.firestore.settings.retrySettings.initial_retry_delay string
Durata in secondi. Esempio: 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 string
Durata in secondi. Esempio: 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
Durata in secondi
Configurazione OpenTelemetry
otel.scope.name string Ex. "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language string Ex. "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" (Avvio dello stream RunAggregationQuery).
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"
// Once every 100 responses are received
Event: "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"
// Once every 100 responses are received
Event: "RunQuery: Received 100 documents"
// Only if/when half-close is performed by the server
Event: "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 transazione

Span: "Transaction.Run"
transaction_type stringa ("READ_ONLY" o "READ_WRITE")
attempts_allowed Numero intero
attempts_remaining Numero intero
// Only if/when a transaction is retried
Event: "Initiate transaction retry"

Eventi di commit

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

Evento eccezionale

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