Client-side traces, which are collected by executing RPCs, provide several pieces of information for every request from a client, including spans with timestamps of when the client sent the RPC request and when the client received the RPC response. The spans include latency introduced by the network and client system.
Client-side traces can include the following information:
Span metadata
| Span ID | Unique ID of this span |
| Parent Span ID | ID of the parent span, not set for root span |
| Project ID | Google Cloud project ID that ingested the trace |
| Start Time | Span start time |
| End Time | Span end time |
Span attributes
| Client Version | |
|---|---|
| otel.scope.version | String |
| Client Environment | |
| gcp.datastore.memory_utilization | double (percentage) |
| Client Connection Properties | |
| gcp.datastore.settings.channel.needs_credentials | boolean |
| gcp.datastore.settings.channel.needs_endpoint | boolean |
| gcp.datastore.settings.channel.needs_headers | boolean |
| gcp.datastore.settings.channel.should_auto_close | boolean |
| gcp.datastore.settings.channel.transport_name | string Ex. "grpc" |
| gcp.datastore.settings.credentials.authentication_type | string Ex. "OAuth2" |
| gcp.datastore.settings.host | string Ex. "datastore.googleapis.com:443" |
| Database Properties | |
| gcp.datastore.settings.project_id | string Google Cloud project ID that contains the Datastore database |
| gcp.datastore.settings.database_id | string Database external ID (name) |
| Client RPC Retry Settings | |
| gcp.datastore.settings.retrySettings.initial_retry_delay | string Duration in seconds Ex. 0.01s |
| gcp.datastore.settings.retrySettings.initial_rpc_timeout | |
| gcp.datastore.settings.retrySettings.max_attempts | integer (count) |
| gcp.datastore.settings.retrySettings.max_retry_delay | string Duration in seconds Ex. 0.1s |
| gcp.datastore.settings.retrySettings.max_rpc_timeout | |
| gcp.datastore.settings.retrySettings.retry_delay_multiplier | double |
| gcp.datastore.settings.retrySettings.rpc_timeout_multiplier | double |
| gcp.datastore.settings.retrySettings.total_timeout | string Duration in seconds |
| OpenTelemetry Configuration | |
| otel.scope.name | string Ex. "com.google.cloud.datastore" |
| service.name | Sparky |
| telemetry.sdk.language | string Ex. "java" |
| telemetry.sdk.name | opentelemetry |
| telemetry.sdk.version | Ex. 1.29.0 |
Logs and events
Client-side traces provide the following logs and events.
Lookup events
| Event: "Lookup complete" "Transaction.Lookup complete" |
|
|---|---|
| Received | Integer |
| Missing | Integer |
| Deferred | Integer |
| transactional | Boolean |
| transaction_id | String |
Commit Events
| Event: "Commit complete" "Transaction.Commit complete" |
|
|---|---|
| doc_count | Integer |
| transactional | Boolean |
| transaction_id | String |
RunQuery Events
| Event: "RunQuery complete" "Transaction.RunQuery complete" |
|
|---|---|
| doc_count | Integer |
| transactional | Boolean |
| transaction_id | String |
| read_conistencey | STRONG or EVENTUAL |
| more_results | One of:
|