本頁說明如何查看及管理用戶端指標。用戶端指標會提供用戶端對 Spanner 發出的 RPC 要求延遲時間資訊。
Spanner 提供用戶端指標，可與伺服器端指標搭配使用，以最佳化效能，並在發生效能問題時進行疑難排解。
用戶端指標的測量時間，是從要求離開應用程式開始，到應用程式收到回應為止。相較之下，伺服器端指標的測量時間範圍，是從 Spanner 收到要求到將資料的最後一個位元組傳送至用戶端為止。
存取用戶端指標
下列用戶端程式庫提供用戶端指標：
啟用 Cloud Monitoring API 後，即可取得用戶端指標。
如果使用者或服務帳戶已獲授身分與存取權管理 (IAM) monitoring.timeSeries.create權限，即可查看用戶端指標。下列 Spanner IAM 角色具備這項權限：
- Cloud Spanner 管理員 (
roles/spanner.admin) - Cloud Spanner 資料庫管理員 (
roles/spanner.databaseAdmin) - Cloud Spanner 資料庫讀取者 (
roles/spanner.databaseReader) - Cloud Spanner 資料庫使用者 (
roles/spanner.databaseUser)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」一文。
您或許還可透過自訂角色取得必要的 monitoring.timeSeries.create IAM 權限。
在 Metrics Explorer 中查看指標
前往 Google Cloud 控制台的「指標探索器」頁面。
選取專案。
按一下「Select a metric」(選取指標)。
搜尋
spanner.googleapis.com/client。選取指標，然後按一下「套用」。
如要進一步瞭解如何分組或匯總指標，請參閱「使用選單建立查詢」。
應用程式必須執行至少一分鐘，您才能查看任何已發布的指標。
停用用戶端指標
如果您已使用 OpenTelemetry 擷取自訂用戶端指標，可以選擇使用下列程式碼停用用戶端指標：
Java
Spanner spanner =
SpannerOptions.newBuilder()
.setProjectId("test-project")
.setBuiltInMetricsEnabled(false)
.build()
.getService();
Go
client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
DisableNativeMetrics: true,
})
定價
在 Cloud Monitoring 中查看用戶端指標不會產生費用。使用 Monitoring API 可能會產生費用。 詳情請參閱 Google Cloud Observability 定價。