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 erhalten hat. Die Spannweiten umfassen die Latenz, die durch das Netzwerk und das Clientsystem verursacht wird.

Clientseitige Protokolle können die folgenden Informationen enthalten:

Span-Metadaten

Span-ID Eindeutige ID dieses Abschnitts
Parent Span ID ID der übergeordneten Span, nicht für die Stamm-Span festgelegt
Projekt-ID Google Cloud-Projekt-ID, in die der Trace aufgenommen wurde
Beginn Beginn der Span
Ende Ende der Span

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 Stringbeispiel „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-Wiederholungen
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. Beispiel: 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 Stringbeispiel "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language Stringbeispiel „java“
telemetry.sdk.name opentelemetry
telemetry.sdk.version Beispiel: 1.29.0

Logs und Ereignisse

Clientseitige Traces enthalten die folgenden Protokolle und Ereignisse.

gRPC-Ereignisse

RPC-Properties
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
Transaktionsorientiert boolean
Ereignis: „BatchGetDocuments: First Response Received“
// Alle 100 Antworten werden empfangen
Ereignis: „BatchGetDocuments: 100 Antworten empfangen“
Ereignis: „BatchGetDocuments: Completed with ${N} responses“
response_count Ganzzahl

RunQuery-Ereignisse

Ereignis: „RunQuery“
Transaktionsorientiert boolean
retry_query_with_cursor boolean
Ereignis: „RunQuery: First Response Received“
// Alle 100 Antworten werden empfangen
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
Bereich: „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