מעקב אחרי מאפיינים ואירועים של טווחים

עקבות בצד הלקוח, שנאספים על ידי הפעלת RPC, מספקים כמה פריטי מידע לכל בקשה מלקוח, כולל טווחי זמן עם חותמות זמן של מועד שליחת בקשת ה-RPC על ידי הלקוח ומועד קבלת תגובת ה-RPC על ידי הלקוח. טווחי הזמן כוללים את זמן האחזור שנוצר על ידי הרשת ומערכת הלקוח.

המידע שמופיע בנתוני מעקב בצד הלקוח יכול לכלול את הפרטים הבאים:

מטא-נתונים של טווח

מזהה Span המזהה הייחודי של הטווח הזה
מזהה טווח ההורה המזהה של ה-span ההורה, לא מוגדר ל-span השורש
מזהה פרויקט מזהה הפרויקט ב-Google Cloud שאליו הועבר ה-trace
שעת ההתחלה שעת ההתחלה של טווח הזמן
שעת הסיום שעת הסיום של טווח הזמן

מאפייני Span

גרסת לקוח
otel.scope.version String
סביבת לקוח
gcp.firestore.memory_utilization double (percentage)
מאפייני חיבור של לקוח
gcp.firestore.settings.channel.needs_credentials בוליאני
gcp.firestore.settings.channel.needs_endpoint בוליאני
gcp.firestore.settings.channel.needs_headers בוליאני
gcp.firestore.settings.channel.should_auto_close בוליאני
gcp.firestore.settings.channel.transport_name מחרוזת לדוגמה: "grpc"
gcp.firestore.settings.credentials.authentication_type מחרוזת, לדוגמה: OAuth2
gcp.firestore.settings.host מחרוזת לדוגמה: "firestore.googleapis.com:443"
מאפיינים של מסד נתונים
gcp.firestore.settings.project_id string
Google Cloud מזהה הפרויקט שמכיל את מסד הנתונים של Firestore
gcp.firestore.settings.database_id string
מזהה חיצוני (שם) של מסד הנתונים
הגדרות של ניסיון חוזר של RPC בצד הלקוח
gcp.firestore.settings.retrySettings.initial_retry_delay מחרוזת
משך בשניות. לדוגמה: ‎0.01s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts מספר שלם (ספירה)
gcp.firestore.settings.retrySettings.max_retry_delay מחרוזת
משך הזמן בשניות. לדוגמה: ‎0.1s
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 מחרוזת
משך בשניות
הגדרה של OpenTelemetry
otel.scope.name string Ex. "com.google.cloud.firestore"
service.name נבחן
telemetry.sdk.language מחרוזת לדוגמה: java
telemetry.sdk.name opentelemetry
telemetry.sdk.version דוגמה: 1.29.0

יומנים ואירועים

במעקב בצד הלקוח מוצגים היומנים והאירועים הבאים.

אירועי gRPC

מאפייני RPC
message.id מספר שלם, לדוגמה: 1, 2
message.type נשלח או התקבל

אירועים של AggregateQuery

אירוע: RunAggregationQuery Stream Started
ניסיון מספר שלם גדול מ-0 או שווה לו (לדוגמה: 2). ‫0 בניסיון הראשון
אירוע: 'התקבלה תגובה לשאילתת צבירה'.
ניסיון מספר שלם גדול מ-0 או שווה לו (לדוגמה: 2). ‫0 בניסיון הראשון
אירוע: RunAggregationQuery: Retryable Error.‎
error.message מחרוזת
אירוע: RunAggregationQuery: Error.‎
error.message מחרוזת

אירועים של BatchGetDocuments

Event: "BatchGetDocuments: Start"
doc_count מספר שלם
פעולות בוליאני
אירוע: BatchGetDocuments: First Response Received
‫// אחרי שמתקבלות 100 תשובות
Event: "BatchGetDocuments: Received 100 responses"
אירוע: BatchGetDocuments: הושלם עם ${N} תגובות
response_count מספר שלם

אירועים של RunQuery

אירוע: RunQuery
פעולות בוליאני
retry_query_with_cursor בוליאני
אירוע: RunQuery: First Response Received
‫// פעם אחת בכל 100 תגובות שמתקבלות
Event: "RunQuery: Received 100 documents"
‫// רק אם השרת מבצע סגירה חלקית
Event: "RunQuery: Received RunQueryResponse.Done"
אירוע: RunQuery: Retryable Error.‎
error.message מחרוזת
אירוע: RunQuery: Error.‎
error.message מחרוזת
אירוע: RunQuery: Completed.‎
response_count מספר שלם

אירועי עסקאות

Span: "Transaction.Run"
transaction_type string ("READ_ONLY" or "READ_WRITE")
attempts_allowed מספר שלם
attempts_remaining מספר שלם
‫// רק אם/כאשר מתבצע ניסיון חוזר של טרנזקציה
Event: "Initiate transaction retry"

שמירת אירועים

Span: "BulkWriter.Commit"
doc_count מספר שלם
Span: "Batch.Commit"
doc_count מספר שלם
‫Span: "Transaction.Commit"
doc_count מספר שלם

אירוע חריג

Span Status = ERROR
exception.message מחרוזת
exception.type מחרוזת
exception.stacktrace מחרוזת