查看及管理用戶端指標

本頁說明如何查看及管理用戶端指標。用戶端指標會提供用戶端對 Spanner 發出的 RPC 要求延遲時間資訊。

Spanner 提供用戶端指標,可與伺服器端指標搭配使用,以最佳化效能,並在發生效能問題時進行疑難排解。

用戶端指標的測量時間,是從要求離開應用程式到應用程式收到回應為止。相較之下,伺服器端指標的測量時間範圍,是從 Spanner 收到要求到資料的最後一個位元組傳送至用戶端為止。

事前準備

  1. 啟用 Cloud Monitoring API 後,即可使用用戶端指標。

    啟用 Monitoring API

  2. 如要取得存取用戶端指標所需的權限,請要求管理員授予您專案的監控指標寫入者 (roles/monitoring.metricWriter) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。

    這個預先定義的角色具備 monitoring.timeSeries.create 權限,這是存取用戶端指標的必要權限。

    您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

存取用戶端指標

您可以使用下列用戶端程式庫存取用戶端指標:

  • Java 6.81.0 以上版本。
  • Go 1.71.0 以上版本。

如要在 Metrics Explorer 中查看用戶端指標,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「指標探索器」頁面。

    前往 Metrics Explorer

  2. 選取專案。

  3. 按一下「Select a metric」(選取指標)

  4. 搜尋 spanner.googleapis.com/client

  5. 選取指標,然後按一下「套用」

如要進一步瞭解如何分組或匯總指標,請參閱「使用選單建立查詢」。

應用程式必須執行至少一分鐘,您才能查看任何已發布的指標。

停用用戶端指標

如果您已使用 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 定價

後續步驟