Atributos y eventos de intervalos de rastreo

Las trazas del lado del cliente, que se recogen ejecutando RPCs, proporcionan varios datos de cada solicitud de un cliente, incluidas las extensiones con marcas de tiempo de cuándo envió el cliente la solicitud de RPC y cuándo recibió la respuesta de RPC. Los intervalos incluyen la latencia introducida por la red y el sistema del cliente.

Los seguimientos del lado del cliente pueden incluir la siguiente información:

Metadatos de los intervalos

ID de intervalo ID único de este intervalo.
ID del intervalo principal ID del intervalo principal. No se define en el intervalo raíz.
ID del proyecto Google Cloud ID del proyecto que ha insertado el seguimiento
Hora de inicio Hora de inicio del intervalo
Hora de finalización Hora de finalización del intervalo

Atributos de intervalo

Versión del cliente
otel.scope.version Cadena
Entorno del cliente
gcp.firestore.memory_utilization doble (porcentaje)
Propiedades de conexión de 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"
Propiedades de la base de datos
gcp.firestore.settings.project_id Cadena
Google Cloud ID de proyecto que contiene la base de datos de Firestore
gcp.firestore.settings.database_id string
ID externo de la base de datos (nombre)
Ajustes de reintento de RPC de cliente
gcp.firestore.settings.retrySettings.initial_retry_delay string
Duración en segundos. Por ejemplo: 0,01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts entero (recuento)
gcp.firestore.settings.retrySettings.max_retry_delay string
Duración en segundos. Por ejemplo: 0,1 s
gcp.firestore.settings.retrySettings.max_rpc_timeout
gcp.firestore.settings.retrySettings.retry_delay_multiplier doble
gcp.firestore.settings.retrySettings.rpc_timeout_multiplier doble
gcp.firestore.settings.retrySettings.total_timeout string
Duración en segundos
Configuración de 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 ejemplo, 1.29.0

Registros y eventos

Las trazas del lado del cliente proporcionan los siguientes registros y eventos.

Eventos de gRPC

Propiedades de RPC
message.id entero, por ejemplo, 1, 2
message.type ENVIADO o RECIBIDO

Eventos AggregateQuery

Evento: "RunAggregationQuery Stream Started" (Se ha iniciado el flujo RunAggregationQuery).
intento Número entero mayor o igual que 0 (por ejemplo, 2). 0 en el intento inicial
Evento: "RunAggregationQuery Response Received" (Se ha recibido la respuesta de RunAggregationQuery).
intento Número entero mayor o igual que 0 (por ejemplo, 2). 0 en el intento inicial
Evento: "RunAggregationQuery: Retryable Error."
error.message cadena
Evento: "RunAggregationQuery: Error."
error.message cadena

Eventos de BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count Entero
transactional booleano
Evento: "BatchGetDocuments: First Response Received"
// Una vez que se hayan recibido 100 respuestas
Evento: "BatchGetDocuments: Received 100 responses"
Evento: "BatchGetDocuments: Completed with ${N} responses" ("BatchGetDocuments: se ha completado con ${N} respuestas")
response_count Entero

Eventos RunQuery

Evento: "RunQuery"
transactional booleano
retry_query_with_cursor booleano
Evento: "RunQuery: First Response Received"
// Una vez que se hayan recibido 100 respuestas
Evento: "RunQuery: Received 100 documents"
// Solo si el servidor realiza un cierre parcial
Evento: "RunQuery: Received RunQueryResponse.Done"
Evento: "RunQuery: Retryable Error" (RunQuery: error que se puede volver a intentar).
error.message cadena
Evento: "RunQuery: Error."
error.message cadena
Evento: "RunQuery: Completed."
response_count Entero

Eventos de transacción

Span: "Transaction.Run"
transaction_type Cadena ("READ_ONLY" o "READ_WRITE")
attempts_allowed Entero
attempts_remaining Entero
// Solo si/cuando se vuelve a intentar una transacción
Evento: "Iniciar reintento de transacción"

Confirmar eventos

Span: "BulkWriter.Commit"
doc_count Entero
Span: "Batch.Commit"
doc_count Entero
Span: "Transaction.Commit"
doc_count Entero

Evento excepcional

Span Status = ERROR
exception.message cadena
exception.type cadena
exception.stacktrace cadena