Risoluzione dei problemi relativi alle sottoscrizioni Cloud Storage

Questa pagina fornisce alcuni suggerimenti comuni per la risoluzione dei problemi per gli abbonamenti a Cloud Storage.

Controllare lo stato di una sottoscrizione Cloud Storage

Per controllare lo stato di una sottoscrizione, segui questi passaggi:

  1. Nella console Google Cloud, vai al Pub/Sub pagina di abbonamento.

    Vai agli abbonamenti

  2. Controlla l'icona dello Stato per l'abbonamento a Cloud Storage.

    • Se l'icona è un segno di spunta verde, l'abbonamento è integro.

    • Se l'icona è un punto esclamativo rosso, l'abbonamento è in stato di errore.

  3. Fai clic sull'abbonamento a Cloud Storage.

    Si apre la pagina dei dettagli dell'abbonamento.

  4. Controlla lo stato dell'abbonamento per vedere il messaggio di errore.

  5. A seconda del messaggio di errore, vai alla sezione pertinente della pagina per la risoluzione del problema.

Una volta risolto il problema, l'abbonamento torna a un stato di salute.

Impossibile creare o aggiornare l'abbonamento

Di seguito sono riportati alcuni dei problemi comuni che potresti riscontrare la creazione o l'aggiornamento di una sottoscrizione Cloud Storage.

Errore "Bucket non trovato"

Se il bucket specificato nel flusso di lavoro di creazione o aggiornamento della sottoscrizione non esiste, il flusso di lavoro restituisce un errore bucket not found. Nella console Google Cloud, il messaggio è simile al seguente:

The Cloud Storage bucket specified cannot be found.

Per risolvere il problema, crea il bucket o aggiornare l'abbonamento a Cloud Storage in modo da usare un bucket esistente.

Errore dell'account di servizio

Se non hai configurato l'account di servizio Pub/Sub con le autorizzazioni corrette, il flusso di lavoro di creazione o aggiornamento della sottoscrizione restituisce un errore. Nella console Google Cloud, il messaggio è simile al seguente:

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.

Per risolvere il problema, controlla se l'account di servizio ha le autorizzazioni corrette.

Lo stato dell'abbonamento mostra un punto esclamativo rosso

Se modifichi il bucket dopo aver creato una sottoscrizione, può influire il modo in cui Pub/Sub scrive i messaggi nel bucket. Se una modifica comporta un problema, il campo dello stato della sottoscrizione impostata su uno stato di errore.

Nella pagina dei dettagli dell'abbonamento, controlla lo stato del campo Subscription state. Il campo Subscription state fornisce un errore più specifico, che può essere uno dei seguenti:

  • Bucket non trovato: il bucket è stato eliminato. Crea nuovamente il bucket o aggiorna per utilizzare un bucket esistente.

  • Autorizzazione bucket negata: l'account di servizio Pub/Sub non esiste non dispone più dell'autorizzazione per scrivere nel bucket. Verifica se l'account di servizio ha le autorizzazioni corrette.

Mentre una sottoscrizione Pub/Sub è in stato di errore, i messaggi non vengono scritti nel bucket, ma rimangono il backlog degli abbonamenti. Tieni presente che i messaggi non vengono recapitati allegato argomento messaggi non recapitabili, se configurato. I messaggi non confermati vengono conservati per il periodo impostato in message_retention_duration (7 giorni per impostazione predefinita).

La sottoscrizione elabora i messaggi molto lentamente

Alcune impostazioni di abbonamento possono rallentare l'elaborazione dei messaggi.

Ad esempio, abilitando l'ordinamento dei messaggi in Cloud Storage potrebbe causare la scrittura dei messaggi in Cloud Storage, ma non finalizzati a ritardare i messaggi successivi con la stessa chiave di ordinamento. Per ottenere prestazioni migliori, valuta la possibilità di utilizzare una gamma più ampia di opzioni per ordinare le chiavi quando pubblichi messaggi o disattivi l'ordinamento dei messaggi se non lo richiede.

Impostazione di una dimensione file massima troppo bassa per la sottoscrizione Cloud Storage ciò può anche influire negativamente sulle prestazioni. Le dimensioni del file sono troppo basse potrebbe far sì che Pub/Sub crei molti oggetti Cloud Storage con un numero ridotto di messaggi in ciascun oggetto. L'overhead aggiuntivo la creazione e la finalizzazione degli oggetti rallenta l'elaborazione dei messaggi. Per ottenere prestazioni migliori, ti consigliamo di aumentare l'impostazione della dimensione massima del file. per l'abbonamento a Cloud Storage o rimuovendo la restrizione relativa alle dimensioni dei file.

Limitazioni di quota

Un'altra possibilità è che il progetto abbia raggiunto il push di Pub/Sub quota di velocità effettiva (pubsub.googleapis.com/regionalpushsubscriber). Per verificare se riscontri limiti di quota, esamina le richieste push metrica (subscription/push_request_count) per eventuali errori resource_exhausted.

Esamina le quote del progetto e verifica di disporre di una quota sufficiente rimanenti. Passa a IAM e Amministratore > Quote all'interno del progetto contenenti la sottoscrizione Pub/Sub. Cerca il Quota pubsub.googleapis.com/regionalpushsubscriber. Se raggiungi limite di quota, puoi richiedere una quota più alta.

La sottoscrizione crea più file del previsto

Per consentire una maggiore scalabilità, il tuo abbonamento a Cloud Storage può essere gestito da più backend Pub/Sub. Ogni backend scrive in un file Cloud Storage separato, quindi potresti osservare in Cloud Storage creando più file del previsto, in particolare per carichi di lavoro a bassa velocità effettiva.

Si tratta di un comportamento normale. Se vuoi ridurre il numero di file creati puoi aumentare le impostazioni per i batch di file di abbonamento per consentire file più grandi. Puoi anche post-elaborare i file componendoli in un di file di dimensioni maggiori.

Passaggi successivi

  • Se i problemi con Cloud Storage persistono dell'abbonamento, consulta la pagina Ricevere assistenza.