Es gibt verschiedene Gründe, warum Abonnenten Nachrichten nicht verarbeiten können. Beispielsweise kann es vorübergehende Probleme beim Abrufen von Daten geben, die zur Verarbeitung einer Nachricht erforderlich sind. Es kann auch sein, dass eine Nachricht in einem Format vorliegt, das der Abonnent nicht erwartet.
Auf dieser Seite wird erläutert, wie mit solchen Verarbeitungsfehlern umgegangen werden kann. Dazu wird eine Richtlinie für Abowiederholungen verwendet oder nicht zugestellte Nachrichten an ein Thema für unzustellbare Nachrichten weitergeleitet (auch als Warteschlange für unzustellbare Nachrichten bezeichnet).
Beachten Sie, dass diese Features von Dataflow nicht unterstützt werden. Weitere Informationen finden Sie im Abschnitt Nicht unterstützte Pub/Sub-Features der Dataflow-Dokumentation.
Wiederholungsrichtlinie für Abos
Wenn Pub/Sub versucht, eine Nachricht zu senden, der Abonnent sie jedoch nicht bestätigen kann, versucht Pub/Sub automatisch, die Nachricht noch einmal zu senden. Dieser Versuch zur erneuten Übermittlung wird als Richtlinie für Wiederholungsversuche von Abos bezeichnet. Dies ist keine Funktion, die Sie aktivieren oder deaktivieren können. Sie können jedoch auswählen, welche Art von Wiederholungsrichtlinie Sie verwenden möchten.
Wenn du dein Abo zum ersten Mal erstellst und konfigurierst, kannst du eine der folgenden Wiederholungsrichtlinien auswählen: die sofortige erneute Zustellung oder den exponentiellen Backoff. Standardmäßig erfolgt bei Abos eine sofortige erneute Übermittlung.
Sofortige erneute Übermittlung
Standardmäßig versucht Pub/Sub, die Nachricht sofort noch einmal zu senden (und möglicherweise an denselben Abonnentenclient). Wenn sich die Bedingungen, die die Nachrichtenbestätigung verhindert haben, jedoch nicht geändert haben, kann eine sofortige erneute Zustellung zu Problemen führen. In diesem Fall ist es möglich, dass Pub/Sub mehrere Nachrichten noch einmal sendet, die nicht bestätigt werden können.
In Pub/Sub können Sie eine Richtlinie für exponentiellen Backoff konfigurieren, um sofortige Probleme beim erneuten Senden zu beheben.
Exponentielle Backoffs
Mit dem exponentiellen Backoff können Sie schrittweise längere Verzögerungen zwischen Wiederholungsversuchen hinzufügen. Nach dem ersten Übermittlungsfehler wartet Pub/Sub auf eine minimale Backoff-Zeit, bevor es noch einmal versucht. Bei jedem darauffolgenden Nachrichtenfehler wird der Verzögerung mehr Zeit hinzugefügt, bis zu einer maximalen Verzögerung (0 und 600 Sekunden).
Die maximalen und minimalen Verzögerungsintervalle sind nicht festgelegt und sollten basierend auf lokalen Faktoren für Ihre Anwendung konfiguriert werden.
Beachten Sie die folgenden Hinweise zum exponentiellen Backoff:
- Exponentieller Backoff wird für die folgenden Aktionen ausgelöst:
- Wenn eine negative Bestätigung empfangen wird.
- Wenn die Bestätigungsfrist einer Nachricht abläuft.
- Der exponentielle Backoff wird nur pro Nachricht und nicht auf alle Nachrichten in einem Abo (global) angewendet.
- Während der Verwendung des exponentiellen Backoffs stellt Pub/Sub weiterhin andere Nachrichten bereit, auch wenn vorherige Nachrichten negative Bestätigungen erhalten haben (es sei denn, Sie verwenden die geordnete Nachrichtenzustellung).
Exponentiellen Backoff konfigurieren
Console
Beim Erstellen eines neuen Abos können Sie mit den folgenden Schritten eine Wiederholungsrichtlinie mit exponentiellem Backoff konfigurieren:
Rufen Sie in der Google Cloud Console die Seite Pub/Sub-Abos auf.
Klicken Sie auf Abo erstellen.
Geben Sie im Feld Abo-ID einen Namen ein.
Weitere Informationen zum Benennen eines Abos finden Sie in den Richtlinien zum Benennen von Themen oder Abos.
Wählen Sie im Drop-down-Menü ein Thema aus oder erstellen Sie ein Thema.
Das Abo erhält Nachrichten aus dem Thema.
Wählen Sie einen Zustellungstyp aus.
Wählen Sie unter Wiederholungsrichtlinie die Option Nach exponentiellem Backoff wiederholen aus.
Geben Sie für Minimaler Backoff und Maximaler Backoff einen Wert zwischen 0 und 600 Sekunden ein.
Die Standardwerte betragen für den minimalen Backoff 10 Sekunden und für den maximalen Backoff 600 Sekunden.
Klicken Sie auf Erstellen.
gcloud
Führen Sie den Befehl gcloud pubsub create
mit den unten aufgeführten Flags aus, um ein neues Abo mit einer Wiederholungsrichtlinie mit exponentiellem Backoff zu erstellen:
gcloud pubsub subscriptions create SUBSCRIPTION_ID \ --topic=TOPIC_ID \ --min-retry-delay=MIN_RETRY_DELAY \ --max-retry-delay=MAX_RETRY_DELAY
Thema für unzustellbare Nachrichten
Wenn der Pub/Sub-Dienst versucht, eine Nachricht zu senden, der Abonnent sie jedoch nicht bestätigen kann, kann Pub/Sub die nicht zustellbare Nachricht an ein Thema für unzustellbare Nachrichten weiterleiten.
So funktionieren Themen für unzustellbare Nachrichten mit Pub/Sub
Ein Thema für unzustellbare Nachrichten ist eine Abo-Property, keine Themen-Property. Das bedeutet, dass Sie ein Thema für unzustellbare Nachrichten festlegen, wenn Sie ein Abo erstellen, und nicht, wenn Sie ein Thema erstellen.
Wenn Sie ein Thema für unzustellbare Nachrichten erstellen, können Sie die folgenden Aboattribute festlegen:
Maximale Anzahl der Zustellversuche: Ein numerischer Wert, der die Anzahl der Zustellversuche angibt, die Pub/Sub für eine bestimmte Nachricht unternimmt. Wenn der Abonnentenclient die Nachricht nicht innerhalb der konfigurierten Anzahl von Zustellversuche bestätigen kann, wird die Nachricht an ein Thema für unzustellbare Nachrichten weitergeleitet.
- Standardwert = 5
- Maximalwert = 100
- Mindestwert = 5
Projekt mit dem Thema für unzustellbare Nachrichten: Wenn sich das Thema für unzustellbare Nachrichten in einem anderen Projekt als das Abo befindet, müssen Sie das Projekt mit dem Thema für unzustellbare Nachrichten angeben. Legen Sie für das Thema für unzustellbare Nachrichten ein anderes Thema als das Thema fest, an das das Abo angehängt ist.
Wie werden die maximalen Zustellversuche berechnet?
Pub/Sub zählt Zustellungsversuche nur, wenn ein Thema für unzustellbare Nachrichten richtig konfiguriert ist und die richtigen IAM-Berechtigungen enthält.
Die maximale Anzahl der Zustellversuche ist eine ungefähre Angabe, da Pub/Sub nicht zustellbare Nachrichten auf Best-Effort-Basis weiterleitet.
Die verfolgte Anzahl der Zustellversuche für eine Nachricht kann ebenfalls auf null zurückgesetzt werden, insbesondere bei einem Pull-Abo mit inaktiven Abonnenten. Daher werden die Nachrichten möglicherweise häufiger als die konfigurierte maximale Anzahl von Zustellversuchen an den Abonnentenclient zugestellt.
Thema für unzustellbare Nachrichten konfigurieren
Zum Konfigurieren eines Themas für unzustellbare Nachrichten muss das Quellthema zuerst ein Abo haben. Sie können beim Erstellen des Abos ein Thema für unzustellbare Nachrichten angeben oder ein vorhandenes Abo auf ein Thema für unzustellbare Nachrichten aktualisieren.
Im Folgenden wird der Workflow zum Aktivieren unzustellbarer Nachrichten für ein Abo beschrieben.
Erstellen Sie das Thema für unzustellbare Nachrichten. Dieses Thema ist vom Quellthema getrennt.
Legen Sie das Thema für unzustellbare Nachrichten im Abo für das Quellthema fest.
Um zu vermeiden, dass Nachrichten aus dem Thema für unzustellbare Nachrichten verloren gehen, hängen Sie mindestens ein weiteres Abo an dieses Thema an. Das sekundäre Abo empfängt Nachrichten vom Thema für unzustellbare Nachrichten.
Gewähren Sie dem Pub/Sub-Dienstkonto die Publisher- und Abonnentenrollen. Weitere Informationen finden Sie unter Weiterleitungsberechtigungen gewähren.
Thema für unzustellbare Nachrichten für ein neues Abo festlegen
Sie können mit der Google Cloud Console, der Google Cloud CLI, den Clientbibliotheken oder der Pub/Sub API ein Abo erstellen und ein Thema für unzustellbare Nachrichten festlegen.
Console
Führen Sie die folgenden Schritte aus, um ein Abo zu erstellen und ein Thema für unzustellbare Nachrichten festzulegen:
Öffnen Sie in der Google Cloud Console die Seite Abos.
Klicken Sie auf Abo erstellen.
Geben Sie die Abo-ID ein.
Wählen Sie im Drop-down-Menü ein Thema aus oder erstellen Sie ein Thema.
Das Abo erhält Nachrichten aus dem Thema.
Wählen Sie im Abschnitt Unzustellbare Nachrichten die Option Unzustellbare Nachrichten aktivieren aus.
Wählen Sie im Drop-down-Menü ein Thema für unzustellbare Nachrichten aus.
Wenn für das ausgewählte Thema für unzustellbare Nachrichten kein Abo vorhanden ist, werden Sie vom System aufgefordert, eines zu erstellen.
Geben Sie im Feld Maximale Anzahl von Zustellversuche eine Ganzzahl zwischen 5 und 100 ein.
Klicken Sie auf Erstellen.
Der Detailbereich enthält eine Liste möglicher Aufgaben. Wenn für eines der Elemente ein Fehlersymbol
angezeigt wird, klicken Sie auf die Aufgabe, um das Problem zu beheben.
gcloud
Verwenden Sie den Befehl gcloud pubsub subscriptions create
, um ein Abo zu erstellen und ein Thema für unzustellbare Nachrichten festzulegen:
gcloud pubsub subscriptions create subscription-id \ --topic=topic-id \ --dead-letter-topic=dead-letter-topic-name \ [--max-delivery-attempts=max-delivery-attempts] \ [--dead-letter-topic-project=dead-letter-topic-project]
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 zur Pub/Sub C# API.
Einfach loslegen (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 zur 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 zur 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 zur 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 zur Pub/Sub Node.js API.
PHP
Folgen Sie der Einrichtungsanleitung für PHP unter Schnellstart: Clientbibliotheken verwenden, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub PHP 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 zur 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 zur Pub/Sub Ruby API.
Ruby
Folgen Sie der Einrichtungsanleitung für Ruby in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Ruby API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Thema für unzustellbare Nachrichten für ein vorhandenes Abo festlegen
Sie können ein Abo aktualisieren und ein Thema für unzustellbare Nachrichten mithilfe der Google Cloud Console, der Google Cloud CLI, der Clientbibliotheken oder der Pub/Sub API festlegen.
Console
Führen Sie die folgenden Schritte aus, um ein Abo zu aktualisieren und ein Thema für unzustellbare Nachrichten festzulegen.
Öffnen Sie in der Google Cloud Console die Seite Abos.
Klicken Sie neben dem zu aktualisierenden Abo auf Weitere Aktionenmore_vert.
Wählen Sie im Kontextmenü Bearbeiten aus.
Wählen Sie im Abschnitt Unzustellbare Nachrichten die Option Unzustellbare Nachrichten aktivieren aus.
Wählen Sie im Drop-down-Menü ein Thema aus oder erstellen Sie ein Thema.
Wenn für das ausgewählte Thema kein Abo vorhanden ist, werden Sie vom System aufgefordert, eines zu erstellen.
Geben Sie im Feld Maximale Anzahl von Zustellversuche eine Ganzzahl zwischen 5 und 100 ein.
Klicken Sie auf Aktualisieren.
Der Detailbereich enthält eine Liste möglicher Aufgaben. Wenn für eines der Elemente ein Fehlersymbol
angezeigt wird, klicken Sie auf die Aufgabe, um das Problem zu beheben.
gcloud
Verwenden Sie den Befehl gcloud pubsub subscriptions update
, um ein Abo zu aktualisieren und ein Thema für unzustellbare Nachrichten festzulegen:
gcloud pubsub subscriptions update subscription-id \ --dead-letter-topic=dead-letter-topic-name \ [--max-delivery-attempts=max-delivery-attempts] \ [--dead-letter-topic-project=dead-letter-topic-project]
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 zur Pub/Sub C# API.
Einfach loslegen (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 zur 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 zur 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 zur Pub/Sub Node.js API.
PHP
Folgen Sie der Einrichtungsanleitung für PHP unter Schnellstart: Clientbibliotheken verwenden, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub PHP 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 zur 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 zur Pub/Sub Ruby API.
Ruby
Folgen Sie der Einrichtungsanleitung für Ruby in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Ruby API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
IAM-Rollen zum Verwenden von Themen für unzustellbare Nachrichten gewähren
Damit unzustellbare Nachrichten an ein Thema für unzustellbare Nachrichten weitergeleitet werden können, muss Pub/Sub die Berechtigung haben, folgendes zu tun:
- Veröffentlichen Sie Nachrichten zum Thema:
- Bestätigen Sie die Nachrichten, wodurch sie aus dem Abo entfernt werden.
Pub/Sub erstellt und verwaltet für jedes Projekt ein Dienstkonto: service-project-number@gcp-sa-pubsub.iam.gserviceaccount.com
.
Sie können Weiterleitungsberechtigungen gewähren, indem Sie diesem Dienstkonto die Rollen „Publisher“ und „Abonnenten“ zuweisen.
Console
Führen Sie die folgenden Schritte aus, um Pub/Sub die Berechtigung zum Veröffentlichen von Nachrichten zu einem Thema für unzustellbare Nachrichten zu erteilen:
Öffnen Sie in der Google Cloud Console die Seite Abos.
Klicken Sie auf den Namen des Abos, das das Thema für unzustellbare Nachrichten enthält.
Klicken Sie auf den Tab Unzustellbare Nachrichten.
Klicken Sie auf Publisher-Rolle gewähren, um eine Publisher-Rolle zuzuweisen. Wenn die Rolle „Publisher“ zugewiesen wurde, ist ein blaues Häkchen
zu sehen.Klicke auf Abonnentenrolle gewähren, um eine Abonnentenrolle zuzuweisen. Wenn die Rolle „Publisher“ zugewiesen wurde, ist ein blaues Häkchen
zu sehen.
gcloud
Führen Sie den folgenden Befehl aus, um Pub/Sub die Berechtigung zum Veröffentlichen von Nachrichten an das Thema für unzustellbare Nachrichten zu gewähren:
PUBSUB_SERVICE_ACCOUNT="service-project-number@gcp-sa-pubsub.iam.gserviceaccount.com" gcloud pubsub topics add-iam-policy-binding dead-letter-topic-name \ --member="serviceAccount:$PUBSUB_SERVICE_ACCOUNT"\ --role="roles/pubsub.publisher"
Führen Sie den folgenden Befehl aus, um Pub/Sub die Berechtigung zum Bestätigen der weitergeleiteten unzustellbaren Nachrichten zu erteilen:
PUBSUB_SERVICE_ACCOUNT="service-project-number@gcp-sa-pubsub.iam.gserviceaccount.com" gcloud pubsub subscriptions add-iam-policy-binding subscription-id \ --member="serviceAccount:$PUBSUB_SERVICE_ACCOUNT"\ --role="roles/pubsub.subscriber"
Zustellversuche verfolgen
Nachdem Sie ein Thema für unzustellbare Nachrichten für ein Abo aktiviert haben, enthält jede Nachricht dieses Abos ein Feld, in dem die Anzahl der Zustellungsversuche angegeben ist:
Nachrichten, die von einem Pull-Abo empfangen werden, enthalten das Feld
delivery_attempt
.Nachrichten, die von einem Push-Abo empfangen werden, enthalten das Feld
deliveryAttempt
.
Die folgenden Beispiele zeigen, wie Sie die Anzahl der Übermittlungsversuche abrufen können:
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#
Folgen Sie der Einrichtungsanleitung für C# in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C# API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Folgen Sie der Einrichtungsanleitung für Go in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Folgen Sie der Einrichtungsanleitung für Java in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Folgen Sie der Einrichtungsanleitung für Node.js in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Folgen Sie der Einrichtungsanleitung für PHP in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub PHP API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Folgen Sie der Einrichtungsanleitung für Python in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Folgen Sie der Einrichtungsanleitung für Ruby in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Ruby API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Wenn Pub/Sub eine nicht zustellbare Nachricht an ein Thema für unzustellbare Nachrichten weiterleitet, werden der Nachricht die folgenden Attribute hinzugefügt:
CloudPubSubDeadLetterSourceDeliveryCount
: Die Anzahl der Übermittlungsversuche an das Quellabo.CloudPubSubDeadLetterSourceSubscription
: Der Name des Quellabos.CloudPubSubDeadLetterSourceSubscriptionProject
: Der Name des Projekts, das das Quellabo enthält.CloudPubSubDeadLetterSourceTopicPublishTime
: Der Zeitstempel, zu dem die Nachricht ursprünglich veröffentlicht wurde.CloudPubSubDeadLetterSourceDeliveryErrorMessage
: Der Grund, warum die Nachricht nicht an das ursprüngliche Ziel zugestellt werden konnte. Das Attribut ist nur für Exportabos vorhanden.
Weitergeleitete Nachrichten überwachen
Nach der Weiterleitung einer nicht zustellbaren Nachricht entfernt der Pub/Sub-Dienst die Nachricht aus dem Abo. Sie können weitergeleitete Nachrichten mit Cloud Monitoring überwachen.
Wenn Sie ein Abo an das Thema für unzustellbare Nachrichten anhängen, verwenden die Nachrichten die Ablaufrichtlinie des angehängten Abos anstelle der Ablaufzeit des Abos mit dem Attribut für unzustellbare Nachrichten.
Der subscription/dead_letter_message_count
-Messwert zeichnet die Anzahl der unzustellbaren Nachrichten auf, die Pub/Sub von einem Abo weiterleitet.
Weitere Informationen finden Sie unter Weitergeleitete unzustellbare Nachrichten beobachten.
Thema für unzustellbare Nachrichten entfernen
Entfernen Sie das Thema für unzustellbare Nachrichten aus dem Abo, um die Weiterleitung von unzustellbaren Nachrichten zu beenden.
Sie können ein Thema für unzustellbare Nachrichten mithilfe der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub API aus einem Abo entfernen.
Console
Führen Sie die folgenden Schritte aus, um ein Thema für unzustellbare Nachrichten aus einem Abo zu entfernen:
Öffnen Sie in der Google Cloud Console die Seite Abos.
Klicken Sie in der Liste der Abos neben dem zu aktualisierenden Abo auf more_vert.
Wählen Sie im Kontextmenü Bearbeiten aus.
Deaktivieren Sie im Abschnitt Unzustellbare Nachrichten die Option Unzustellbare Nachrichten aktivieren aus.
Klicken Sie auf Aktualisieren.
gcloud
Verwenden Sie den Befehl gcloud pubsub subscriptions update
und das Flag --clear-dead-letter-policy
, um ein Thema für unzustellbare Nachrichten aus einem Abo zu entfernen:
gcloud pubsub subscriptions update subscription-id \ --clear-dead-letter-policy
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 zur Pub/Sub C# API.
Einfach loslegen (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 zur 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 zur 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 zur Pub/Sub Node.js API.
PHP
Folgen Sie der Einrichtungsanleitung für PHP unter Schnellstart: Clientbibliotheken verwenden, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub PHP 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 zur 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 zur Pub/Sub Ruby API.
Ruby
Folgen Sie der Einrichtungsanleitung für Ruby in der Pub/Sub-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Ruby API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Pub/Sub zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Preise
Wenn der Pub/Sub-Dienst unzustellbare Nachrichten weiterleitet, fallen die folgenden Gebühren an:
- Veröffentlichungsgebühren werden dem Rechnungskonto in Rechnung gestellt, das mit dem Projekt verknüpft ist, das das Thema für unzustellbare Nachrichten enthält.
- Abogebühren für ausgehende Nachrichten, die über das Rechnungskonto abgerechnet werden, das mit dem Projekt verknüpft ist, das das Abo mit der Property für unzustellbare Nachrichten enthält.
Wenn Sie die Eigenschaft für das Thema für unzustellbare Nachrichten eines Abos festlegen, die Richtlinie für den Speicherort von Nachrichten des Themas für unzustellbare Nachrichten aber die Region, die das Abo enthält, nicht zulässt, fallen auch Veröffentlichungsgebühren für ausgehende Nachrichten an.
Die Veröffentlichungsgebühren für ausgehende Nachrichten werden dem Projekt in Rechnung gestellt, das das Thema für unzustellbare Nachrichten enthält. Weitere Informationen finden Sie unter Preise.
Nächste Schritte
- Weitergeleitete unzustellbare Nachrichten abrufen
- Pub/Sub-Anwendungen überwachen
- Konzepte der Nachrichtenübermittlung