客户端轨迹是通过执行 RPC 收集的，可为来自客户端的每个请求提供多条信息，包括包含客户端发送 RPC 请求和客户端收到 RPC 响应的时间戳的跨度。这些跨度包括网络和客户端系统引入的延迟时间。
客户端轨迹可能包含以下信息：
Span 元数据
| span ID | 此代码段的唯一 ID |
| 父级 Span ID | 父 span 的 ID，不为根 span 设置 |
| 项目 ID | Google Cloud 提取轨迹的项目 ID |
| 开始时间 | 跨度开始时间 |
| 结束时间 | 跨度结束时间 |
span 属性
| 客户端版本 | |
|---|---|
| otel.scope.version | 字符串 |
| 客户端环境 | |
| gcp.datastore.memory_utilization | 双精度（百分比） |
| 客户端连接属性 | |
| gcp.datastore.settings.channel.needs_credentials | 布尔值 |
| gcp.datastore.settings.channel.needs_endpoint | 布尔值 |
| gcp.datastore.settings.channel.needs_headers | 布尔值 |
| gcp.datastore.settings.channel.should_auto_close | 布尔值 |
| gcp.datastore.settings.channel.transport_name | 字符串（例如“grpc” |
| gcp.datastore.settings.credentials.authentication_type | 字符串（例如“OAuth2” |
| gcp.datastore.settings.host | 字符串（例如"datastore.googleapis.com:443" |
| 数据库属性 | |
| gcp.datastore.settings.project_id | string Google Cloud 包含 Datastore 数据库的项目 ID |
| gcp.datastore.settings.database_id | string 数据库外部 ID（名称） |
| 客户端 RPC 重试设置 | |
| gcp.datastore.settings.retrySettings.initial_retry_delay | string 时长（以秒为单位）0.01 秒 |
| gcp.datastore.settings.retrySettings.initial_rpc_timeout | |
| gcp.datastore.settings.retrySettings.max_attempts | 整数（计数） |
| gcp.datastore.settings.retrySettings.max_retry_delay | string 时长（以秒为单位）0.1 秒 |
| gcp.datastore.settings.retrySettings.max_rpc_timeout | |
| gcp.datastore.settings.retrySettings.retry_delay_multiplier | 双精度 |
| gcp.datastore.settings.retrySettings.rpc_timeout_multiplier | 双精度 |
| gcp.datastore.settings.retrySettings.total_timeout | string 时长（以秒为单位） |
| OpenTelemetry 配置 | |
| otel.scope.name | 字符串（例如"com.google.cloud.datastore" |
| service.name | Sparky |
| telemetry.sdk.language | 字符串（例如"java" |
| telemetry.sdk.name | opentelemetry |
| telemetry.sdk.version | 例如：1.29.0 |
日志和事件
客户端轨迹会提供以下日志和事件。
查找事件
| 事件： “Lookup complete” “Transaction.Lookup complete” |
|
|---|---|
| 已接收 | 整数 |
| 缺失 | 整数 |
| 延迟 | 整数 |
| transactional | 布尔值 |
| transaction_id | 字符串 |
提交事件
| 事件： “提交完成” “Transaction.Commit complete” |
|
|---|---|
| doc_count | 整数 |
| transactional | 布尔值 |
| transaction_id | 字符串 |
RunQuery 事件
| 事件： “RunQuery complete” “Transaction.RunQuery complete” |
|
|---|---|
| doc_count | 整数 |
| transactional | 布尔值 |
| transaction_id | 字符串 |
| read_conistencey | STRONG 或 EVENTUAL |
| more_results | 以下各项中的一项：
|