トレーススパンの属性とイベント

クライアント側のトレースでは、RPC を実行して収集され、クライアントからのリクエストごとにいくつかの情報を提供します。たとえば、クライアントが RPC リクエストを送信した時点やクライアントが RPC レスポンスを受信した時点のタイムスタンプを含むスパンが含まれます。このスパンには、ネットワークおよびクライアント システムに起因するレイテンシが含まれます。

クライアント側のトレースには、次の情報が含まれます。

スパン メタデータ

スパン ID このスパンの一意の ID
親スパン ID 親スパンの ID。ルートスパンには設定されません。
プロジェクト ID トレースを取り込まれた Google Cloud プロジェクト ID
開始時間 スパン開始時間
終了時刻 スパン終了時間

スパンの属性

クライアントのバージョン
otel.scope.version 文字列
クライアント環境
gcp.firestore.memory_utilization double型（パーセント）
クライアント接続プロパティ
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 文字列
Firestore データベースを含む Google Cloud プロジェクト ID
gcp.firestore.settings.database_id 文字列
データベースの外部 ID（名前）
クライアント RPC 再試行の設定
gcp.firestore.settings.retrySettings.initial_retry_delay 文字列
実行時間（秒） 例:0.01s
gcp.firestore.settings.retrySettings.initial_rpc_timeout
gcp.firestore.settings.retrySettings.max_attempts 整数（count）
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 文字列 例: "com.google.cloud.firestore"
service.name Sparky
telemetry.sdk.language 文字列 例: 「java」
telemetry.sdk.name opentelemetry
telemetry.sdk.version 例: 1.29.0

ログとイベント

クライアント側のトレースでは、次のログとイベントが提供されます。

gRPC イベント

RPC プロパティ
message.id 整数、例: 1、2
message.type SENT または RECEIVED

AggregateQuery イベント

イベント: 「RunAggregationQuery Stream Started」
試行 0 以上の整数（例: 2）。0（最初の試行）
イベント: 「RunAggregationQuery Response Received」
試行 0 以上の整数（例: 2）。0（最初の試行）
イベント: 「RunAggregationQuery: Retryable Error」
error.message 文字列
イベント: 「RunAggregationQuery: Error」
error.message 文字列

BatchGetDocuments イベント

イベント: 「BatchGetDocuments: Start」
doc_count 整数
transactional ブール値
イベント: 「BatchGetDocuments: 最初のレスポンス受信」
// 100 件のレスポンスごとに受信
イベント: 「BatchGetDocuments: 100 件のレスポンスを受信」
イベント: 「BatchGetDocuments: ${N} レスポンスで完了」
response_count 整数

RunQuery イベント

イベント: 「RunQuery」
transactional ブール値
retry_query_with_cursor ブール値
イベント: 「RunQuery: First Response Received」
// 100 個のレスポンスごとに受信
イベント: 「RunQuery: Received 100 documentation」
// サーバーによってハーフクローズが実行されたときのみ
イベント: 「RunQuery: Received RunQueryResponse.Done」
イベント: 「RunQuery: Retryable Error.」
error.message 文字列
イベント: 「RunQuery: Error.」
error.message 文字列
イベント: 「RunQuery: Completed」
response_count 整数

トランザクションイベント

スパン: 「Transaction.Run」
transaction_type 文字列（「READ_ONLY」または「READ_WRITE」）。
attempts_allowed 整数
attempts_remaining 整数
// トランザクションが再試行された場合のみ
イベント: 「トランザクションの再試行を開始」

commit イベント

スパン: 「BulkWriter.Commit」
doc_count 整数
スパン: 「Batch.Commit」
doc_count 整数
スパン: 「Transaction.Commit」
doc_count 整数

例外的なイベント

スパン ステータス = ERROR
exception.message 文字列
exception.type 文字列
exception.stacktrace 文字列