Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Logging und Monitoring für Cloud Load Balancing-Callouts

Auf dieser Seite erfahren Sie, wie Sie Cloud Logging und Cloud Monitoring mit Service Extensions-Callouts für Cloud Load Balancing konfigurieren und verwenden.

Logging

In diesem Abschnitt wird das Logging für Application Load Balancer-Callouts beschrieben.

Logging für einen Backend-Dienst aktivieren

Sie können das Logging für Application Load Balancer-Callouts beim Erstellen des Dienstes aktivieren, indem Sie das Logging für den Backend-Dienst aktivieren, der das Ziel einer Anfrage ist (und nicht für den Backend-Dienst, der mit der Erweiterung verknüpft ist).

Verwenden Sie den Befehl gcloud compute backend-services update, um das Logging für den Ziel-Backend-Dienst zu aktivieren.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Ersetzen Sie Folgendes:

BACKEND_SERVICE: der Name des Backend-Dienstes.
RATE: ein Wert zwischen 0.0 und 1.0, wobei 0.0 dazu führt, dass keine Anfragen in Logs erfasst werden, und 1.0 bedeutet, dass 100% der Anfragen in Logs erfasst werden. Der Standardwert ist 1.0. Diese Einstellung ist nur wirksam, wenn sie mit dem Parameter enable-logging verwendet wird. Wenn Sie enable-logging weglassen, ist das Logging deaktiviert.
REGION: die Region des Backends
LOGGING_OPTIONAL_MODE: Aktiviert das Logging für optionale Felder in einem der folgenden Modi:
- INCLUDE_ALL_OPTIONAL enthält alle optionalen Felder.
- EXCLUDE_ALL_OPTIONAL (Standard): Zum Ausschließen aller optionalen Felder.
- CUSTOM enthält eine benutzerdefinierte Liste optionaler Felder.
OPTIONAL_FIELDS: eine durch Kommas getrennte Liste optionaler Felder, wenn Sie den Modus CUSTOM auswählen

Nachdem Sie das Logging für den Backend-Dienst aktiviert haben, werden HTTP- oder HTTPS-Anfragen mit Cloud Logging protokolliert.

Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf, um sich Logs anzusehen.

Weitere Informationen finden Sie auf den Seiten „Monitoring und Fehlerbehebung“ der Application Load Balancer-Dokumentation, z. B. Logging und Monitoring für interne Application Load Balancer.

Logeinträge für einen Backend-Dienst

Im Allgemeinen enthalten Logeinträge für Application Load Balancer Informationen, die für das Monitoring und die Fehlerbehebung bei Ihrem HTTP- oder HTTPS-Traffic nützlich sind. Log-Einträge enthalten die folgenden Informationen:

Informationen, die in den meisten Logs von Google Cloud angezeigt werden, wie z. B. Schweregrad, Projekt-ID, Projektnummer und Zeitstempel, wie im Log LogEntry beschrieben.
HttpRequest-Logfelder.

Anfrageprotokolle für HTTP- und HTTPS-Load-Balancer enthalten ein service_extension_info-Objekt in der JSON-Nutzlast des Load-Balancer-Logeintrags mit den folgenden Informationen:

