Atributos e eventos de extensão de rastreio

Os rastreios do lado do cliente, que são recolhidos através da execução de RPCs, fornecem várias informações para cada pedido de um cliente, incluindo intervalos com datas/horas em que o cliente enviou o pedido de RPC e em que o cliente recebeu a resposta de RPC. Os intervalos incluem a latência introduzida pela rede e pelo sistema do cliente.

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

Metadados do intervalo

ID do intervalo ID exclusivo deste intervalo
ID do intervalo principal ID do intervalo principal, não definido para o intervalo raiz
ID do projeto Google Cloud ID do projeto que carregou o rastreio
Hora de início Hora de início do intervalo
Hora de fim Hora de fim do intervalo

Atributos de intervalo

Versão do cliente
otel.scope.version String
Ambiente do cliente
gcp.firestore.memory_utilization double (percentagem)
Propriedades de ligaçã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 da base de dados
gcp.firestore.settings.project_id string
Google Cloud ID do projeto que contém a base de dados do Firestore
gcp.firestore.settings.database_id string
ID externo da base de dados (nome)
Definições de novas tentativas de RPC do cliente
gcp.firestore.settings.retrySettings.initial_retry_delay string
Duração em segundos. Exemplo: 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. Exemplo: 0,1 s
gcp.firestore.settings.retrySettings.max_rpc_timeout
gcp.firestore.settings.retrySettings.retry_delay_multiplier dupla
gcp.firestore.settings.retrySettings.rpc_timeout_multiplier dupla
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 Por exemplo: 1.29.0

Registos e eventos

Os rastreios do lado do cliente fornecem os seguintes registos e eventos.

Eventos gRPC

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

Eventos AggregateQuery

Evento: "RunAggregationQuery Stream Started" (Stream RunAggregationQuery iniciada).
tentativa Número inteiro superior ou igual a 0 (exemplo: 2). 0 para a tentativa inicial
Evento: "Resposta RunAggregationQuery recebida".
tentativa Número inteiro superior ou igual a 0 (exemplo: 2). 0 para a tentativa inicial
Evento: "RunAggregationQuery: Retryable Error."
error.message de string
Evento: "RunAggregationQuery: Error."
error.message de string

Eventos BatchGetDocuments

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

Eventos RunQuery

Evento: "RunQuery"
transacional booleano
retry_query_with_cursor booleano
Evento: "RunQuery: First Response Received"
// Once every 100 responses are received
Event: "RunQuery: Received 100 documents"
// Apenas se/quando o servidor realizar o fecho parcial
Evento: "RunQuery: Received RunQueryResponse.Done"
Evento: "RunQuery: Retryable Error."
error.message de string
Evento: "RunQuery: Error."
error.message de string
Evento: "RunQuery: Completed" (Executar consulta: concluído).
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
// Only if/when a transaction is retried
Event: "Initiate transaction retry"

Consolide 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 excecional

Span Status = ERROR
exception.message de string
exception.type de string
exception.stacktrace de string