Clientseitige Messwerte ansehen und verwalten

Auf dieser Seite finden Sie Informationen zum Aufrufen und Verwalten clientseitiger Messwerte. Clientseitige Messwerte liefern Latenzinformationen zu den RPC-Anfragen des Clients an Spanner.

Spanner bietet clientseitige Messwerte, die Sie zusammen mit serverseitigen Messwerten verwenden können, um die Leistung zu optimieren und bei Bedarf Leistungsprobleme zu beheben.

Clientseitige Messwerte werden ab dem Zeitpunkt gemessen, an dem eine Anfrage von Ihrer Anwendung gesendet wird, bis zu dem Zeitpunkt, an dem die Antwort von Ihrer Anwendung empfangen wird. Im Gegensatz dazu werden serverseitige Messwerte ab dem Zeitpunkt gemessen, zu dem Spanner eine Anfrage empfängt, bis zu dem Zeitpunkt, an dem das letzte Byte an Daten an den Client gesendet wird.

Hinweise

  1. Clientseitige Messwerte sind verfügbar, nachdem Sie die Cloud Monitoring API aktiviert haben.

    Monitoring API aktivieren

  2. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Metric Writer (roles/monitoring.metricWriter) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie für den Zugriff auf clientseitige Messwerte benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Diese vordefinierte Rolle enthält die Berechtigung monitoring.timeSeries.create, die für den Zugriff auf clientseitige Messwerte erforderlich ist.

    Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Auf clientseitige Messwerte zugreifen

Sie können über die folgenden Clientbibliotheken auf clientseitige Messwerte zugreifen:

  • Java in Version 6.81.0 und höher.
  • Go in Version 1.71.0 und höher.

So rufen Sie die clientseitigen Messwerte im Metrics Explorer auf:

  1. Rufen Sie in der Google Cloud Console die Seite „Metrics Explorer“ auf.

    Zum Metrics Explorer

  2. Wählen Sie Ihr Projekt aus.

  3. Klicken Sie auf Messwert auswählen.

  4. Suchen Sie nach spanner.googleapis.com/client.

  5. Wählen Sie den Messwert aus und klicken Sie auf Übernehmen.

Weitere Informationen zum Gruppieren oder Aggregieren von Messwerten finden Sie unter Abfragen mit Menüs erstellen.

Ihre Anwendung muss mindestens eine Minute lang ausgeführt werden, bevor Sie veröffentlichte Messwerte sehen können.

Clientseitige Messwerte deaktivieren

Wenn Sie bereits OpenTelemetry verwenden, um benutzerdefinierte Clientmesswerte zu erfassen, können Sie die Verwendung clientseitiger Messwerte mit dem folgenden Code deaktivieren:

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Go

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Preise

Für das Aufrufen clientseitiger Messwerte in Cloud Monitoring fallen keine Kosten an. Die Verwendung der Monitoring API kann Kosten verursachen. Weitere Informationen finden Sie unter Google Cloud Observability-Preise.

Nächste Schritte