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
Google Cloud project ID that contains the Datastore database
gcp.datastore.settings.database_id
string
Database external ID (name)
Database external ID (name)
Client RPC Retry Settings
gcp.datastore.settings.retrySettings.initial_retry_delay
string
Duration in seconds Ex. 0.01s
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
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
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"
"RunQuery complete"
"Transaction.RunQuery complete"
doc_count
Integer
transactional
Boolean
transaction_id
String
read_conistencey
STRONG
or EVENTUAL
more_results
One of:
-
NOT_FINISHED -
MORE_RESULTS_AFTER_LIMIT -
MORE_RESULTS_AFTER_CURSOR -
NO_MORE_RESULTS
