In diesem Dokument wird beschrieben, wie Sie den automatischen Export von Pub/Sub Lite-Nachrichten nach Pub/Sub einrichten.
Im Folgenden finden Sie einige Szenarien, in denen Sie diese Funktion verwenden können:
- Interoperabilität zwischen Arbeitslasten, die eine Mischung aus Pub/Sub Lite und Pub/Sub verwenden
- Migrieren Sie eine Pub/Sub Lite-Arbeitslast zu Pub/Sub.
- Verwenden Sie erweiterte Pub/Sub-Funktionen wie Push-Abos und Filtern aus einer vorhandenen Anwendung, die auf Pub/Sub Lite basiert.
- Mehrere Datenpipelines konsolidieren
Überblick
Zum Exportieren von Nachrichten von Pub/Sub Lite nach Pub/Sub erstellen Sie einen speziellen Abotyp, ein sogenanntes Abo exportieren. Ein Exportabo empfängt Nachrichten von einem Lite-Thema, konvertiert sie in Pub/Sub-Nachrichten und sendet die konvertierten Nachrichten an ein Pub/Sub-Zielthema.
Ein Lite-Thema kann eine Kombination aus Exportabos und Standardabos enthalten. Die beiden Abotypen sind in Bezug auf Kontingentnutzung und Reservierungsdurchsatz identisch. Ein Exportabo verbraucht die Durchsatzkapazität des Lite-Abos und wird für den Pub/Sub-Veröffentlichungsdurchsatz berechnet.
Ein Exportabo verbindet ein Lite-Thema mit genau einem Pub/Sub-Thema. Ein Lite-Thema kann jedoch mehrere Exportabos haben, die mit verschiedenen Pub/Sub-Themen verbunden sind (Fan-Out-Architektur). Sie können auch aus mehreren Lite-Themen in dasselbe Pub/Sub-Thema exportieren (Fan-in-Architektur).
Authentifizierung
Ein Exportabo greift sowohl auf Pub/Sub Lite- als auch auf Pub/Sub-Ressourcen zu. Zum Erstellen eines Exportabos benötigen Sie die folgenden Berechtigungen:
pubsublite.subscriptions.create
: Die folgenden vordefinierten Rollen enthalten diese Berechtigung:roles/pubsublite.admin
roles/pubsublite.editor
pubsub.topics.get
. Die folgenden vordefinierten Rollen enthalten diese Berechtigung:roles/pubsub.admin
roles/pubsub.editor
roles/pubsub.viewer
Dienst-Agents
Ein Exportabo veröffentlicht in Ihrem Namen ein Pub/Sub-Thema. Dazu wird ein Dienst-Agent verwendet.
Nachdem Sie das erste Exportabo in einem Projekt erstellt haben, wird automatisch ein Pub/Sub Lite-Dienst-Agent erstellt. Wenn Sie zusätzliche Exportabos im selben Projekt erstellen, verwenden diese denselben Dienst-Agent. Der Dienst-Agent hat das folgende Namensschema: service-<your_project_number>@gcp-sa-pubsublite.iam.gserviceaccount.com
.
Der Dienst-Agent wird mit Berechtigungen zur Veröffentlichung in allen Pub/Sub- und Pub/Sub Lite-Themen im selben Projekt wie das Exportabo erstellt. Wenn sich das Pub/Sub-Zielthema in einem anderen Projekt als das Exportabo befindet, müssen Sie dem Dienst-Agent zusätzliche Berechtigungen gewähren. Dazu fügen Sie die Rolle Pub/Sub-Publisher (roles/pubsub.publisher
) hinzu. Sie können Berechtigungen für ein gesamtes Projekt oder ein einzelnes Thema erteilen. Wir empfehlen, Berechtigungen nach dem Prinzip der geringsten Berechtigung auf Themenebene zu gewähren.
Weitere Informationen finden Sie unter Zugriff über die Google Cloud Console steuern.
Sie können auch den Befehl gcloud projects add-iam-policy-binding
verwenden, um IAM-Rollen hinzuzufügen:
gcloud pubsub topics add-iam-policy-binding TOPIC_NAME \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsublite.iam.gserviceaccount.com --role=roles/pubsub.publisher
Ersetzen Sie Folgendes:
- TOPIC_NAME: Der Name des Pub/Sub-Zielthemas, dem die IAM-Richtlinienbindung hinzugefügt werden soll.
- PROJECT_NUMBER: Die Projektnummer des Projekts des Pub/Sub Lite-Exportabos.
Exportabo erstellen
Sie können ein Lite-Exportabo mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API erstellen.
Das Abo für den Lite-Export muss sich im selben Projekt und am selben Standort wie das Lite-Thema befinden, mit dem es verknüpft ist. Informationen zum Erstellen des Lite-Themas finden Sie unter Lite-Themen erstellen und verwalten.
Wenn Sie ein Exportabo an ein Lite-Thema anhängen, prüfen Sie, ob alle im Lite-Thema veröffentlichten Nachrichten mit Pub/Sub kompatibel sind. Weitere Informationen finden Sie unter Nachrichtenkompatibilität.
Nachdem ein Exportabo erstellt wurde, können Sie es nicht mehr in ein Standardabo ändern und umgekehrt.
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf Lite-Abo erstellen.
Geben Sie eine Lite-Abo-ID ein.
Wählen Sie ein Lite-Thema aus, von dem Nachrichten empfangen werden sollen.
Wählen Sie Nachrichten sofort zustellen oder Nachrichten nach dem Speichern zustellen aus.
Wählen Sie als Typ Anfangsversatz aus.
Wählen Sie In Pub/Sub-Thema exportieren aus.
Wählen Sie in der Liste Zielthema ein Pub/Sub-Thema aus, das die exportierten Lite-Nachrichten empfangen soll.
Optional. Geben Sie ein Thema für unzustellbare Nachrichten an.
- Klicken Sie das Kästchen Unzustellbare Nachrichten aktivieren an.
- Wählen Sie ein Lite-Thema aus, das als Thema für unzustellbare Nachrichten verwendet werden soll, oder klicken Sie auf Lite-Thema erstellen, um ein neues Thema für unzustellbare Nachrichten zu erstellen. Das Thema für unzustellbare Nachrichten muss sich am selben Standort (Zone oder Region) und Projekt wie das Exportabo befinden.
Klicken Sie auf Erstellen.
gcloud
Verwenden Sie den Befehl gcloud pubsub lite-subscriptions create
, um ein Exportabo zu erstellen:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --export-pubsub-topic=PUBSUB_TOPIC_NAME \ --export-dead-letter-topic=DEAD_LETTER_TOPIC_ID \ --export-desired-state=DESIRED_STATE
Ersetzen Sie Folgendes:
- SUBSCRIPTION_ID: Die ID des zu erstellenden Lite-Abos.
- LOCATION: Der Standort des Lite-Abos.
- TOPIC_ID: Die ID des Lite-Themas, das an das Lite-Abo angehängt werden soll.
- PUBSUB_TOPIC_NAME: Der Name des Pub/Sub-Themas, in das exportiert werden soll. Geben Sie den vollständigen Namen an, wenn sich das Thema in einem anderen Projekt befindet:
projects/my-project-id/topics/my-topic-id
. - DEAD_LETTER_TOPIC_ID: Optional. Die ID eines Lite-Themas, das als Thema für unzustellbare Nachrichten verwendet werden soll. Das Thema für unzustellbare Nachrichten muss sich am selben Standort (Zone oder Region) und Projekt wie das Exportabo befinden.
- DESIRED_STATE: Optional. Der Startstatus des Abos.
Die folgenden Werte werden unterstützt:
active
: Das Abo exportiert Lite-Nachrichten nach Pub/Sub. (Standardeinstellung.)paused
: Der Export von Lite-Nachrichten wurde ausgesetzt.
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile eine Bestätigung angezeigt:
Created [SUBSCRIPTION_ID].
Protokoll
Um ein Lite-Exportabo zu erstellen, senden Sie eine POST
-Anfrage wie die folgende:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
- REGION: Die Region, in der das Lite-Abo gespeichert werden soll.
- PROJECT_NUMBER: Die Projektnummer des Projekts, in dem das Lite-Abo erstellt werden soll.
- LOCATION: Der Name eines Standorts, der von Pub/Sub Lite unterstützt wird.
- SUBSCRIPTION_ID: Die ID des Lite-Abos.
Geben Sie im Anfragetext die folgenden Felder an:
{ "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", "deliveryConfig": { "deliveryRequirement": "DELIVERY_REQUIREMENT", }, "exportConfig": { "desiredState": "DESIRED_STATE", "deadLetterTopic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/DEAD_LETTER_TOPIC_ID", "pubsubConfig": { "topic": "PUBSUB_TOPIC_NAME" } } }
Ersetzen Sie Folgendes:
- DELIVERY_REQUIREMENT: Die Übermittlungsanforderung, entweder
DELIVER_AFTER_STORED
oderDELIVER_IMMEDIATELY
. - DESIRED_STATE: Der Startstatus für das Abo. Die folgenden Werte werden unterstützt:
ACTIVE
: Das Abo exportiert Lite-Nachrichten nach Pub/Sub.PAUSED
: Der Export von Lite-Nachrichten wurde ausgesetzt.
- DEAD_LETTER_TOPIC_ID: Die ID eines vorhandenen Lite-Themas, das als Thema für unzustellbare Nachrichten verwendet werden soll. Das Thema muss sich am selben Standort (Zone oder Region) und Projekt wie das Exportabo selbst befinden.
- PUBSUB_TOPIC_NAME: Der Name des Pub/Sub-Themas, in das exportiert werden soll. Beispielformat:
projects/my-project-id/topics/my-topic-id
.
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Abo im JSON-Format:
{ "deliveryConfig": { "deliveryRequirement": "DELIVERY_REQUIREMENT", }, "exportConfig": { "desiredState": "DESIRED_STATE", "deadLetterTopic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/DEAD_LETTER_TOPIC_ID", "pubsubConfig": { "topic": "PUBSUB_TOPIC_NAME" }, "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
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 ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Exportabo aktualisieren
Sie können Lite-Abos mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API aktualisieren. Es kann bis zu 30 Sekunden dauern, bis die neuen Einstellungen wirksam werden.
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf die Lite-Abo-ID.
Klicken Sie auf der Seite Lite-Abonnementdetails auf Bearbeiten.
gCloud
Verwenden Sie zum Aktualisieren eines Lite-Abos den Befehl gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT \ --export-pubsub-topic=PUBSUB_TOPIC_NAME \ --export-dead-letter-topic=DEAD_LETTER_TOPIC_ID \ --export-desired-state=DESIRED_STATE
Ersetzen Sie Folgendes:
- SUBSCRIPTION_ID: die ID des Lite-Abos
- LOCATION: Der Standort des Lite-Abos.
- DELIVERY_REQUIREMENT: Optional. Die Übermittlungsanforderung, entweder
deliver-after-stored
oderdeliver-immediately
. - PUBSUB_TOPIC_NAME: Optional. Der Name des Pub/Sub-Themas, in das exportiert werden soll. Geben Sie den vollständigen Namen an, wenn sich das Thema in einem anderen Projekt befindet:
projects/my-project-id/topics/my-topic-id
. - DEAD_LETTER_TOPIC_ID: Die ID eines vorhandenen Lite-Themas, das als Thema für unzustellbare Nachrichten verwendet werden soll. Das Thema muss sich am selben Standort (Zone oder Region) und Projekt wie das Exportabo selbst befinden.
- DESIRED_STATE: Optional. Der gewünschte Status des Abos.
Die folgenden Werte werden unterstützt:
active
: Das Abo exportiert Lite-Nachrichten nach Pub/Sub. (Standardeinstellung.)paused
: Der Export von Lite-Nachrichten wurde ausgesetzt.
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile das Lite-Abo angezeigt:
Updated subscription [SUBSCRIPTION_ID]. deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT exportConfig: currentState: DESIRED_STATE deadLetterTopic: projects/PROJECT_NUMBER/locations/LOCATION/topics/DEAD_LETTER_TOPIC_ID desiredState: DESIRED_STATE pubsubConfig: topic: PUBSUB_TOPIC_NAME name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokoll
Um ein Lite-Abo zu aktualisieren, senden Sie eine PATCH
-Anfrage wie die folgende:
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID?updateMask=deliveryConfig.deliveryRequirement,exportConfig Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
- REGION: Die Region, in der das Lite-Abo erstellt wurde.
- PROJECT_NUMBER: Die Projektnummer des Projekts, in dem das Lite-Abo erstellt wurde.
- LOCATION: Der Ort, an dem das Lite-Abo erstellt wurde.
- SUBSCRIPTION_ID: Die ID des Lite-Abos.
Geben Sie im Anfragetext die folgenden Felder an:
{ "deliveryConfig": { "deliveryRequirement": "DELIVERY_REQUIREMENT", }, "exportConfig": { "desiredState": "DESIRED_STATE", "deadLetterTopic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/DEAD_LETTER_TOPIC_ID", "pubsubConfig": { "topic": "PUBSUB_TOPIC_NAME" } } }
Ersetzen Sie Folgendes:
- DELIVERY_REQUIREMENT: Die Übermittlungsanforderung, entweder
DELIVER_AFTER_STORED
oderDELIVER_IMMEDIATELY
. - DESIRED_STATE: Der gewünschte Status für das Abo. Die folgenden Werte werden unterstützt:
ACTIVE
: Das Abo exportiert Lite-Nachrichten nach Pub/Sub.PAUSED
: Der Export von Lite-Nachrichten wurde ausgesetzt.
- DEAD_LETTER_TOPIC_ID: Die ID eines vorhandenen Lite-Themas, das als Thema für unzustellbare Nachrichten verwendet werden soll. Das Thema muss sich am selben Standort (Zone oder Region) und Projekt wie das Exportabo selbst befinden.
- PUBSUB_TOPIC_NAME: Der Name des Pub/Sub-Zielthemas. Beispielformat:
projects/my-project-id/topics/my-topic-id
.
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Abo im JSON-Format:
{ "deliveryConfig": { "deliveryRequirement": "DELIVERY_REQUIREMENT", }, "exportConfig": { "desiredState": "DESIRED_STATE", "deadLetterTopic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/DEAD_LETTER_TOPIC_ID", "pubsubConfig": { "topic": "PUBSUB_TOPIC_NAME" } }, "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Exportabo pausieren oder starten
Exportabos haben eine Einstellung namens gewünschter Status, die einen von zwei Werten hat:
- Aktiv: Das Abo exportiert Lite-Nachrichten nach Pub/Sub.
- Pausiert: Der Export von Lite-Nachrichten wird ausgesetzt.
So ändern Sie den gewünschten Status in der Google Cloud Console:
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf die Lite-Abo-ID.
Klicken Sie auf der Seite Lite-Abodetails auf Pausieren oder Starten.
Sie können den gewünschten Status auch mithilfe der Google Cloud CLI oder der Pub/Sub Lite API aktualisieren. Weitere Informationen finden Sie unter Exportabo aktualisieren.
Best Practices
In diesem Abschnitt werden einige Best Practices bei der Verwendung von Exportabos beschrieben.
Reservierungen
Wir empfehlen, ein Exportabo mit einer Reservierung zu verwenden, anstatt die Durchsatzkapazität des Abos explizit festzulegen.
Nachrichtenkompatibilität
Wenn eine Pub/Sub Lite-Nachricht nicht mit Pub/Sub kompatibel ist, veröffentlicht das Exportabo die Nachricht nicht in Pub/Sub. Stattdessen wird die Nachricht im Thema für unzustellbare Nachrichten platziert, sofern eines zugewiesen wurde. Wenn kein Thema für unzustellbare Nachrichten zugewiesen wurde, werden inkompatible Nachrichten einfach verworfen.
Beachten Sie beim Veröffentlichen von Nachrichten im Lite-Thema die folgenden Kompatibilitätsprobleme:
Keys (Schlüssel): Pub/Sub Lite-Schlüssel haben den Typ
bytes
, während Pub/Sub-Sortierschlüssel vom Typstring
sind. Für eine Kompatibilität darf der Pub/Sub Lite-Schlüssel nur UTF-8-Zeichen enthalten.Attribute: Für Nachrichtenattribute gelten die folgenden Anforderungen:
- Für die Kompatibilität müssen alle Pub/Sub Lite-Nachrichtenattribute einen einzelnen Wert haben. Pub/Sub Lite unterstützt Nachrichtenattribute mit mehreren Werten, Pub/Sub unterstützt jedoch nur Attribute mit einem Wert.
- Die Nachrichtenattribute dürfen die Pub/Sub-Nachrichtenlimits nicht überschreiten, einschließlich der maximalen Attribute pro Nachricht und der maximalen Schlüssel- und Wertgröße pro Attribut.
Thema für unzustellbare Nachrichten
Um inkompatible Nachrichten aufzubewahren und zu verarbeiten, empfehlen wir die Verwendung eines Themas für unzustellbare Nachrichten. Sie können ein Thema für unzustellbare Nachrichten beim Erstellen des Exportabos zuweisen oder ein vorhandenes Exportabo so aktualisieren, dass ein Thema für unzustellbare Nachrichten verwendet wird. Wenn das Abo eine Nachricht empfängt, die nicht mit Pub/Sub kompatibel ist, wird die Nachricht im Thema für unzustellbare Nachrichten veröffentlicht.
Ein Thema für unzustellbare Nachrichten ist ein reguläres Pub/Sub Lite-Thema. Es muss sich am selben Speicherort und im selben Projekt wie das Exportabo befinden und ein anderes Thema als das Quellthema sein.
Normalerweise hat ein Thema für unzustellbare Nachrichten eine niedrige Durchsatzauslastung. Daher empfehlen wir, dem Thema für unzustellbare Nachrichten eine Reservierung zuzuweisen, anstatt dem Thema einen Durchsatz zuzuweisen.
Übermittlungsfehler
Ein Exportabo versucht, alle kompatiblen Nachrichten an das Pub/Sub-Zielthema zuzustellen. Wenn die Nachrichtenzustellung fehlschlägt, wird das Abo für den Export gesperrt. Prüfen Sie den Messwert subscription/export_status
, um die Fehlerkategorie zu finden. Die folgenden Werte weisen auf einen Fehler hin:
PERMISSION_DENIED
: Unzureichende Berechtigungen zum Exportieren von Nachrichten.NOT_FOUND
: Eine oder mehrere Ressourcen wurden nicht gefunden. Zum Beispiel ist das Zielthema nicht vorhanden.
Weitere Informationen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Exportabos.
Nachdem Sie den Fehler behoben haben, wird das Exportabo aufgrund regelmäßiger Wiederholungsversuche automatisch neu gestartet.
Preise
Ihnen werden die Pub/Sub Lite- und Pub/Sub-Ressourcen in Rechnung gestellt, die das Exportabo verbraucht. Insbesondere werden Ihnen der zugewiesene Abodurchsatz und der zugewiesene Speicher im Pub/Sub Lite-Abo in Rechnung gestellt, die für das Pub/Sub Lite-Thema konfiguriert sind. Außerdem wird Ihnen die Veröffentlichung im Pub/Sub-Zielthema in Rechnung gestellt. Siehe Pub/Sub-Preise.
Für die Nutzung der Exportfunktion fallen keine zusätzlichen Gebühren an und es gibt keinen Preisunterschied zwischen Pub/Sub Lite-Exportabos und Standardabos.
Probleme beim Exportieren von Abos beheben
In diesem Abschnitt finden Sie einige Tipps zur Fehlerbehebung beim Exportieren von Abos.
Das Exportabo ist pausiert
Wenn das Abo pausiert ist, werden keine Nachrichten exportiert.
So erkennen Sie dieses Problem:
Google Cloud Console: Sehen Sie sich die Abodetails an. Wenn das Abo pausiert ist, sind Gewünschter Status und Aktueller Status
Paused
.Messwerte: Der Messwert
subscription/export_status
istPAUSED
.
Starten Sie das Abo, um dieses Problem zu beheben.
Das Zielthema oder das Thema für unzustellbare Nachrichten wurde gelöscht
Wenn Sie das mit einem Exportabo verknüpfte Pub/Sub-Thema oder das Thema für unzustellbare Nachrichten löschen, tritt ein Fehler auf.
So erkennen Sie dieses Problem:
Google Cloud Console: Sehen Sie sich die Abodetails an. Wenn das Thema gelöscht wurde, lautet der aktuelle Status
Not found
.Messwerte: Der Messwert
subscription/export_status
. Wenn das Thema gelöscht wurde, lautet der WertNOT_FOUND
.
Prüfen Sie das Pub/Sub-Zielthema und das Thema für unzustellbare Nachrichten (falls eines konfiguriert wurde), um dieses Problem zu beheben.
Wenn das Pub/Sub-Ziel gelöscht wurde, erstellen Sie das Thema mit demselben Namen neu. Die Veröffentlichung des Exportabos wird fortgesetzt, vorausgesetzt, die Berechtigungen haben sich nicht geändert.
Wenn das Thema für unzustellbare Nachrichten gelöscht wurde, erstellen Sie ein neues Thema für unzustellbare Nachrichten und aktualisieren Sie das Exportabo, um darauf zu verweisen.
Inkompatible Meldungen
Wenn Nachrichten nicht mit Pub/Sub kompatibel sind, werden sie nicht exportiert.
So erkennen Sie dieses Problem:
- Messwerte: Der Messwert
subscription/unexportable_message_count
gibt die Anzahl der inkompatiblen Nachrichten an, die nicht exportiert werden konnten.
Verwenden Sie zur Behebung dieses Problems ein Thema für unzustellbare Nachrichten, um die inkompatiblen Nachrichten aufzubewahren. Prüfen Sie die Nachrichten, um die Ursache zu ermitteln, und transformieren Sie sie dann bei Bedarf und veröffentlichen Sie sie noch einmal. Siehe Nachrichtenkompatibilität.
Export wurde gedrosselt
So erkennen Sie dieses Problem:
- Messwerte: Der Messwert
subscription/flow_control_status
gibt für die Ablaufsteuerung den GrundNO_CLIENT_TOKENS
an. Dies gibt an, dass das Limit für ausstehende Byte oder Nachrichten pro Partition erreicht wurde. Bis zur Behebung des Problems erhöht sich der Rückstand für die zugehörigen Exportabos.
Dieser Fehler kann mehrere Ursachen haben. Die meisten möglichen Ursachen treten im Back-End auf. Überprüfen Sie jedoch Folgendes:
- Lite-Nachrichten mit demselben Schlüssel sollten mit einer Rate von weniger als 1 MiB/s pro Schlüssel veröffentlicht werden. Das Exportabo schreibt Lite-Nachrichtenschlüssel als Pub/Sub-Sortierschlüssel. Pub/Sub hat ein Limit von 1 MiB/s für jeden Reihenfolgeschlüssel. Das Überschreiten dieses Limits kann zu einer Drosselung führen.
Der Nutzer ist nicht berechtigt, diese Aktion auszuführen
Der Pub/Sub Lite-Dienst-Agent muss Berechtigungen zum Veröffentlichen im Pub/Sub-Zielthema haben.
So erkennen Sie dieses Problem:
Google Cloud Console: Sehen Sie sich die Abodetails an. Falls Berechtigungsfehler auftreten, lautet der Aktueller Status
Permission denied
.Messwerte: Der Messwert
subscription/export_status
istPERMISSON_DENIED
.
Dieser Fehler kann beispielsweise in folgenden Situationen auftreten:
- Dem Pub/Sub Lite-Dienst-Agent fehlt die erforderliche Berechtigung oder Rolle zum Veröffentlichen von Nachrichten im Pub/Sub-Zielthema in einem anderen Projekt.
- Der Dienst-Agent wurde aus der IAM-Richtlinie des übergeordneten Projekts des Exportabos entfernt.
- Der Pub/Sub Lite-Dienst-Agent wird noch eingerichtet. Wenn Sie das erste Exportabo in einem Projekt erstellen, wird automatisch ein Dienst-Agent erstellt. Der Berechtigungsfehler sollte innerhalb von 10 Minuten automatisch behoben werden.
Prüfen Sie, ob dem Dienst-Agent die richtige Berechtigung oder Rolle gewährt wurde, um das Problem zu beheben. Siehe Dienstmitarbeiter.
Nächste Schritte
Pub/Sub oder Pub/Sub Lite auswählen