Atributos y eventos de intervalos de seguimiento

Los seguimientos del cliente, que se recopilan mediante la ejecución de RPCs, proporcionan varios datos para cada solicitud de un cliente, incluidos los intervalos con marcas de tiempo de cuándo el cliente envió la solicitud de RPC y cuándo la recibió. Los intervalos incluyen la latencia introducida por la red y el sistema del cliente.

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

Metadatos de intervalos

ID de intervalo Es el ID único de este intervalo.
ID de intervalo principal Es el ID del intervalo principal, que no se establece para el intervalo raíz.
ID del proyecto Google Cloud Es el ID del proyecto que incorporó el seguimiento.
Hora de inicio Es la hora de inicio del intervalo.
Hora de finalización Es la hora de finalización del intervalo.

Atributos de intervalos

Versión del cliente
otel.scope.version String
Entorno del cliente
gcp.firestore.memory_utilization doble (porcentaje)
Propiedades de conexión del 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 (p. ej., "grpc")
gcp.firestore.settings.credentials.authentication_type string (p. ej., "OAuth2")
gcp.firestore.settings.host string (p. ej., "firestore.googleapis.com:443")
Propiedades de la base de datos
gcp.firestore.settings.project_id string
Google Cloud ID del proyecto que contiene la base de datos de Firestore
gcp.firestore.settings.database_id string
ID externo de la base de datos (nombre)
Configuración de reintento de RPC del cliente
gcp.firestore.settings.retrySettings.initial_retry_delay string
Duración en segundos (p. ej., 0.01 s)
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts integer (recuento)
gcp.firestore.settings.retrySettings.max_retry_delay string
Duración en segundos (p. ej., 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 (p. ej., "com.google.cloud.firestore"
service.name Chispita
telemetry.sdk.language string (p. ej., "java")
telemetry.sdk.name opentelemetry
telemetry.sdk.version P. ej., 1.29.0

Registros y eventos

Los seguimientos del cliente proporcionan los siguientes registros y eventos.

Eventos de gRPC

Propiedades de RPC
message.id integer (p. ej., 1, 2)
message.type SENT o RECEIVED

Eventos de AggregateQuery

Evento: "RunAggregationQuery Stream Started"
intento Número entero mayor o igual que 0 (p. ej., 2) 0 para el intento inicial
Evento: "RunAggregationQuery Response Received"
intento Número entero mayor o igual que 0 (p. ej., 2) 0 para el intento inicial
Evento: "RunAggregationQuery: Retryable Error"
error.message string
Evento: "RunAggregationQuery: Error"
error.message string

Eventos de BatchGetDocuments

Evento: "BatchGetDocuments: Start"
doc_count Número entero
Transacciones booleano
Evento: "BatchGetDocuments: First Response Received"
// Una vez que se reciben 100 respuestas
Evento: "BatchGetDocuments: Received 100 responses"
Evento: "BatchGetDocuments: Completed with ${N} responses"
response_count Número entero

Eventos de RunQuery

Evento: "RunQuery"
Transacciones booleano
retry_query_with_cursor booleano
Evento: "RunQuery: First Response Received"
// Una vez que se reciben 100 respuestas
Evento: "RunQuery: Received 100 documents"
// Solo si el servidor realiza el cierre parcial
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 entero

Eventos de Transaction

Intervalo: "Transaction.Run"
transaction_type string ("READ_ONLY" o "READ_WRITE")
attempts_allowed Número entero
attempts_remaining Número entero
// Solo si se vuelve a intentar una transacción
Evento: "Initiate transaction retry"

Eventos de Commit

Intervalo: "BulkWriter.Commit"
doc_count Número entero
Intervalo: "Batch.Commit"
doc_count Número entero
Intervalo: "Transaction.Commit"
doc_count Número entero

Evento excepcional

Estado del intervalo = ERROR
exception.message string
exception.type string
exception.stacktrace string