本頁說明如何查看及管理用戶端指標。用戶端指標會提供用戶端對 Spanner 發出的 RPC 要求延遲時間資訊。
Spanner 提供用戶端指標,可與伺服器端指標搭配使用,以最佳化效能,並在發生效能問題時進行疑難排解。
用戶端指標的測量時間,是從要求離開應用程式到應用程式收到回應為止。相較之下,伺服器端指標的測量時間範圍,是從 Spanner 收到要求到資料的最後一個位元組傳送至用戶端為止。
事前準備
啟用 Cloud Monitoring API 後,即可使用用戶端指標。
-
如要取得存取用戶端指標所需的權限,請要求管理員授予您專案的監控指標寫入者 (
roles/monitoring.metricWriter
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。這個預先定義的角色具備
monitoring.timeSeries.create
權限,這是存取用戶端指標的必要權限。
存取用戶端指標
您可以使用下列用戶端程式庫存取用戶端指標:
如要在 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 定價。