Trace-Spannungsattribute und -Ereignisse

Clientseitige Traces, die durch Ausführen von RPCs erfasst werden, enthalten mehrere Informationen zu jeder Anfrage von einem Client, einschließlich Zeitstempel, zu denen der Client die RPC-Anfrage gesendet und die RPC-Antwort empfangen hat. Die Spans enthalten Latenzen das durch das Netzwerk- und Clientsystem eingeführt wurde.

Clientseitige Traces können die folgenden Informationen enthalten:

Span-Metadaten

Span-ID Eindeutige ID dieses Abschnitts
Parent Span ID ID des übergeordneten Spans, nicht für Haupt-Span festgelegt
Projekt-ID ID des Google Cloud-Projekts, das den Trace aufgenommen hat
Beginn Span-Startzeit
Ende Span-Ende

Span-Attribute

Clientversion
otel.scope.version String
Clientumgebung
gcp.firestore.memory_utilization Verdoppeln (Prozentsatz)
Clientverbindungseigenschaften
gcp.firestore.settings.channel.needs_credentials boolean
gcp.firestore.settings.channel.needs_endpoint boolean
gcp.firestore.settings.channel.needs_headers boolean
gcp.firestore.settings.channel.should_auto_close boolean
gcp.firestore.settings.channel.transport_name Stringbeispiel „grpc“
gcp.firestore.settings.credentials.authentication_type Stringbeispiel „OAuth2“
gcp.firestore.settings.host Zeichenfolge Bsp. „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 Datenbank-ID (Name)
Einstellungen für Client-RPC-Wiederholung
gcp.firestore.settings.retrySettings.initial_retry_delay string
Dauer in Sekunden. Beispiel: 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 Zeichenfolge Bsp. „com.google.cloud.firestore“
service.name Sparky
telemetry.sdk.language Zeichenfolge Bsp. "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version Beispiel: 1.29.0

Logs und Ereignisse

Clientseitige Traces liefern die folgenden Logs und Ereignisse.

gRPC-Ereignisse

RPC-Properties
message.id Ganzzahl, z. B. 1, 2
message.type GESENDET oder ERHALTEN

AggregateQuery-Ereignisse

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

BatchGetDocuments-Ereignisse

Ereignis: „BatchGetDocuments: Start“
doc_count Ganzzahl
Transaktionsorientiert boolean
Ereignis: „BatchGetDocuments: First Response Received“
// Alle 100 Antworten werden empfangen
Ereignis: „BatchGetDocuments: 100 Antworten empfangen“
Ereignis: „BatchGetDocuments: Mit ${N} Antworten abgeschlossen“
response_count Ganzzahl

RunQuery-Ereignisse

Ereignis: „RunQuery“
Transaktionsorientiert boolean
retry_query_with_cursor boolean
Ereignis: „RunQuery: First Response Received“
// Nach jeweils 100 Antworten
Ereignis: „RunQuery: Received 100 documents“
// Nur wenn/wenn eine Halbschließung vom Server ausgeführt wird
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/wenn eine Transaktion wiederholt wird
Ereignis: „Transaktionswiederholung initiieren“

Commit-Ereignisse

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

Außergewöhnliches Event

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