Trace-Span-Attribute und -Ereignisse

Clientseitige Traces, die durch Ausführen von RPCs erfasst werden, enthalten mehrere Informationen für jede Anfrage von einem Client, einschließlich Spans mit Zeitstempeln, wann der Client die RPC-Anfrage gesendet und wann er die RPC-Antwort erhalten hat. Die Spans enthalten die durch das Netzwerk und das Clientsystem verursachte Latenz.

Clientseitige Traces können die folgenden Informationen enthalten:

Span-Metadaten

Span-ID Eindeutige ID dieses Spans
Übergeordnete Span-ID ID des übergeordneten Spans, nicht für den Stamm-Span festgelegt
Projekt-ID Google Cloud Projekt-ID, mit der der Trace aufgenommen wurde
Beginn Startzeit des Spans
Ende Endzeit des Spans

Span-Attribute

Clientversion
otel.scope.version String
Clientumgebung
gcp.firestore.memory_utilization Double (Prozent)
Eigenschaften der Clientverbindung
gcp.firestore.settings.channel.needs_credentials Boolesch
gcp.firestore.settings.channel.needs_endpoint Boolesch
gcp.firestore.settings.channel.needs_headers Boolesch
gcp.firestore.settings.channel.should_auto_close Boolesch
gcp.firestore.settings.channel.transport_name String, z. B. „grpc“
gcp.firestore.settings.credentials.authentication_type String, z. B. „OAuth2“
gcp.firestore.settings.host String, z. B. „firestore.googleapis.com:443“
Datenbankeigenschaften
gcp.firestore.settings.project_id String
Google Cloud Projekt-ID, die die Firestore-Datenbank enthält
gcp.firestore.settings.database_id String
Externe ID (Name) der Datenbank
Einstellungen für RPC-Wiederholungen des Clients
gcp.firestore.settings.retrySettings.initial_retry_delay String
Dauer in Sekunden, z. B. 0,01 s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts Ganzzahl (Anzahl)
gcp.firestore.settings.retrySettings.max_retry_delay String
Dauer in Sekunden, z. B. 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 string
Dauer in Sekunden
OpenTelemetry-Konfiguration
otel.scope.name String, z. B. "com.google.cloud.firestore"
service.name Bello
telemetry.sdk.language String, z. B. „java“
telemetry.sdk.name opentelemetry
telemetry.sdk.version Beispiel: 1.29.0

Logs und Ereignisse

Clientseitige Traces enthalten die folgenden Logs und Ereignisse.

gRPC-Ereignisse

RPC-Eigenschaften
message.id Ganzzahl, z. B. 1, 2
message.type SENT oder RECEIVED

AggregateQuery-Ereignisse

Ereignis: „RunAggregationQuery Stream Started.“
Versuch Ganzzahl größer oder gleich 0 (z. B. 2) 0 für den ersten Versuch
Ereignis: „RunAggregationQuery Response Received.“
Versuch Ganzzahl größer oder gleich 0 (z. B. 2) 0 für den ersten Versuch
Ereignis: „RunAggregationQuery: Retryable Error.“
error.message String
Ereignis: „RunAggregationQuery: Error.“
error.message String

BatchGetDocuments-Ereignisse

Ereignis: „BatchGetDocuments: Start“
doc_count Ganzzahl
transaktional Boolesch
Ereignis: „BatchGetDocuments: First Response Received“
// Einmal alle 100 Antworten
Ereignis: "BatchGetDocuments: Received 100 responses"
Ereignis: „BatchGetDocuments: Completed with ${N} responses“
response_count Ganzzahl

RunQuery-Ereignisse

Ereignis: „RunQuery“
transaktional Boolesch
retry_query_with_cursor Boolesch
Ereignis: „RunQuery: First Response Received“
// Einmal alle 100 Antworten
Ereignis: "RunQuery: Received 100 documents"
// Nur wenn der Server eine halbe Schließung durchführt
Ereignis: "RunQuery: Received RunQueryResponse.Done"
Ereignis: „RunQuery: Retryable Error.“
error.message String
Ereignis: „RunQuery: Error.“
error.message String
Ereignis: „RunQuery: Completed.“
response_count Ganzzahl

Transaktionsereignisse

Span: „Transaction.Run“
transaction_type String („READ_ONLY“ oder „READ_WRITE“)
attempts_allowed Ganzzahl
attempts_remaining Ganzzahl
// Nur wenn eine Transaktion wiederholt wird
Ereignis: "Initiate transaction retry"

Commit-Ereignisse

Span: „BulkWriter.Commit“
doc_count Ganzzahl
Span: „Batch.Commit“
doc_count Ganzzahl
Span: „Transaction.Commit“
doc_count Ganzzahl

Ausnahmeereignis

Span-Status = ERROR
exception.message String
exception.type String
exception.stacktrace String