Auf dieser Seite finden Sie einige Tipps zur Fehlerbehebung bei Cloud Storage-Abos.
Status eines Cloud Storage-Abos prüfen
So prüfen Sie den Status eines Abos:
Rufen Sie in der Google Cloud Console die Seite „Pub/Sub-Abos“ auf.
Klicken Sie auf das Symbol für den Status Ihres Cloud Storage-Abos.
Wenn das Symbol ein grünes Häkchen ist, ist das Abo in Ordnung.
Wenn das Symbol ein rotes Ausrufezeichen ist, befindet sich das Abo in einem Fehlerstatus.
Klicken Sie auf das Cloud Storage-Abo.
Die Seite mit den Abodetails wird geöffnet.
Prüfen Sie unter Abostatus, ob eine Fehlermeldung angezeigt wird.
Rufen Sie je nach Fehlermeldung den entsprechenden Abschnitt auf dieser Seite auf, um das Problem zu beheben.
Nachdem das Problem behoben wurde, kehrt das Abo in den normalen Status zurück.
Abo kann nicht erstellt oder aktualisiert werden
Im Folgenden finden Sie einige der häufigsten Probleme, die beim Erstellen oder Aktualisieren eines Cloud Storage-Abos auftreten können.
Fehler „Bucket nicht gefunden“
Wenn der Bucket, den Sie im Workflow zum Erstellen oder Aktualisieren von Abos angeben, nicht vorhanden ist, gibt der Workflow den Fehler bucket not found zurück.
In der Google Cloud Console sieht die Meldung in etwa so aus:
The Cloud Storage bucket specified cannot be found.
Um das Problem zu beheben, erstellen Sie den Bucket oder aktualisieren Sie Ihr Cloud Storage-Abo, um einen vorhandenen Bucket zu verwenden.
Fehler bei Dienstkontoverwendung
Wenn Sie das Pub/Sub-Dienstkonto nicht mit den richtigen Berechtigungen konfiguriert haben, gibt der Workflow zum Erstellen oder Aktualisieren von Abos einen Fehler zurück. In der Google Cloud Console sieht die Meldung in etwa so aus:
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
Prüfen Sie, ob das Dienstkonto die richtigen Berechtigungen hat, um das Problem zu beheben.
Der Abostatus zeigt ein rotes Ausrufezeichen an
Wenn Sie den Bucket bearbeiten, nachdem Sie ein Abo erstellt haben, kann sich das darauf auswirken, wie Pub/Sub Nachrichten in den Bucket schreibt. Wenn eine Änderung zu einem Problem führt, wird das Statusfeld des Abos auf einen Fehlerstatus gesetzt.
Prüfe auf der Seite mit den Abodetails den Status des Felds Subscription state.
Das Feld Subscription state enthält einen genaueren Fehler, der einer der folgenden sein kann:
Bucket nicht gefunden: Der Bucket wurde gelöscht. Erstellen Sie den Bucket noch einmal oder aktualisieren Sie das Abo, um einen vorhandenen Bucket zu verwenden.
Bucket-Berechtigung abgelehnt: Das Pub/Sub-Dienstkonto hat keine Berechtigung mehr zum Schreiben in den Bucket. Prüfen Sie, ob das Dienstkonto die richtigen Berechtigungen hat.
Solange sich ein Pub/Sub-Abo im Fehlerstatus befindet, werden Nachrichten nicht in den Bucket geschrieben und verbleiben im Rückstand des Abos. Hinweis: Nachrichten werden nicht an ein angehängtes Thema mit für unzustellbare Nachrichten zugestellt, sofern konfiguriert. Nicht bestätigte Nachrichten werden für den in message_retention_duration festgelegten Zeitraum aufbewahrt (standardmäßig 7 Tage).
Nachrichten werden vom Abo sehr langsam verarbeitet
Einige Aboeinstellungen können die Nachrichtenverarbeitung verlangsamen.
Wenn Sie beispielsweise die Nachrichtensortierung für Ihr Cloud Storage-Abo aktivieren, werden Nachrichten zwar in Cloud Storage geschrieben, aber nicht abgeschlossen, um nachfolgende Nachrichten mit demselben Sortierschlüssel zu verzögern. Für eine bessere Leistung sollten Sie beim Veröffentlichen von Nachrichten ein breiteres Spektrum an Sortierschlüsseln verwenden oder die Nachrichtensortierung deaktivieren, wenn sie für Ihren Anwendungsfall nicht erforderlich ist.
Eine zu niedrige maximale Dateigröße für Ihr Cloud Storage-Abo kann sich ebenfalls negativ auf die Leistung auswirken. Eine zu niedrige maximale Dateigröße kann dazu führen, dass Pub/Sub viele Cloud Storage-Objekte mit nur einer kleinen Anzahl von Nachrichten in jedem Objekt erstellt. Der zusätzliche Aufwand beim Erstellen und Fertigstellen von Objekten verlangsamt die Nachrichtenverarbeitung. Für eine bessere Leistung können Sie die maximale Dateigröße für Ihr Cloud Storage-Abo erhöhen oder die Beschränkung der Dateigröße entfernen.
Kontingenteinschränkungen
Möglicherweise hat Ihr Projekt das Pub/Sub-Push-Durchsatzkontingent (pubsub.googleapis.com/regionalpushsubscriber) erreicht. Prüfen Sie, ob Sie Kontingenteinschränkungen erreichen, indem Sie den Messwert „Pushanfragen“ (subscription/push_request_count) auf resource_exhausted-Fehler prüfen.
Prüfen Sie die Kontingente Ihres Projekts und achten Sie darauf, dass Sie noch genügend Kontingent haben. Gehen Sie im Projekt mit Ihrem Pub/Sub-Abo zu IAM und Verwaltung > Kontingente. Suchen Sie nach dem pubsub.googleapis.com/regionalpushsubscriber-Kontingent. Wenn Sie das Kontingentlimit erreichen, können Sie ein höheres Kontingent anfordern.
Durch ein Abo werden mehr Dateien erstellt als erwartet
Für eine bessere Skalierbarkeit wird Ihr Cloud Storage-Abo möglicherweise von mehreren Pub/Sub-Backends verarbeitet. Jedes Backend schreibt in eine separate Cloud Storage-Datei. Daher werden in Cloud Storage möglicherweise mehr Dateien als erwartet erstellt, insbesondere bei Arbeitslasten mit geringem Durchsatz.
Das ist ganz normal. Wenn Sie die Anzahl der vom Abo erstellten Dateien reduzieren möchten, können Sie die Einstellungen für die Dateigruppierung für Ihr Abo erhöhen, um größere Dateien zuzulassen. Sie können die Dateien auch nachbearbeiten, indem Sie sie in eine kleinere Anzahl größerer Dateien zusammenführen.
Nächste Schritte
- Wenn weiterhin Probleme mit Ihrem Cloud Storage-Abo auftreten, lesen Sie den Hilfeartikel Support anfordern.