Attributs et événements de délai de trace

Attributs et événements de délai de trace

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Les traces côté client, collectées en exécutant des RPC, fournissent plusieurs informations pour chaque requête d'un client, y compris des délais avec des codes temporels indiquant quand le client a envoyé la requête RPC et quand il a reçu la réponse RPC. Les délais incluent la latence introduite par le réseau et le système client.

Les traces côté client peuvent inclure les informations suivantes :

Métadonnées de délai

ID du délai	ID unique de ce délai
ID du délai parent	ID du délai parent, non défini pour le délai racine
ID du projet	Google Cloud ID du projet qui a ingéré la trace
Heure de début	Heure de début du délai
Heure de fin	Heure de fin du délai

Attributs de délai

Version du client
otel.scope.version	Chaîne
Environnement client
gcp.firestore.memory_utilization	double (pourcentage)
Propriétés de connexion du client
gcp.firestore.settings.channel.needs_credentials	booléen
gcp.firestore.settings.channel.needs_endpoint	booléen
gcp.firestore.settings.channel.needs_headers	booléen
gcp.firestore.settings.channel.should_auto_close	booléen
gcp.firestore.settings.channel.transport_name	chaîne Ex. : "grpc"
gcp.firestore.settings.credentials.authentication_type	chaîne Ex. : "OAuth2"
gcp.firestore.settings.host	chaîne Ex. : "firestore.googleapis.com:443"
Propriétés de la base de données
gcp.firestore.settings.project_id	chaîne Google Cloud ID du projet contenant la base de données Firestore
gcp.firestore.settings.database_id	chaîne ID externe de la base de données (nom)
Paramètres de nouvelle tentative RPC du client
gcp.firestore.settings.retrySettings.initial_retry_delay	chaîne Durée en secondes Ex. : 0,01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts	entier (nombre)
gcp.firestore.settings.retrySettings.max_retry_delay	chaîne Durée en secondes Ex. : 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	chaîne Durée en secondes
Configuration OpenTelemetry
otel.scope.name	chaîne Ex. : "com.google.cloud.firestore"
service.name	Médor
telemetry.sdk.language	chaîne Ex. : "java"
telemetry.sdk.name	opentelemetry
telemetry.sdk.version	Ex. : 1.29.0

Journaux et événements

Les traces côté client fournissent les journaux et événements suivants.

Événements gRPC

Propriétés RPC
message.id	entier, Ex. : 1, 2
message.type	SENT ou RECEIVED

Événements AggregateQuery

Événement : "RunAggregationQuery Stream Started."
Tentative	Entier supérieur ou égal à 0 (Ex. : 2). 0 pour la tentative initiale

Événement : "RunAggregationQuery Response Received."
Tentative	Entier supérieur ou égal à 0 (Ex. : 2). 0 pour la tentative initiale

Événement : "RunAggregationQuery: Retryable Error."
error.message	chaîne

Événement : "RunAggregationQuery: Error."
error.message	chaîne

Événements BatchGetDocuments

Événement : "BatchGetDocuments: Start"
doc_count	Entier
transactionnelles	booléen

Événement : "BatchGetDocuments: First Response Received"

// Une fois toutes les 100 réponses reçues Événement : "BatchGetDocuments: Received 100 responses"

Événement : "BatchGetDocuments: Completed with ${N} responses"
response_count	Entier

Événements RunQuery

Événement : "RunQuery"
transactionnelles	booléen
retry_query_with_cursor	booléen

Événement : "RunQuery: First Response Received"

// Une fois tous les 100 documents reçus Événement : "RunQuery: Received 100 documents"

// Uniquement si/lorsque le serveur effectue une fermeture partielle Événement : "RunQuery: Received RunQueryResponse.Done"

Événement : "RunQuery: Retryable Error."
error.message	chaîne

Événement : "RunQuery: Error."
error.message	chaîne

Événement : "RunQuery: Completed."
response_count	Entier

Événements de transaction

Délai : "Transaction.Run"
transaction_type	chaîne ("READ_ONLY" ou "READ_WRITE")
attempts_allowed	Entier
attempts_remaining	Entier

// Uniquement si/lorsqu'une nouvelle tentative de transaction est effectuée Événement : "Initiate transaction retry"

Événements de commit

Délai : "BulkWriter.Commit"
doc_count	Entier

Délai : "Batch.Commit"
doc_count	Entier

Délai : "Transaction.Commit"
doc_count	Entier

Événement exceptionnel

État du délai = ERROR
exception.message	chaîne
exception.type	chaîne
exception.stacktrace	chaîne