Atribut dan peristiwa rentang aktivitas

Tracing sisi klien, yang dikumpulkan dengan mengeksekusi RPC, memberikan beberapa informasi untuk setiap permintaan dari klien, termasuk rentang dengan stempel waktu saat klien mengirim permintaan RPC dan saat klien menerima respons RPC. Rentang mencakup latensi yang disebabkan oleh jaringan dan sistem klien.

Rekaman aktivitas sisi klien dapat mencakup informasi berikut:

Metadata rentang

ID Span ID unik rentang ini
ID Span Induk ID rentang induk, tidak ditetapkan untuk rentang akar
ID Project Google Cloud project ID yang menyerap rekaman aktivitas
Waktu Mulai Waktu mulai rentang
Waktu Berakhir Waktu berakhir rentang

Atribut rentang

Versi Klien
otel.scope.version String
Lingkungan Klien
gcp.firestore.memory_utilization double (persen)
Properti Koneksi Klien
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 Contoh "grpc"
gcp.firestore.settings.credentials.authentication_type string Contoh "OAuth2"
gcp.firestore.settings.host string Contoh "firestore.googleapis.com:443"
Properti Database
gcp.firestore.settings.project_id string
Google Cloud project ID yang berisi database Firestore
gcp.firestore.settings.database_id string
ID eksternal (nama) database
Setelan Coba Ulang RPC Klien
gcp.firestore.settings.retrySettings.initial_retry_delay string
Durasi dalam detik Contoh: 0,01 dtk
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts bilangan bulat (jumlah)
gcp.firestore.settings.retrySettings.max_retry_delay string
Durasi dalam detik Contoh: 0,1 dtk
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
Durasi dalam detik
Konfigurasi OpenTelemetry
otel.scope.name string Contoh "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language string Contoh "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version Contoh: 1.29.0

Log dan peristiwa

Rekaman aktivitas sisi klien menyediakan log dan peristiwa berikut.

Peristiwa gRPC

Properti RPC
message.id bilangan bulat, Mis. 1, 2
message.type DIKIRIM atau DITERIMA

Peristiwa AggregateQuery

Event: "RunAggregationQuery Stream Started".
percobaan Bilangan bulat yang lebih besar dari atau sama dengan 0 (Contoh: 2). 0 untuk upaya awal
Event: "RunAggregationQuery Response Received."
percobaan Bilangan bulat yang lebih besar dari atau sama dengan 0 (Contoh: 2). 0 untuk upaya awal
Event: "RunAggregationQuery: Retryable Error."
error.message string
Event: "RunAggregationQuery: Error."
error.message string

Peristiwa BatchGetDocuments

Event: "BatchGetDocuments: Start"
doc_count Bilangan bulat
transactional boolean
Event: "BatchGetDocuments: First Response Received"
// Setelah setiap 100 respons diterima
Peristiwa: "BatchGetDocuments: Menerima 100 respons"
Acara: "BatchGetDocuments: Selesai dengan ${N} respons"
response_count Bilangan bulat

Peristiwa RunQuery

Event: "RunQuery"
transactional boolean
retry_query_with_cursor boolean
Event: "RunQuery: First Response Received"
// Setelah 100 respons diterima
Peristiwa: "RunQuery: Received 100 documents"
// Hanya jika/saat penutupan sebagian dilakukan oleh server
Peristiwa: "RunQuery: Received RunQueryResponse.Done"
Event: "RunQuery: Retryable Error".
error.message string
Peristiwa: "RunQuery: Error".
error.message string
Event: "RunQuery: Completed."
response_count Bilangan bulat

Peristiwa Transaksi

Span: "Transaction.Run"
transaction_type string ("READ_ONLY" atau "READ_WRITE")
attempts_allowed Bilangan bulat
attempts_remaining Bilangan bulat
// Hanya jika/saat transaksi dicoba lagi
Peristiwa: "Mulai coba lagi transaksi"

Peristiwa Commit

Span: "BulkWriter.Commit"
doc_count Bilangan bulat
Span: "Batch.Commit"
doc_count Bilangan bulat
Span: "Transaction.Commit"
doc_count Bilangan bulat

Acara Luar Biasa

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