Questa pagina fornisce alcuni suggerimenti comuni per la risoluzione dei problemi relativi alle sottoscrizioni Cloud Storage.
Controllare lo stato di un abbonamento per Cloud Storage
Per controllare lo stato di una sottoscrizione, svolgi questi passaggi:
Nella Google Cloud console, vai alla pagina Sottoscrizioni Pub/Sub.
Controlla l'icona Stato del tuo abbonamento per Cloud Storage.
Se l'icona è un segno di spunta verde, la sottoscrizione è integra.
Se l'icona è un punto esclamativo rosso, la sottoscrizione è in uno stato di errore.
Fai clic sull'abbonamento per l'Cloud Storage.
Viene visualizzata la pagina dei dettagli della sottoscrizione.
Controlla il messaggio di errore in Stato della sottoscrizione.
A seconda del messaggio di errore, vai alla sezione pertinente di questa pagina per risolvere il problema.
Una volta risolto il problema, la sottoscrizione tornerà a uno stato integro.
Impossibile creare o aggiornare la sottoscrizione
Di seguito sono riportati alcuni dei problemi comuni che potresti riscontrare se hai difficoltà a creare o aggiornare un abbonamento per l'archiviazione 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 Google Cloud console, il messaggio è simile al seguente:
The Cloud Storage bucket specified cannot be found.
Per risolvere il problema, crea il bucket o aggiorna l'abbonamento per l'archiviazione Cloud Storage in modo da utilizzare un bucket esistente.
Errore dell'account di servizio
Se non hai configurato il account di servizio Pub/Sub con le autorizzazioni corrette, il flusso di lavoro di creazione o aggiornamento della sottoscrizione restituisce un errore. Nella Google Cloud console, 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 il account di servizio dispone delle autorizzazioni corrette.
Lo stato della sottoscrizione mostra un punto esclamativo rosso
Se modifichi il bucket dopo aver creato una sottoscrizione, puoi influire sul modo in cui Pub/Sub scrive i messaggi nel bucket. Se una modifica genera un problema, il campo dello stato della sottoscrizione viene impostato su uno stato di errore.
Nella pagina dei dettagli della sottoscrizione, 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. Ricrea il bucket o aggiorna la sottoscrizione in modo da utilizzare un bucket esistente.
Autorizzazione bucket negata: il account di servizio Pub/Sub non ha più l'autorizzazione per scrivere nel bucket. Controlla se il account di servizio dispone delle autorizzazioni corrette.
Mentre una sottoscrizione Pub/Sub è nello stato di errore, i messaggi non vengono scritti nel bucket e rimangono nel backlog della sottoscrizione. Tieni presente che i messaggi non vengono recapitati a un
argomento messaggi non recapitabili collegato,
se configurato. I messaggi non riconosciuti vengono conservati
per il periodo impostato in message_retention_duration (7 giorni per impostazione predefinita).
La sottoscrizione elabora i messaggi molto lentamente
Alcune impostazioni della sottoscrizione possono rallentare l'elaborazione dei messaggi.
Ad esempio, l'attivazione dell'ordinamento dei messaggi nella sottoscrizione Cloud Storage potrebbe causare la scrittura dei messaggi in Cloud Storage, ma non la finalizzazione, ritardando i messaggi successivi con la stessa chiave di ordinamento. Per prestazioni migliori, valuta la possibilità di utilizzare uno spettro più ampio di chiavi di ordinamento durante la pubblicazione dei messaggi o di disattivare l'ordinamento dei messaggi se il tuo caso d'uso non lo richiede.
L'impostazione di una dimensione massima dei file troppo bassa per l'abbonamento per Cloud Storage può influire negativamente sulle prestazioni. Una dimensione massima dei file troppo bassa potrebbe far sì che Pub/Sub crei molti oggetti Cloud Storage con un numero ridotto di messaggi in ogni oggetto. Il sovraccarico aggiuntivo della creazione e della finalizzazione degli oggetti rallenta l'elaborazione dei messaggi. Per prestazioni migliori, valuta la possibilità di aumentare l'impostazione della dimensione massima dei file per l'abbonamento per l'archiviazione Cloud Storage o di rimuovere la limitazione della dimensione dei file.
Limitazioni della quota
Un'altra possibilità è che il tuo progetto abbia raggiunto la quota di throughput push di Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber). Per verificare se stai riscontrando limitazioni della quota, esamina la metrica delle richieste push (subscription/push_request_count) per eventuali resource_exhausted errori.
Esamina le quote del tuo progetto e verifica di avere una quota residua sufficiente. Vai a IAM e amministrazione > Quote all'interno del progetto contenente la sottoscrizione Pub/Sub. Cerca la quota pubsub.googleapis.com/regionalpushsubscriber. Se stai raggiungendo il
limite di quota, puoi
richiedere un aggiustamento della quota.
La sottoscrizione crea più file del previsto
Per consentire una maggiore scalabilità, l'abbonamento per l'archiviazione Cloud Storage potrebbe essere gestito da più backend Pub/Sub. Ogni backend scrive in un file Cloud Storage separato, quindi potresti notare che Cloud Storage crea più file del previsto, soprattutto per i carichi di lavoro a basso throughput.
Si tratta di una circostanza normale. Se vuoi ridurre il numero di file creati dalla sottoscrizione, puoi aumentare le impostazioni di batch dei file nella sottoscrizione per consentire file più grandi. Puoi anche post-elaborare i file componendoli in un numero inferiore di file più grandi.
Passaggi successivi
- Se continui ad avere problemi con la sottoscrizione Cloud Storage, consulta Richiedere assistenza.