Attributi ed eventi degli intervalli di Trace

Attributi ed eventi degli intervalli di Trace

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Le tracce lato client, raccolte eseguendo 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 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 padre, non impostato per l'intervallo radice
ID progetto	Google Cloud ID progetto che ha eseguito l'inserimento della traccia
Ora di inizio	Ora di inizio dell'intervallo
Ora di fine	Ora di fine dell'intervallo

Attributi degli intervalli

Versione client
otel.scope.version	Stringa
Ambiente client
gcp.firestore.memory_utilization	double (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	stringa, ad es. "grpc"
gcp.firestore.settings.credentials.authentication_type	stringa, ad es. "OAuth2"
gcp.firestore.settings.host	stringa, ad es. "firestore.googleapis.com:443"
Proprietà del database
gcp.firestore.settings.project_id	string Google Cloud ID progetto che contiene il database Firestore
gcp.firestore.settings.database_id	string ID esterno (nome) del database
Impostazioni di ripetizione dei tentativi RPC client
gcp.firestore.settings.retrySettings.initial_retry_delay	stringa Durata in secondi, ad 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, ad 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	string Durata in secondi
Configurazione OpenTelemetry
otel.scope.name	stringa, ad es. "com.google.cloud.firestore"
service.name	Flash
telemetry.sdk.language	stringa, ad es. "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	SENT o RECEIVED

Eventi AggregateQuery

Evento: "RunAggregationQuery Stream Started."
attempt	Numero intero maggiore o uguale a 0 (ad es. 2). 0 per il tentativo iniziale

Evento: "RunAggregationQuery Response Received."
attempt	Numero intero maggiore o uguale a 0 (ad es. 2). 0 per il tentativo iniziale

Evento: "RunAggregationQuery: Retryable Error."
error.message	stringa

Evento: "RunAggregationQuery: Error."
error.message	stringa

Eventi BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count	Numero intero
transactional	boolean

Evento: "BatchGetDocuments: First Response Received"

// Una volta ricevute 100 risposte 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 ricevute 100 risposte Evento: "RunQuery: Received 100 documents"

// Solo se/quando il server esegue la chiusura parziale Evento: "RunQuery: Received RunQueryResponse.Done"

Evento: "RunQuery: Retryable Error."
error.message	stringa

Evento: "RunQuery: Error."
error.message	stringa

Evento: "RunQuery: Completed."
response_count	Numero intero

Eventi delle transazioni

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: "Initiate transaction retry"

Eventi di commit

Intervallo: "BulkWriter.Commit"
doc_count	Numero intero

Intervallo: "Batch.Commit"
doc_count	Numero intero

Intervallo: "Transaction.Commit"
doc_count	Numero intero

Evento eccezionale

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