Fehlerbehebung bei Push-Abos

Push-Abonnenten sind eine Art von Pub/Sub-Abonnenten, bei denen Nachrichten von Pub/Sub an einen vom Nutzer angegebenen HTTPS-Endpunkt gesendet werden. Der Nutzer bestätigt eine Push-Nachricht, indem er eine HTTP 200-Antwort auf die Anfrage des Push-Servers zurückgibt. In diesem Dokument finden Sie einige allgemeine Tipps zur Fehlerbehebung bei Pub/Sub-Push-Abos. Weitere Informationen zu Push-Abos finden Sie im Leitfaden für Push-Abos.

Um Ihr Pub/Sub-Abo effektiv zu überwachen, sollten Sie sich zuerst den Status der Zustellungslatenz (subscription/delivery_latency_health_score) ansehen, um zu prüfen, welche Faktoren zu einer unerwarteten Latenz beitragen könnten.

Fehlerhafte oder langsame Push-Endpunkte

Wenn der Endpunkt einen Fehlerantwortcode zurückgibt, gilt die Nachrichtenzustellung als fehlgeschlagen und wird später noch einmal versucht. Dies kann dazu führen, dass der Endpunkt doppelte Nachrichten empfängt.

Es gibt mehrere Messwerte, die Sie zum Beobachten von Push-Abos verwenden können. Mit dem Messwert subscription/push_request_count in Cloud Metrics werden Antworten vom Push-Endpunkt nach response_code und response_class kategorisiert. Die Antworten sind nützlich, um potenzielle Fehlfunktionen von Endpunkten zu erkennen. Wenn dieser Messwert Daten mit einem response_class ungleich ack enthält, bedeutet das, dass der Push-Endpunkt Fehler an Pub/Sub zurückgibt. Zu den häufigsten Fehlern gehören:

  • Eine deadline_exceeded-Antwortklasse gibt an, dass der Push-Endpunkt nicht innerhalb der erforderlichen Bestätigungsfrist (ack) geantwortet hat. Mit dem Messwert subscription/push_request_latencies lässt sich die Push-Bestätigungslatenz verfolgen.

  • Eine invalid-Antwortklasse gibt an, dass der Endpunkt eine Antwort zurückgesendet hat, die Pub/Sub nicht verstehen oder richtig verarbeiten konnte.

  • Eine Antwortklasse vom Typ remote_server_4xx weist in der Regel auf Authentifizierungs- oder Berechtigungsprobleme hin. Dies sind HTTP-Antwortcodes, die vom Endpunkt zurückgegeben werden. Sehen Sie sich also die Szenarien an, in denen dieser Antwortcode zurückgegeben wird. Wenn die Authentifizierung aktiviert ist, prüfen Sie, ob Ihr Konto die richtige Berechtigung für den Endpunkt hat. Weitere Informationen zur Authentifizierung bei Push-Abos

  • Eine remote_server_5xx-Antwortklasse weist auf ein serverseitiges Problem auf der Endpunktseite hin. Der Endpunkt kann die Anfrage nicht verarbeiten. Das kann an einer laufenden Wartung oder einem Ausfall liegen. Prüfen Sie den Status des Servers, auf dem der Endpunkt gehostet wird.

  • Eine unreachable-Antwortklasse gibt an, dass der Endpunktserver überhaupt nicht erreicht werden kann. Prüfen Sie die Endpunkt-URL auf Tippfehler.

Weitere Informationen zu den häufigsten Fehlercodes der Pub/Sub API

Einschränkungen für Push-Abos in einem VPC-SC-Perimeter

Wenn der VPC Service Controls-Schutz (VPC-SC) in einem Projekt aktiviert ist, gelten Einschränkungen für das Erstellen von Push-Abos. Vorhandene Push-Abos funktionieren weiterhin. Wenn Sie jedoch ein neues Push-Abo erstellen, wird der Fehler Request is prohibited by organization's policy angezeigt. Neue Push-Abos können nur erstellt werden, wenn der Push-Endpunkt ein Cloud Run-Dienst mit der standardmäßigen run.app-URL ist. Weitere Informationen und spezifische Einschränkungen finden Sie in der Pub/Sub-Dokumentation und der VPC-SC-Dokumentation.