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

クライアント側のトレースでは、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 整数（カウント）
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 ストリームが開始されました。」
試行 0 以上の整数（例: 2）。最初の試行の場合は 0
イベント: 「RunAggregationQuery レスポンスを受信しました。」
試行 0 以上の整数（例: 2）。最初の試行の場合は 0
イベント: 「RunAggregationQuery: 再試行可能なエラー。」
error.message 文字列
イベント: 「RunAggregationQuery: エラー。」
error.message 文字列

BatchGetDocuments イベント

イベント: 「BatchGetDocuments: 開始」
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: 再試行可能なエラー。」
error.message 文字列
イベント: 「RunQuery: Error.」
error.message 文字列
イベント: 「RunQuery: Completed.」
response_count 整数

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

Span: "Transaction.Run"
transaction_type 文字列（「READ_ONLY」または「READ_WRITE」）
attempts_allowed 整数
attempts_remaining 整数
// トランザクションが再試行されたときのみ
イベント: 「Initiate transaction retry」

Commit イベント

Span: "BulkWriter.Commit"
doc_count 整数
Span: "Batch.Commit"
doc_count 整数
Span: "Transaction.Commit"
doc_count 整数

例外的なイベント

Span Status = ERROR
例外メッセージ 文字列
exception.type 文字列
exception.stacktrace 文字列