Questa pagina fornisce alcuni suggerimenti comuni per gli abbonamenti Cloud Storage.
Controllare lo stato di una sottoscrizione Cloud Storage
Per controllare lo stato di una sottoscrizione, segui questi passaggi:
Nella console Google Cloud, vai alla pagina dell'abbonamento Pub/Sub.
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.
Fai clic sull'abbonamento a Cloud Storage.
Si apre la pagina dei dettagli dell'abbonamento.
Controlla lo stato dell'abbonamento per vedere il messaggio di errore.
A seconda del messaggio di errore, vai alla sezione pertinente di questa pagina per la risoluzione del problema.
Una volta risolto il problema, l'abbonamento torna a uno stato di integrità.
Impossibile creare o aggiornare l'abbonamento
Di seguito sono riportati alcuni problemi comuni che potresti riscontrare in caso di problemi durante la creazione o l'aggiornamento di un abbonamento a 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 aggiorna la sottoscrizione Cloud Storage in modo che utilizzi 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 dispone delle autorizzazioni corrette.
Lo stato dell'abbonamento mostra un punto esclamativo rosso
Se modifichi il bucket dopo aver creato una sottoscrizione, puoi influenzare il modo in cui Pub/Sub scrive i messaggi nel bucket. Se una modifica genera un problema, il campo dello stato della sottoscrizione è impostato 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 potrebbe essere uno dei seguenti:
Bucket non trovato: il bucket è stato eliminato. Crea nuovamente il bucket o aggiorna la sottoscrizione per utilizzare un bucket esistente.
Autorizzazione bucket negata: l'account di servizio Pub/Sub non dispone più dell'autorizzazione per scrivere nel bucket. Verifica se l'account di servizio dispone delle autorizzazioni corrette.
Mentre una sottoscrizione Pub/Sub è in 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 allegato, 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, l'attivazione dell'ordinamento dei messaggi nella sottoscrizione Cloud Storage potrebbe causare la scrittura dei messaggi in Cloud Storage, ma non essere finalizzati per ritardare i messaggi successivi con la stessa chiave di ordinamento. Per ottenere prestazioni migliori, valuta la possibilità di utilizzare una gamma più ampia di chiavi di ordinamento durante la pubblicazione dei messaggi o di disabilitare l'ordinamento dei messaggi se il tuo caso d'uso non lo richiede.
Anche l'impostazione di una dimensione file massima troppo bassa per l'abbonamento a Cloud Storage può influire negativamente sulle prestazioni. Una dimensione file massima troppo bassa potrebbe causare la creazione di molti oggetti Cloud Storage con un numero ridotto di messaggi in ciascun oggetto da parte di Pub/Sub. L'overhead aggiuntivo associato alla creazione e alla 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 di rimuovere la restrizione relativa alle dimensioni dei file.
Limitazioni di quota
Un'altra possibilità è che il progetto abbia raggiunto la quota di velocità effettiva di push
di Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber).
Per verificare se sono presenti limitazioni di quota, esamina la metrica
Richieste push (subscription/push_request_count)
per verificare se sono presenti errori resource_exhausted.
Esamina le quote del progetto e verifica di avere una quota rimanente sufficiente. Vai a IAM e amministrazione > Quote all'interno del progetto contenente il tuo abbonamento Pub/Sub. Cerca la quota pubsub.googleapis.com/regionalpushsubscriber. Se stai raggiungendo il limite di quota, puoi richiedere una quota più alta.
La sottoscrizione crea più file del previsto
Per consentire una maggiore scalabilità, l'abbonamento a Cloud Storage potrebbe essere gestito da più backend Pub/Sub. Ogni backend scrive in un file Cloud Storage separato, quindi potresti osservare che Cloud Storage crea più file del previsto, soprattutto per i carichi di lavoro a bassa velocità effettiva.
Si tratta di un comportamento normale. Se vuoi ridurre il numero di file creati dalla sottoscrizione, puoi valutare di aumentare le impostazioni di batch di file nella sottoscrizione per consentire file di dimensioni maggiori. Puoi anche post-elaborare i file componendoli in un numero minore di file di dimensioni maggiori.
Passaggi successivi
- Se continui a riscontrare problemi con l'abbonamento a Cloud Storage, consulta Assistenza.