Atributos y eventos de intervalos de seguimiento

Los registros del cliente, que se recopilan mediante la ejecución de RPC, 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 recibió la respuesta de RPC. Los intervalos incluyen la latencia que introducen la red y el sistema del cliente.

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

Metadatos del intervalo

ID de intervalo ID único de este intervalo
ID de intervalo principal ID del intervalo principal, no establecido para el intervalo raíz
ID del proyecto Google Cloud ID del proyecto que transfirió el registro
Hora de inicio Hora de inicio del período
Hora de finalización Hora de finalización del período

Atributos de intervalo

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 Cadena, p. ej., "grpc"
gcp.firestore.settings.credentials.authentication_type Cadena, p. ej., "OAuth2"
gcp.firestore.settings.host Cadena, p. ej., "firestore.googleapis.com:443"
Propiedades de la base de datos
gcp.firestore.settings.project_id cadena
Google Cloud ID del proyecto que contiene la base de datos de Firestore
gcp.firestore.settings.database_id cadena
ID externo (nombre) de la base de datos
Configuración de reintentos de RPC del cliente
gcp.firestore.settings.retrySettings.initial_retry_delay cadena
Duración en segundos (p. ej., "10s") 0.01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts número entero (recuento)
gcp.firestore.settings.retrySettings.max_retry_delay cadena
Duración en segundos (p. ej., "10s") 0.1 s
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 cadena
Duración en segundos
Configuración de OpenTelemetry
otel.scope.name Cadena, p. ej., "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language Cadena, p. ej., "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version P. ej.: 1.29.0

Registros y eventos

Los registros del cliente proporcionan los siguientes registros y eventos.

Eventos de gRPC

Propiedades de RPC
message.id número entero, p. ej., 1, 2
message.type ENVIADO o RECIBIDO

Eventos de AggregateQuery

Evento: "Se inició la transmisión de RunAggregationQuery".
intento Número entero mayor o igual que 0 (p. ej., 2). 0 para el intento inicial
Evento: "Se recibió la respuesta de RunAggregationQuery".
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: Se recibieron 100 respuestas"
Evento: "BatchGetDocuments: Se completó con ${N} respuestas"
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: Se recibieron 100 documentos"
// Solo si el servidor realiza un 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 transacción

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

Eventos de confirmación

Span: "BulkWriter.Commit"
doc_count Número entero
Extensión: "Batch.Commit"
doc_count Número entero
Intervalo: "Transaction.Commit"
doc_count Número entero

Evento excepcional

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