Rastrear atributos e eventos de abrangência

Os traces do lado do cliente, que são coletados pela execução de 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 o cliente recebeu a resposta de RPC. Os intervalos incluem a latência introduzida pela rede e pelo sistema do cliente.

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

Metadados de período

ID do período ID exclusivo desta span
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 rastro
Horário de início Horário de início do período
Horário de término Término do período

Atributos de período

Versão do cliente
otel.scope.version String
Ambiente do cliente
gcp.firestore.memory_utilization Duplo (porcentagem)
Propriedades de conexão do cliente
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"
Propriedades do banco de dados
gcp.firestore.settings.project_id string
ID do projetoGoogle Cloud que contém o banco de dados do Firestore
gcp.firestore.settings.database_id string
ID externo do banco de dados (nome)
Configurações de repetição de RPC do cliente
gcp.firestore.settings.retrySettings.initial_retry_delay string
Duração em segundos Ex. 0,01 s
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 rastros do lado do cliente fornecem os registros e eventos a seguir.

Eventos do gRPC

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

Eventos AggregateQuery

Evento: "RunAggregationQuery Stream Started".
tentativa Número inteiro maior ou igual a 0 (por exemplo, 2). 0 para a tentativa inicial
Evento: "RunAggregationQuery Response Received".
tentativa Número inteiro maior ou igual a 0 (por exemplo, 2). 0 para a tentativa inicial
Evento: "RunAggregationQuery: Retryable Error".
error.message string
Evento: "RunAggregationQuery: Error".
error.message string

Eventos BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count Número inteiro
transactional boolean
Evento: "BatchGetDocuments: First Response Received"
// Uma vez a cada 100 respostas recebidas
Evento: "BatchGetDocuments: Received 100 responses"
Evento: "BatchGetDocuments: Completed with ${N} responses"
response_count Número inteiro

Eventos RunQuery

Evento: "RunQuery"
transactional boolean
retry_query_with_cursor boolean
Evento: "RunQuery: First Response Received"
// Uma vez a cada 100 respostas recebidas
Evento: "RunQuery: Received 100 documents"
// Somente se/quando a semifechamento for realizado pelo servidor
Evento: "RunQuery: Received RunQueryResponse.Done"
Evento: "RunQuery: Retryable Error".
error.message string
Evento: "RunQuery: Error".
error.message string
Evento: "RunQuery: Completed".
response_count Número inteiro

Eventos de transação

Span: "Transaction.Run"
transaction_type string ("READ_ONLY" ou "READ_WRITE")
attempts_allowed Número inteiro
attempts_remaining Número inteiro
// Somente se/quando uma transação for repetida
Evento: "Iniciar repetição de transação"

Confirmar eventos

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

Evento excepcional

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