Auf dieser Seite finden Sie eine allgemeine Übersicht über die Komponenten, die an einer Spanner-Anfrage beteiligt sind, und darüber, wie sich die einzelnen Komponenten auf die Latenz auswirken können.
Spanner API-Anfragen
Zu den allgemeinen Komponenten, die für eine Spanner API-Anfrage verwendet werden, gehören:
Spanner-Clientbibliotheken, die eine Abstraktionsebene über gRPC bereitstellen und Details zur Serverkommunikation wie Sitzungsverwaltung, Transaktionen und Wiederholungsversuche verarbeiten.
Das Google Front End (GFE), ein Infrastrukturdienst, der allen Diensten von Google Cloud gemeinsam ist, einschließlich Spanner. Das GFE prüft, ob alle TLS-Verbindungen (Transport Layer Security) beendet wurden, und schützt vor Denial-of-Service-Angriffen. Weitere Informationen zum GFE finden Sie unter Google Front End Service.
Das Spanner API-Frontend (AFE), das verschiedene Prüfungen der API-Anfrage durchführt (einschließlich Authentifizierung, Autorisierung und Kontingentprüfungen) und Sitzungen und Transaktionsstatus verwaltet.
Die Spanner-Datenbank, die Lese- und Schreibvorgänge in der Datenbank ausführt.
Wenn Sie einen Remote-Prozeduraufruf an Spanner senden, bereiten die Spanner-Clientbibliotheken die API-Anfrage vor. Anschließend durchläuft die API-Anfrage sowohl das GFE als auch das Spanner-AFE, bevor sie die Spanner-Datenbank erreicht.
Durch Messen und Vergleichen der Anfragelatenzen zwischen verschiedenen Komponenten und der Datenbank können Sie feststellen, welche Komponente das Problem verursacht. Diese Latenzen umfassen Client-End-to-End-, GFE-, Spanner API-Anfrage- und Abfragelatenzen.

In den folgenden Abschnitten werden die einzelnen Latenztypen aus dem vorherigen Diagramm erläutert.
Direkte Verbindung
Anwendungstraffic, der bestimmte Kriterien erfüllt, kann direkt an Spanner weitergeleitet werden. Dabei wird das Google Front End (GFE) umgangen und die Leistung optimiert. Die direkte Verbindung kann für Anwendungen aktiviert werden, die die folgenden Kriterien erfüllen:
- Ausführung in der Compute Engine oder Google Kubernetes Engine.
- Verwenden Sie den globalen Endpunkt.
- In einem Netzwerk, das mit Routen und Firewallregeln konfiguriert ist, die ausgehenden Traffic zu
34.126.0.0/18und2001:4860:8040::/42zulassen. - Verwendet die Clientbibliotheksversionen:
- Java: 6.111.0 oder höher.
- Go: 1.88.0 oder höher.
- Die Anmeldedaten, die Sie für die Anwendungen verwenden, haben die Berechtigung
spanner.databases.get.
Dieses Feature kann aktiviert werden, indem die Umgebungsvariable GOOGLE_SPANNER_ENABLE_DIRECT_ACCESS auf true gesetzt wird, oder über die Konfiguration Ihrer Clientbibliothek (setEnableDirectAccess(true) in Java, ClientConfig.EnableDirectAccess in Go oder die Verbindungs-Property enableDirectAccess=true im JDBC-Treiber).
Wenn Sie prüfen möchten, ob die direkte Verbindung zu Spanner verwendet wird, können Sie die Nutzungslabels in Ihren clientseitigen Messwerten im Auge behalten.
End-to-End-Latenz
Die End-to-End-Latenz ist die Zeit (in Millisekunden) zwischen dem ersten Byte der Spanner API-Anfrage, die der Client an die Datenbank sendet (sowohl über das GFE als auch über das Spanner API-Frontend), und dem letzten Byte der Antwort, die der Client von der Datenbank empfängt.

Der Messwert
spanner.googleapis.com/client/operation_latencies gibt die Zeit zwischen dem ersten Byte der gesendeten API-Anfrage und dem letzten Byte der empfangenen Antwort an. Dazu gehören auch Wiederholungsversuche, die von der Clientbibliothek ausgeführt werden.
Weitere Informationen finden Sie unter Clientseitige Messwerte ansehen und verwalten.
GFE-Latenz
Die Google Front End-Latenz (GFE) ist die Zeit (in Millisekunden) zwischen dem Empfang eines Remote-Prozeduraufrufs vom Client durch das Google-Netzwerk und dem Empfang des ersten Bytes der Antwort durch das GFE. Diese Latenz umfasst keinen TCP- oder TLS-Handshake.

Jede Antwort von Spanner (REST oder gRPC) enthält einen Header, der die Gesamtzeit zwischen dem GFE und dem Backend (dem Spanner-Dienst) für die Anfrage und die Antwort enthält. So lässt sich die Quelle der Latenz zwischen dem Client und dem GFE besser unterscheiden.
Mit dem Messwert spanner.googleapis.com/client/gfe_latencies wird die GFE-Latenz für Spanner-Anfragen erfasst und angezeigt.
Der Client liest die GFE-Latenz aus den Antwortheadern. Wenn eine Anfrage fehlschlägt oder ein Zeitüberschreitungsfehler auftritt, bevor der Client sie empfängt (z. B. mit einem DEADLINE_EXCEEDED-Fehler), zeichnet der Client die GFE-Latenz nicht auf und erhöht stattdessen den Messwert spanner.googleapis.com/client/gfe_connectivity_error_count. Prüfen Sie bei der Fehlerbehebung von Zeitüberschreitungen zusätzlich zur GFE-Latenz diesen Messwert und den Messwert spanner.googleapis.com/client/attempt_latencies. Wenn die Anzahl der GFE-Verbindungsfehler steigt, schlagen Anfragen fehl, bevor der Client Antwortheader empfängt, auch wenn die GFE-Latenz normal aussieht. In diesem Fall kann die Latenz überall zwischen dem Client und dem Spanner-Backend auftreten.
Weitere Informationen finden Sie unter Clientseitige Messwerte ansehen und verwalten.
Latenz von Spanner API-Anfragen
Die Latenz von Spanner API-Anfragen ist die Zeit (in Sekunden) zwischen dem Empfang des ersten Bytes einer Anfrage durch das Spanner AFE und dem Senden des letzten Bytes einer Antwort durch das Spanner API-Frontend. Die Latenz umfasst die Zeit, die für die Verarbeitung von API-Anfragen sowohl im Spanner-Backend als auch in der API-Ebene benötigt wird. Diese Latenz umfasst jedoch nicht den Netzwerk- oder Reverse-Proxy-Overhead zwischen Spanner-Clients und -Servern.

Mit dem Messwert spanner.googleapis.com/api/request_latencies wird die Spanner-AFE-Latenz für Spanner-Anfragen erfasst und angezeigt. Weitere Informationen finden Sie unter Spanner-Messwerte.
Abfragelatenz
Die Abfragelatenz ist die Zeit (in Millisekunden), die für die Ausführung von SQL-Abfragen in der Spanner-Datenbank benötigt wird.

Die Abfragelatenz ist für die executeSql API verfügbar.
Wenn der Parameter QueryMode auf WITH_STATS oder WITH_PLAN_AND_STATS gesetzt ist, sind die ResultSetStats von Spanner in den Antworten verfügbar. ResultSetStats enthält die verstrichene Zeit für die Ausführung von Abfragen in der Spanner-Datenbank.
Informationen zum Erfassen und Visualisieren der Abfragelatenz finden Sie unter Abfragelatenz mit OpenTelemetry erfassen.