Es gibt verschiedene Gründe, warum Abonnenten Nachrichten möglicherweise nicht verarbeiten können. Beispielsweise können vorübergehende Probleme beim Abrufen von Daten auftreten, 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 Sie mit solchen Verarbeitungsfehlern umgehen können, indem Sie eine Richtlinie für Abowiederholungen verwenden oder nicht zugestellte Nachrichten an ein Thema für unzustellbare Nachrichten weiterleiten (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 zuzustellen, der Abonnent sie aber nicht bestätigen kann, versucht Pub/Sub automatisch, die Nachricht noch einmal zu senden. Dieser erneute Übermittlungsversuch wird als Richtlinie für Abowiederholungen 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 Sie Ihr Abo zum ersten Mal erstellen und konfigurieren, können Sie eine der folgenden Wiederholungsrichtlinien, sofortige erneute Übermittlung oder exponentiellen Backoff verwenden. Standardmäßig werden Abos sofort noch einmal gesendet.
Sofortige erneute Übermittlung
Standardmäßig versucht Pub/Sub, die Nachricht sofort (und möglicherweise an denselben Abonnentenclient) noch einmal zu senden. 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 exponentielle Backoff-Richtlinie konfigurieren, um unmittelbare Probleme bei der erneuten Übermittlung zu beheben.
Exponentielle Backoffs
Mit dem exponentiellen Backoff können Sie schrittweise längere Verzögerungen zwischen Wiederholungsversuchen hinzufügen. Nach dem ersten Zustellungsfehler wartet Pub/Sub auf eine minimale Backoff-Zeit, bevor ein neuer Versuch unternommen wird. Für jeden aufeinanderfolgenden Nachrichtenfehler wird der Verzögerung mehr Zeit hinzugefügt, bis zu einer maximalen Verzögerung (0 bis 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:
- Exponentielle Backoffs werden bei 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.
- Bei Verwendung des exponentiellen Backoffs sendet Pub/Sub weiterhin andere Nachrichten, 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 zur Benennung von Abos finden Sie unter Richtlinien für die Benennung 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 Wiederholung nach exponentiellem Backoff aus.
Geben Sie für Minimum Backoff und Maximum 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 zuzustellen, der Abonnent sie aber 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 Aboeigenschaft, keine Themeneigenschaft. 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 von Zustellungsversuchen: Ein numerischer Wert, der die Anzahl der Übermittlungsversuche angibt, die Pub/Sub für eine bestimmte Nachricht unternimmt. Wenn der Abonnentenclient die Nachricht nicht innerhalb der konfigurierten Anzahl von Zustellungsversuchen bestätigen kann, wird die Nachricht an ein Thema für unzustellbare Nachrichten weitergeleitet.
- Standardwert = 5
- Höchstwert = 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 das Thema für unzustellbare Nachrichten auf ein anderes Thema als das Thema fest, an das das Abo verknüpft ist.
So werden maximale Zustellversuche berechnet
Pub/Sub zählt nur Zustellungsversuche, wenn ein Thema für unzustellbare Nachrichten richtig konfiguriert ist und die richtigen IAM-Berechtigungen enthält.
Die maximale Anzahl der Zustellversuche ist ein Näherungswert, da Pub/Sub nicht zustellbare Nachrichten auf Best-Effort-Basis weiterleitet.
Die verfolgte Anzahl der Zustellungsversuche für eine Nachricht kann ebenfalls auf null zurückgesetzt werden, insbesondere bei einem Pull-Abo mit inaktiven Abonnenten. Dies kann dazu führen, dass die Nachrichten häufiger als die konfigurierte maximale Anzahl von Zustellversuchen an den Abonnentenclient zugestellt werden.
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 so aktualisieren, dass es ein Thema für unzustellbare Nachrichten hat.
So aktivieren Sie unzustellbare Nachrichten für ein Abo:
Erstellen Sie das Thema für unzustellbare Nachrichten. Dieses Thema ist unabhängig vom Quellthema.
Legen Sie das Thema für unzustellbare Nachrichten im Abo für das Quellthema fest.
Hängen Sie dem Thema für unzustellbare Nachrichten mindestens ein weiteres Abo an, damit keine Nachrichten aus dem Thema für unzustellbare Nachrichten verloren gehen. Das sekundäre Abo empfängt Nachrichten aus dem Thema für unzustellbare Nachrichten.
Weisen Sie dem Pub/Sub-Dienstkonto die Rollen „Publisher“ und „Abonnenten“ zu. Weitere Informationen finden Sie unter Weiterleitungsberechtigungen erteilen.
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 das ausgewählte Thema für unzustellbare Nachrichten kein Abo hat, werden Sie vom System aufgefordert, eines zu erstellen.
Geben Sie im Feld Maximale Zustellungsversuche eine Ganzzahl zwischen 5 und 100 ein.
Klicken Sie auf Erstellen.
Im Detailbereich wird eine Liste möglicher Aufgaben angezeigt. Wenn für eines der Elemente das Fehlersymbol
angezeigt wird, klicken Sie auf die umzusetzende Maßnahme, 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 bestehendes Abo festlegen
Sie können mit der Google Cloud Console, der Google Cloud CLI, den Clientbibliotheken oder der Pub/Sub API ein Abo aktualisieren und ein Thema für unzustellbare Nachrichten 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 Zustellungsversuche eine Ganzzahl zwischen 5 und 100 ein.
Klicken Sie auf Aktualisieren.
Im Detailbereich wird eine Liste möglicher Aufgaben angezeigt. Wenn für eines der Elemente das Fehlersymbol
angezeigt wird, klicken Sie auf die umzusetzende Maßnahme, 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 zur Verwendung 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 Publisher- und Abonnentenrollen zuweisen.
Console
Mit den folgenden Schritten gewähren Sie Pub/Sub die Berechtigung, Nachrichten zu einem Thema für unzustellbare Nachrichten zu veröffentlichen:
Öffnen Sie in der Google Cloud Console die Seite Abos.
Klicken Sie auf den Namen des Abos mit dem Thema für unzustellbare Nachrichten.
Klicken Sie auf den Tab Unzustellbare Nachrichten.
Klicken Sie auf Publisher-Rolle gewähren, um eine Publisher-Rolle zuzuweisen. Wenn die Publisher-Rolle erfolgreich zugewiesen wurde, wird ein blaues Häkchen
angezeigt.Klicke auf Abonnentenrolle gewähren, um eine Abonnentenrolle zuzuweisen. Wenn die Publisher-Rolle erfolgreich zugewiesen wurde, wird ein blaues Häkchen
angezeigt.
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"
Zustellungsversuche verfolgen
Nachdem Sie ein Thema für unzustellbare Nachrichten für ein Abo aktiviert haben, enthält jede Nachricht aus diesem Abo ein Feld, das die Anzahl der Übermittlungsversuche angibt:
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 für das Quellabo.CloudPubSubDeadLetterSourceSubscription
: Der Name des Quellabos.CloudPubSubDeadLetterSourceSubscriptionProject
: Der Name des Projekts, das das Quellabo enthält.CloudPubSubDeadLetterSourceTopicPublishTime
: Der Zeitstempel, an 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 existiert nur für Exportabos.
Weitergeleitete Nachrichten überwachen
Nach der Weiterleitung einer nicht zustellbaren Nachricht entfernt der Pub/Sub-Dienst die Nachricht aus dem Abo. Weitergeleitete Nachrichten können Sie 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 dem Rechnungskonto in Rechnung gestellt werden, das mit dem Projekt verknüpft ist, das das Abo mit dem Attribut für unzustellbare Nachrichten enthält.
Wenn Sie das Attribut für das Thema für unzustellbare Nachrichten eines Abos festlegen, aber die Richtlinie für den Speicherort von Nachrichten des Themas für unzustellbare Nachrichten die Region, die das Abo enthält, nicht zulässt, gelten auch Veröffentlichungsgebühren für ausgehende Nachrichten.
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