Feld	Typ	Beschreibung
`backend_target_name`	String	Name des Backend-Ziels der Erweiterung.
`backend_target_type`	String	Typ des Backend-Ziels.
`chain`	String	Name der Erweiterungskette in der Diensterweiterungsressource, die der Anfrage entspricht.
`extension`	String	Name der Erweiterung innerhalb der Erweiterungskette.
`failed_open`	boolean	Wenn in der Erweiterungskonfiguration `failOpen` auf `true` gesetzt ist, gibt der Wert `true` für diesen Messwert an, dass die Verarbeitung fortgesetzt wurde, wenn die Erweiterung das Zeitlimit überschritten hat oder fehlgeschlagen ist. Gilt nur für regionale externe Application Load Balancer, regionale interne Application Load Balancer und regionenübergreifende interne Application Load Balancer.
`grpc_status`	enum	Der aktuelle Status des gRPC-Streams. Weitere Informationen finden Sie unter gRPC-Statuscodes.
`per_processing_request_info`	Array	Eine Liste mit entweder `ProcessingRequest`-Statistiken für `ext_proc`-Erweiterungen oder `CheckRequest`-Statistiken für `ext_authz`-Erweiterungen, die über den gRPC-Stream auftreten.
`per_processing_request_info[].event_type`	enum	Der Ereignistyp von `ProcessingRequest`. Kann einer der folgenden Werte sein: `REQUEST_HEADERS`, `REQUEST_BODY`, `RESPONSE_HEADERS` oder `RESPONSE_BODY`.
`per_processing_request_info[].latency`	Dauer	Die Dauer ab dem Zeitpunkt, an dem das erste Byte der `ProcessingRequest`-Nachricht an die Erweiterung gesendet wird, bis zu dem Zeitpunkt, an dem das letzte Byte der `ProcessingResponse`-Nachricht empfangen wird.
`per_processing_request_info[].processing_effect`	enum	Das Ergebnis der Verarbeitung für jedes Ereignis in einer Verarbeitungsanfrage. Gilt nur für regionale externe Application Load Balancer, regionale interne Application Load Balancer und regionenübergreifende interne Application Load Balancer. Kann einer der folgenden Werte sein: `NONE`: Gibt an, dass der Inhalt nicht geändert wurde. `NONE_FAILED_OPEN`: Gibt an, dass keine Mutationen durchgeführt wurden, da die Erweiterung nicht geöffnet werden konnte. `CONTENT_MODIFIED`: Gibt an, dass Inhalte durch eine erfolgreich angewendete Mutationsanfrage geändert wurden. `IMMEDIATE_RESPONSE`: Gibt an, dass die Erweiterung eine sofortige Antwort gesendet hat, um die weitere Verarbeitung zu beenden. `MUTATION_REJECTED`: Gibt an, dass die Erweiterung mindestens eine unzulässige Änderung angefordert hat und die weitere Verarbeitung eingestellt wurde. Entsprechende Fehlermeldungen werden protokolliert. `UNSPECIFIED`: Gibt an, dass die Auswirkung der Verarbeitung nicht bekannt ist.
`per_processing_request_info[].processing_effect_details`	String	Wenn `processing_effect` den Wert `MUTATION_REJECTED` hat, werden die Details dazu angezeigt, warum eine Mutation abgelehnt wurde. Gilt nur für regionale externe Application Load Balancer, regionale interne Application Load Balancer und regionenübergreifende interne Application Load Balancer.
`resource`	String	Name der Erweiterungsressource

Monitoring

In diesem Abschnitt wird beschrieben, wie Sie mit Service Extensions konfigurierte Callouts für Cloud Load Balancing überwachen.

Monitoring-Dashboard aufrufen

Application Load Balancer exportieren Monitoringdaten nach Cloud Monitoring.

Monitoring-Messwerte können für Folgendes verwendet werden:

Bewertung der Konfiguration, Nutzung und Leistung eines Load-Balancers
Fehlerbehebung
Verbesserung der Ressourcenauslastung und Nutzerfreundlichkeit

So rufen Sie ein vordefiniertes Dashboard auf:

Rufen Sie in der Google Cloud Console die Seite Dashboard-Übersicht auf.
Zur Dashboard-Übersicht
Klicken Sie im Bereich Kategorien auf GCP.
- Wenn Sie eine Liste der Dashboards für alle Ihre Load Balancer aufrufen möchten, klicken Sie in der Liste GCP-Dashboards auf das Dashboard mit dem Namen Google Cloud Load Balancer. Wenn Sie das Dashboard eines bestimmten Load Balancers anzeigen möchten, suchen Sie den Load Balancer in der Liste und klicken Sie auf den Namen.
- Wählen Sie das entsprechende Dashboard aus, um nur die vordefinierten Dashboards für Ihre Load Balancer aufzurufen.

Zusätzlich zu den vordefinierten Dashboards in Monitoring können Sie über die Cloud Monitoring API benutzerdefinierte Dashboards erstellen, Benachrichtigungen einrichten und Messwerte abrufen.

Weitere Informationen finden Sie auf den Seiten „Monitoring und Fehlerbehebung“ der Application Load Balancer-Dokumentation, z. B. Logging und Monitoring für interne Application Load Balancer.

Monitoring-Messwerte für Callouts

Sie können die folgenden Messwerte für Callout-Backend-Dienste überwachen.

