Melacak atribut dan peristiwa span

Pelacakan sisi klien, yang dikumpulkan dengan menjalankan RPC, memberikan beberapa informasi untuk setiap permintaan dari klien, termasuk span dengan stempel waktu saat klien mengirim permintaan RPC dan saat klien menerima respons RPC. Rentang mencakup latensi yang diperkenalkan oleh jaringan dan sistem klien.

Rekaman aktivitas sisi klien dapat mencakup informasi berikut:

Metadata span

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

Atribut span

Versi Klien
otel.scope.version String
Lingkungan Klien
gcp.firestore.memory_utilization ganda (persentase)
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 Contoh string "grpc"
gcp.firestore.settings.credentials.authentication_type Contoh string "OAuth2"
gcp.firestore.settings.host Contoh string "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 Percobaan 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 Contoh string "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language Contoh string "java"
telemetry.sdk.name opentelemetry
telemetry.sdk.version Contoh: 1.29.0

Log dan peristiwa

Rekaman aktivitas sisi klien memberikan log dan peristiwa berikut.

Peristiwa gRPC

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

Peristiwa AggregateQuery

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

Peristiwa BatchGetDocuments

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

Peristiwa RunQuery

Peristiwa: "RunQuery"
transactional boolean
retry_query_with_cursor boolean
Peristiwa: "RunQuery: First Response Received"
// Setelah setiap 100 respons diterima
Peristiwa: "RunQuery: Menerima 100 dokumen"
// Hanya jika/saat setengah penutupan dilakukan oleh server
Peristiwa: "RunQuery: Received RunQueryResponse.Done"
Peristiwa: "RunQuery: Retryable Error".
error.message string
Peristiwa: "RunQuery: Error".
error.message string
Peristiwa: "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 ulang
Peristiwa: "Mulai percobaan ulang transaksi"

Peristiwa Commit

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

Peristiwa Luar Biasa

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