查看及管理用戶端指標

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

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

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

存取用戶端指標

下列用戶端程式庫提供用戶端指標：

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

啟用 Cloud Monitoring API 後，即可取得用戶端指標。

啟用 Monitoring API

如果使用者或服務帳戶已獲授身分與存取權管理 (IAM) monitoring.timeSeries.create權限，即可查看用戶端指標。下列 Spanner IAM 角色具備這項權限：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」一文。

您或許還可透過自訂角色取得必要的 monitoring.timeSeries.create IAM 權限。

在 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 定價。

後續步驟