In der Vorabversion können Sie die folgenden Messwerte für Erweiterungen auf allen Arten von Application Load Balancern überwachen. Diese Messwerte haben das Präfix networkservices.googleapis.com. Das Präfix wird in den Einträgen der folgenden Tabelle weggelassen.

In der folgenden Tabelle finden Sie den Messwerttyp, den Anzeigenamen, die Art, den Typ, die Einheit und die Beschreibung für jeden Messwert.

Messwerttyp	Anzeigename Art, Typ, Einheit Beschreibung
`extension/invocation_count`	Anzahl der Erweiterungsaufrufe `DELTA`, `INT64`, `1` Die Anzahl der an die Erweiterung gesendeten Aufrufe.
`extension/invocation_latencies`	Latenzen beim Aufruf von Erweiterungen `DELTA`, `DISTRIBUTION`, `ms` Die Verteilung, die aus der Latenz jedes Erweiterungsaufrufs berechnet wird. Gilt nur für Aufruferweiterungen; wird für Plug‑ins nicht unterstützt.
`extension/sent_chunks_count`	Anzahl der von der Erweiterung gesendeten Chunks `DELTA`, `INT64`, `1` Gilt nur für `request_body`- und `response_body`-Ereignisse. Die Anzahl der Datenblöcke, die an die Erweiterung gesendet wurden.
`extension/received_chunks_count`	Anzahl der von der Erweiterung empfangenen Chunks `DELTA`, `INT64`, `1` Gilt nur für `request_body`- und `response_body`-Ereignisse. Die Anzahl der von der Erweiterung empfangenen Chunks.
`extension/failed_open_count`	Fehlgeschlagene Aufrufe der Erweiterung mit Fail-Open `DELTA`, `INT64`, `1` Die Anzahl der fehlgeschlagenen Aufrufe, wenn das System für Fail-Open konfiguriert war und die Anfrage fortgesetzt werden durfte.
`extension/mutation_rejections_count`	Anzahl der Ablehnungen von Erweiterungsmutationen `DELTA`, `INT64`, `1` Die Anzahl der Aufrufe, die Anfrageheader-, Body- oder Trailer-Mutationen angefordert haben, aber abgelehnt wurden. Ablehnungen können aus verschiedenen Gründen auftreten, z. B. wenn die Mutation ungültig ist oder die Größenbeschränkungen überschreitet.
`extension/sent_bytes_count`	Anzahl der von der Erweiterung gesendeten Byte `DELTA`, `INT64`, `By` Die Anzahl der an die Erweiterung gesendeten Byte.
`extension/received_bytes_count`	Anzahl der von der Erweiterung empfangenen Byte `DELTA`, `INT64`, `By` Die Anzahl der von der Erweiterung empfangenen Byte.

Sie können auch die folgenden Messwerte überwachen. Diese Messwerte haben das Präfix loadbalancing.googleapis.com/. Das Präfix wird in den Einträgen der Tabelle weggelassen.

Messwerttyp	Anzeigename Art, Typ, Einheit Beschreibung
`https/backend_request_count`, `https/external/regional/backend_request_count`, `https/internal/backend_request_count`	Anzahl der Backend-Anfragen `DELTA`, `INT64`, `1` Die Anzahl der Aufrufe eines Callout-Backend-Dienstes vom Application Load Balancer.
`https/backend_request_bytes_count`, `https/external/regional/backend_request_bytes_count`, `https/internal/backend_request_bytes_count`	Backend-Anfragebyte `DELTA`, `INT64`, `By` Die Anzahl der Byte, die vom Load Balancer an den Callout-Backend-Dienst gesendet wurden.
`https/backend_response_bytes_count`, `https/external/regional/backend_response_bytes_count`, `https/internal/backend_response_bytes_count`	Backend-Antwortbyte `DELTA`, `INT64`, `By` Die Anzahl der Byte, die der Load Balancer vom Erweiterungs-Backend empfangen hat.
`https/backend_latencies`, `https/external/regional/backend_latencies`, `https/internal/backend_latencies`	Backend-Latenz `DELTA`, `DISTRIBUTION`, `ms` Eine Verteilung, die aus der Summe der Latenzen jedes Erweiterungsaufrufs zwischen dem Load Balancer und dem Callout-Backend-Dienst berechnet wird. Alle 60 Sekunden wird eine Stichprobe erstellt.

Nächste Schritte

Logeinträge für Callouts ansehen