Veröffentlichungsfehler sind in der Regel auf clientseitige Engpässe zurückzuführen, z. B. unzureichende Dienst-CPUs, eine schlechte Threadintegrität oder Netzwerküberlastung. Die Wiederholungsrichtlinie für Publisher definiert, wie oft Pub/Sub versucht, eine Nachricht zuzustellen, und wie viel Zeit zwischen den einzelnen Versuchen liegt.
In diesem Dokument finden Sie Informationen zur Verwendung von Wiederholungsanfragen mit Nachrichten, die in einem Thema veröffentlicht wurden.
Hinweise
Bevor Sie den Veröffentlichungs-Workflow konfigurieren, müssen Sie die folgenden Aufgaben ausführen:
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub Publisher (roles/pubsub.publisher
) für das Thema zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Wiederholen von Nachrichtenanfragen an ein Thema benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Sie benötigen zusätzliche Berechtigungen, um Themen und Abos zu erstellen oder zu aktualisieren.
Anfragen wiederholen
Wiederholungseinstellungen steuern, wie die Pub/Sub-Clientbibliotheken Veröffentlichungsanfragen wiederholen. Die Clientbibliotheken haben eine der folgenden Wiederholungseinstellungen:
- Zeitüberschreitung der ersten Anfrage: Die Zeitspanne, nach der eine Clientbibliothek nicht mehr auf die Fertigstellung der ersten Veröffentlichungsanfrage wartet.
- Wiederholungsverzögerung: Die Zeitspanne, die eine Clientbibliothek nach der Zeitüberschreitung einer Anfrage wartet, bevor sie die Anfrage wiederholt.
- Gesamtzeitüberschreitung: Die Zeitspanne, nach der eine Clientbibliothek keine weiteren Veröffentlichungsanfragen mehr wiederholt.
Damit Veröffentlichungsanfragen wiederholt werden können, muss die Zeitüberschreitung der ersten Anfrage kürzer sein als die Gesamtzeitüberschreitung. Wenn Sie beispielsweise exponentiellen Backoff verwenden, berechnen die Clientbibliotheken das Anfragezeitlimit und die Wiederholungsverzögerung folgendermaßen:
- Nach jeder Veröffentlichungsanfrage erhöht sich das Anfragezeitlimit um den Zeitüberschreitungsfaktor der Anfrage bis zum maximalen Anfragezeitlimit.
- Nach jedem Wiederholungsversuch erhöht sich die Wiederholungsverzögerung um den Wiederholungsverzögerungsfaktor bis zur maximalen Wiederholungsverzögerung.
Nachrichtenanfrage wiederholen
Während der Veröffentlichung können vorübergehende oder dauerhafte Fehler auftreten. Bei vorübergehenden Fehlern müssen Sie in der Regel keine besonderen Maßnahmen ergreifen, da Pub/Sub die Nachrichten automatisch noch einmal sendet.
Ein Fehler kann auch auftreten, wenn ein Veröffentlichungsvorgang erfolgreich ist, die Veröffentlichungsantwort aber nicht rechtzeitig vom Publisher-Client empfangen wird. Auch in diesem Fall wird der Veröffentlichungsvorgang wiederholt. Daher kann es zwei identische Nachrichten mit unterschiedlichen Nachrichten-IDs geben.
Bei dauerhaften Fehlern sollten Sie geeignete Maßnahmen außerhalb des Veröffentlichungsprozesses ergreifen, um Pub/Sub nicht zu überlasten.
Fehlgeschlagene Veröffentlichungen werden automatisch wiederholt, außer bei Fehlern, die keine Wiederholungen rechtfertigen. Mit diesem Beispielcode wird dargestellt, wie ein Publisher mit benutzerdefinierten Wiederholungseinstellungen erstellt wird. Beachten Sie, dass nicht alle Clientbibliotheken benutzerdefinierte Wiederholungseinstellungen unterstützen. Dazu wird auf die API-Referenzdokumentation für die Sprache Ihrer Wahl verwiesen:
C++
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C++ in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C++ API.
C#
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C# in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub C# API.
Go
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Go in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Go API.
Java
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Java in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Java API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Node.js API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Node.js API.
Python
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Python in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Python API.
Anfragen mit Sortierungsschlüsseln wiederholen
Angenommen, Sie haben einen einzelnen Publisher-Client. Sie verwenden die Pub/Sub-Clientbibliotheken, um die Nachrichten 1, 2 und 3 für denselben Sortierungsschlüssel A zu veröffentlichen. Angenommen, die veröffentlichte Antwort für Nachricht 1 wird vom Publisher-Client nicht empfangen, bevor das RPC-Zeitlimit abläuft. Nachricht 1 muss noch einmal veröffentlicht werden. Die Reihenfolge der Nachrichten, die vom Abonnentenclient empfangen werden, ist dann 1, 1, 2 und 3, wenn davon ausgegangen wird, dass Nachricht 2 erst veröffentlicht wird, nachdem Nachricht 1 erfolgreich abgeschlossen wurde. Jede veröffentlichte Nachricht hat eine eigene Nachrichten-ID. Aus Sicht des Abonnentenclients wurden vier Nachrichten veröffentlicht, wobei die ersten beiden identische Inhalte haben.
Das Wiederholen von Veröffentlichungsanfragen mit Sortierungsschlüsseln kann auch durch Batcheinstellungen erschwert werden. Die Clientbibliothek fasst Nachrichten in Batches zusammen, um sie effizienter zu veröffentlichen. Wir setzen das vorherige Beispiel fort und gehen davon aus, dass die Nachrichten 1 und 2 zusammengefasst werden. Dieser Batch wird als einzelne Anfrage an den Server gesendet. Wenn der Server nicht rechtzeitig eine Antwort zurückgibt, wiederholt der Publisher-Client diesen Batch mit zwei Nachrichten. Daher ist es möglich, dass der Abonnentenclient die Nachrichten 1, 2, 1, 2 und 3 empfängt. Wenn Sie eine Pub/Sub-Clientbibliothek zum Veröffentlichen von Nachrichten in der richtigen Reihenfolge verwenden und ein Veröffentlichungsvorgang fehlschlägt, schlägt der Dienst die Veröffentlichungsvorgänge für alle verbleibenden Nachrichten mit demselben Reihenfolgeschlüssel fehl. Ein Publisher-Client kann dann eine der folgenden Aktionen ausführen:
Alle fehlgeschlagenen Nachrichten in der richtigen Reihenfolge noch einmal veröffentlichen
Eine Teilmenge der fehlgeschlagenen Nachrichten in der richtigen Reihenfolge noch einmal veröffentlichen
Neue Nachrichten veröffentlichen
Wenn ein nicht wiederholbarer Fehler auftritt, veröffentlicht die Clientbibliothek die Nachricht nicht und veröffentlicht keine weiteren Nachrichten mit demselben Reihenfolgeschlüssel. Wenn ein Publisher beispielsweise eine Nachricht an ein nicht vorhandenes Thema sendet, tritt ein nicht wiederholbarer Fehler auf. Wenn Sie weitere Nachrichten mit demselben Reihenfolgenschlüssel veröffentlichen möchten, rufen Sie eine Methode auf, um die Veröffentlichung fortzusetzen und dann wieder zu veröffentlichen.
Im folgenden Beispiel wird gezeigt, wie Nachrichten mit demselben Reihenfolgeschlüssel wieder veröffentlicht werden.
C++
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C++ in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C++ API.
C#
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C# in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub C# API.
Go
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Go in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Go API.
Java
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Java in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Java API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Node.js API.
Python
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Python in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Python API.
Ruby
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Ruby in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Ruby API.
Nächste Schritte
Informationen zum Konfigurieren erweiterter Veröffentlichungsoptionen finden Sie in den folgenden Artikeln: