Atributos e eventos de extensão de trace

Os traces do lado do cliente, que são coletados executando RPCs, fornecem várias informações para cada solicitação de um cliente, incluindo períodos com carimbos de data/hora de quando o cliente enviou a solicitação de RPC e quando ele recebeu a resposta de RPC. Os intervalos incluem a latência introduzida pela rede e pelo sistema do cliente.

Os traces do lado do cliente podem incluir as seguintes informações:

Metadados de período

ID do período ID exclusivo deste intervalo.
ID do período pai ID do período pai, não definido para o período raiz
ID do projeto Google Cloud ID do projeto que ingeriu o rastreamento
Horário de início Horário de início do período
Horário de término Horário de término do período

Atributos de período

Versão do cliente
otel.scope.version String
Ambiente do cliente
gcp.firestore.memory_utilization dobro (porcentagem)
Propriedades de conexão do cliente
gcp.firestore.settings.channel.needs_credentials booleano
gcp.firestore.settings.channel.needs_endpoint booleano
gcp.firestore.settings.channel.needs_headers booleano
gcp.firestore.settings.channel.should_auto_close booleano
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"
Propriedades do banco de dados
gcp.firestore.settings.project_id string
Google Cloud ID do projeto que contém o banco de dados do Firestore
gcp.firestore.settings.database_id string
ID externo (nome) do banco de dados
Configurações de nova tentativa de RPC do cliente
gcp.firestore.settings.retrySettings.initial_retry_delay string
Duração em segundos. Ex.: 0,01s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts número inteiro (contagem)
gcp.firestore.settings.retrySettings.max_retry_delay string
Duração em segundos. Ex.: 0,1s
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
Duração em segundos
Configuração do 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 Exemplo: 1.29.0

Registros e eventos

Os rastreamentos do lado do cliente fornecem os seguintes registros e eventos.

Eventos gRPC

Propriedades de RPC
message.id número inteiro, por exemplo, 1, 2
message.type ENVIADA ou RECEBIDA

Eventos AggregateQuery

Evento: "RunAggregationQuery Stream Started"
tentativa Número inteiro maior ou igual a 0 (ex.: 2). 0 para a tentativa inicial
Evento: "Resposta RunAggregationQuery recebida"
tentativa Número inteiro maior ou igual a 0 (ex.: 2). 0 para a tentativa inicial
Evento: "RunAggregationQuery: erro passível de nova tentativa"
error.message string
Evento: "RunAggregationQuery: Error."
error.message string

Eventos BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count Número inteiro
transactional booleano
Evento: "BatchGetDocuments: First Response Received"
// Once every 100 responses are received
Event: "BatchGetDocuments: Received 100 responses"
Evento: "BatchGetDocuments: concluído com ${N} respostas"
response_count Número inteiro

Eventos RunQuery

Event: "RunQuery"
transactional booleano
retry_query_with_cursor booleano
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: erro passível de nova tentativa"
error.message string
Evento: "RunQuery: Error."
error.message string
Evento: "RunQuery: Completed."
response_count Número inteiro

Eventos de transação

Período: "Transaction.Run"
transaction_type string ("READ_ONLY" ou "READ_WRITE")
attempts_allowed Número inteiro
attempts_remaining Número inteiro
// Only if/when a transaction is retried
Event: "Initiate transaction retry"

Eventos de confirmação

Span: "BulkWriter.Commit"
doc_count Número inteiro
Período: "Batch.Commit"
doc_count Número inteiro
Span: "Transaction.Commit"
doc_count Número inteiro

Evento excepcional

Status do período = ERROR
exception.message string
exception.type string
exception.stacktrace string