Atributos y eventos de intervalos de seguimiento

Atributos y eventos de intervalos de seguimiento

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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