Diese Seite enthält eine detaillierte Beschreibung der einzelnen clientseitigen Messwerte, die Cloud Spanner bietet. Weitere Informationen zum Ansehen und Verwalten clientseitiger Messwerte finden Sie unter Clientseitige Messwerte ansehen und verwalten.
Clientseitige Messwerte liefern Latenzinformationen zu den RPC-Anfrageversuchen und -vorgängen des Clients an Spanner.
Ein Versuch ist eine einzelne RPC-Anfrage vom Client an Spanner. Der Client kann mehrere Versuche unternehmen, wenn eine Anfrage fehlschlägt.
Ein Vorgang stellt den Abschluss aller RPC-Anfragen dar, einschließlich aller Versuche, die der Client an Spanner gesendet hat. Ein Vorgang ist abgeschlossen, wenn der Client eine Antwort erhält oder alle Versuche ausgeschöpft sind.
Eine RPC-Anfrage erreicht zuerst das Google Front End (GFE) und dann das Spanner API-Frontend (AFE). Weitere Informationen finden Sie unter Latenzpunkte in einer Spanner-Anfrage.
Der Client berechnet die Messwerte für die GFE- und AFE-Latenzen anhand von Zeitinformationen, die das GFE und das AFE den Antwortheadern hinzufügen. Wenn ein Versuch endet, bevor der Client Antwortheader empfängt, zeichnet der Client für diesen Versuch kein GFE- oder AFE-Latenzbeispiel auf. Dies ist beispielsweise der Fall, wenn die Anfragefrist abläuft und der Client den Fehler DEADLINE_EXCEEDED zurückgibt.
Stattdessen erhöht der Client den entsprechenden Messwert für die Anzahl der Verbindungsfehler. Daher enthalten die GFE- und AFE-Latenzverteilungen nur Versuche, die Antwortheader erhalten haben, und können normal aussehen, auch wenn viele Versuche ein Zeitlimit überschreiten.
Der Client zeichnet GFE-Messwerte nur für Anfragen auf, die über das GFE laufen. Wenn eine Anfrage DirectPath verwendet (directpath_used ist true), zeichnet der Client für diese Anfrage weder die GFE-Latenz noch die Anzahl der GFE-Verbindungsfehler auf.
Diese Messwerte umfassen die Messwerttypen DISTRIBUTION und INT64. Weitere Informationen finden Sie unter Werttypen und Messwertarten.
Sie können mit den Spanner-Clientbibliotheken für Java, Go, Node.js und Python auf clientseitige Messwerte zugreifen.
Die clientseitigen Messwerte unterstützen alle Spanner-Methoden in der google.spanner.v1.Spanner-RPC API.
Alle clientseitigen Messwerte haben die folgenden Dimensionen:
project ID: die Projekt-ID von Google Cloud .instance ID: Die Spanner-Instanz-ID.database ID: Die Spanner-Datenbank-ID.location: Die Google Cloud -Region, in der die clientseitigen Messwerte veröffentlicht werden. Wenn Ihre Anwendung außerhalb von Google Cloudbereitgestellt wird, werden die Messwerte in der Regionglobalveröffentlicht.method: der Name der RPC-Methode, z. B.spanner.commit.status: der RPC-Status, z. B.OKoderINTERNAL.client_name: Name und Version der Bibliothek, z. B.spanner-java/6.70.1.directpath_enabled: Gibt an, ob die Clientbibliothek so konfiguriert ist, dass sie direkt auf Spanner zugreift, ohne das Frontend zu durchlaufen.directpath_used: Gibt an, ob die aktuelle Anfrage direkt an Spanner gesendet wurde, ohne das Frontend zu durchlaufen. Einfalse-Wert, währenddirectpath_enabledden Werttruehat, gibt an, dass die Anfrage auf den Standardpfad über das GFE zurückgefallen ist.
Anzahl der AFE-Verbindungsfehler
Der Messwert für die Anzahl der AFE-Verbindungsfehler erfasst die Anzahl der Versuche, bei denen der Client keine Spanner-AFE-Timing-Informationen in den Antwortheadern erhalten hat. Dies ist beispielsweise der Fall, wenn die Anfrage das AFE nicht erreicht oder wenn die Zeitüberschreitung eintritt, bevor der Client Antwortheader empfängt. Für diese Versuche wird im Messwert AFE-Latenzen keine Stichprobe erfasst.
Der Messwert für die Anzahl der AFE-Verbindungsfehler hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/afe_connectivity_error_countMetric value type:INT64
AFE-Latenzen
Der Messwert für die AFE-Latenzen misst die Zeit zwischen dem Empfang der RPC-Anfrage vom Client durch das Spanner-AFE und dem Beginn des Schreibens der Antwort durch das Spanner-AFE.
Der Client berechnet diesen Wert aus den Zeitinformationen in den Antwortheadern. Wenn ein Versuch endet, bevor der Client Antwortheader empfängt, zeichnet der Client keine Stichprobe auf und erhöht stattdessen den Messwert Anzahl der AFE-Verbindungsfehler.
Der Messwert „AFE-Latenzen“ hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/afe_latenciesMetric value type:DISTRIBUTION
Anzahl der Versuche
Der Messwert für die Anzahl der Versuche erfasst die Anzahl der ausgeführten Versuche. Der Wert attempt_count ist normalerweise mit dem Wert operation_count identisch.
Wenn der Client vorübergehende Fehler empfängt, ist der Wert attempt_count die Summe aller Versuche.
Der Messwert „Anzahl der Versuche“ hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/attempt_countMetric value type:INT64
Latenzen bei Versuchen
Der Messwert für die Latenzen von Versuchen misst die Dauer eines einzelnen RPC-Versuchs, vom Senden der Anfrage durch den Client bis zum erfolgreichen oder fehlgeschlagenen Versuch.
Der Wert attempt_latencies ist normalerweise mit dem Wert operation_latencies identisch. Wenn der Client vorübergehende Fehler empfängt, ist der Wert operation_latencies die Summe aller attempt_latencies-Werte.
Der Messwert „Latenzen für Versuche“ hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/attempt_latenciesMetric value type:DISTRIBUTION
Anzahl der GFE-Verbindungsfehler
Der Messwert für die Anzahl der GFE-Verbindungsfehler erfasst die Anzahl der Versuche, bei denen der Client keine GFE-Timing-Informationen in den Antwortheadern erhalten hat. Dies ist beispielsweise der Fall, wenn die Anfrage das GFE nicht erreicht oder wenn die Zeitüberschreitung auftritt, bevor der Client Antwortheader empfängt. Für diese Versuche wird im Messwert GFE-Latenzen keine Stichprobe aufgezeichnet.
Der Messwert für die Anzahl der GFE-Verbindungsfehler hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/gfe_connectivity_error_countMetric value type:INT64
GFE-Latenzen
Der GFE-Latenzmesswert misst die Zeit zwischen dem Empfang der RPC-Anfrage vom Client durch das GFE und dem Empfang des ersten Bytes der Antwort durch das GFE. Dieser Messwert enthält nicht die Zeit, die für einen TCP- oder TLS-Handshake benötigt wird.
Der Client berechnet diesen Wert aus den Zeitinformationen in den Antwortheadern. Wenn ein Versuch endet, bevor der Client Antwortheader empfängt, zeichnet der Client keine Stichprobe auf und erhöht stattdessen den Messwert GFE-Verbindungsfehleranzahl. Wenn die Anzahl der GFE-Verbindungsfehler steigt, bedeuten normal aussehende GFE-Latenzen nicht, dass die Latenz niedrig ist.
Der Messwert für GFE-Latenzen hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/gfe_latenciesMetric value type:DISTRIBUTION
Anzahl der Vorgänge
Der Messwert für die Anzahl der Vorgänge erfasst die Anzahl der Vorgänge, die alle 60 Sekunden ausgeführt werden.
Der Messwert „Anzahl der Vorgänge“ hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/operation_countMetric value type:INT64
Vorgangslatenzen
Der Messwert für die Vorgangslatenz misst die Umlaufzeit eines Vorgangs von der gRPC-Ebene des Clients zu Spanner und zurück zum Client.
Der Messwert „Vorgangslatenzen“ hat die folgenden Attribute:
Metric name:spanner.googleapis.com/client/operation_latenciesMetric value type:DISTRIBUTION