Trace-Span-Attribute und -Ereignisse

Clientseitige Traces, die durch Ausführen von RPCs erfasst werden, enthalten für jede Anfrage eines Clients mehrere Informationen, darunter Spans mit Zeitstempeln, wann der Client die RPC-Anfrage gesendet und wann er die RPC-Antwort empfangen hat. Die Spannen umfassen die Latenz, die durch das Netzwerk und das Clientsystem verursacht wird.

Clientseitige Traces können die folgenden Informationen enthalten:

Span-Metadaten

Span-ID Eindeutige ID dieses Zeitraums
Parent Span ID ID des übergeordneten Spans, nicht für den Stammspan festgelegt
Projekt-ID Google Cloud Projekt-ID, in die der Trace aufgenommen wurde
Beginn Beginn des Zeitraums
Ende Ende des Zeitraums

Span-Attribute

Clientversion
otel.scope.version String
Client-Umgebung
gcp.firestore.memory_utilization double (Prozentsatz)
Eigenschaften der Clientverbindung
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 string Ex. „grpc“
gcp.firestore.settings.credentials.authentication_type string Ex. „OAuth2“
gcp.firestore.settings.host string Ex. "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 auf Clientseite
gcp.firestore.settings.retrySettings.initial_retry_delay string
Dauer in Sekunden, z. B. 0,01 Sek.
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 Sek.
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 Ex. "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language string Ex. „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-Properties
message.id Ganzzahl, z. B. 1, 2
message.type GESENDET oder EMPFANGEN

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 boolean
Event: „BatchGetDocuments: First Response Received“
// Nach 100 Antworten
Ereignis: „BatchGetDocuments: 100 Antworten erhalten“
Event: „BatchGetDocuments: Completed with ${N} responses“
response_count Ganzzahl

RunQuery-Ereignisse

Ereignis: „RunQuery“
transaktional boolean
retry_query_with_cursor boolean
Ereignis: „RunQuery: First Response Received“
// Nach 100 Antworten
Ereignis: „RunQuery: Received 100 documents“ (RunQuery: 100 Dokumente empfangen)
// Nur wenn/wenn der Server den Halbschließen-Vorgang ausfü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

Zeitraum: „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 Ereignis

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