Questa pagina fornisce alcuni suggerimenti comuni per la risoluzione dei problemi relativi agli abbonamenti a Cloud Storage.
Controllare lo stato di un abbonamento a Cloud Storage
Per verificare lo stato di un abbonamento:
Nella console Google Cloud, vai alla pagina dell'abbonamento Pub/Sub.
Controlla l'icona Stato per il tuo 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 uno stato di errore.
Fai clic sull'abbonamento Cloud Storage.
Si apre la pagina dei dettagli dell'abbonamento.
Controlla Stato abbonamento per il messaggio di errore.
A seconda del messaggio di errore, vai alla sezione pertinente di questa pagina per risolvere il problema.
Una volta risolto il problema, l'abbonamento torna a essere in stato corretto.
Impossibile creare o aggiornare l'abbonamento
Di seguito sono riportati alcuni dei problemi comuni che potresti riscontrare se hai difficoltà a creare o aggiornare un abbonamento a Cloud Storage.
Errore: bucket non trovato
Se il bucket specificato nel flusso di lavoro di creazione o aggiornamento dell'abbonamento 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 tua sottoscrizione Cloud Storage per 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 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 un abbonamento, la modifica può influire sul modo in cui Pub/Sub scrive i messaggi nel bucket. Se una modifica comporta un problema, il campo dello stato dell'abbonamento viene 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 può essere uno dei seguenti:
Bucket non trovato: il bucket è stato eliminato. Crea di nuovo il bucket o aggiorna l'iscrizione per utilizzare un bucket esistente.
Autorizzazione del bucket negata: l'account di servizio Pub/Sub non ha più l'autorizzazione per scrivere nel bucket. Controlla se l'account di servizio dispone delle autorizzazioni corrette.
Quando 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 in un
argomento messaggi non recapitabili collegato,
se configurato. I messaggi non confermati vengono conservati per il periodo impostato in message_retention_duration (7 giorni per impostazione predefinita).
L'abbonamento 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 la loro convalida, per ritardare i messaggi successivi con la stessa chiave di ordinamento. Per un rendimento migliore, valuta la possibilità di utilizzare uno spettro più ampio di chiavi di ordinamento prilikom della pubblicazione dei messaggi o di disattivare l'ordinamento dei messaggi se il tuo caso d'uso non lo richiede.
Anche l'impostazione di una dimensione massima del file troppo ridotta per l'abbonamento a Cloud Storage può influire negativamente sulle prestazioni. Una dimensione massima del file troppo ridotta potrebbe causare la creazione da parte di Pub/Sub di molti oggetti Cloud Storage con solo un numero ridotto di messaggi in ogni oggetto. Il sovraccarico aggiuntivo della creazione e della finalizzazione degli oggetti rallenta l'elaborazione dei messaggi. Per ottenere prestazioni migliori, ti consigliamo di aumentare l'impostazione delle dimensioni massime dei file per il tuo abbonamento a Cloud Storage o di rimuovere la limitazione delle dimensioni dei file.
Limitazioni delle quote
Un'altra possibilità è che il progetto abbia raggiunto la quota di throughput push di Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber). Per verificare se riscontri limitazioni di quota, esamina la metrica delle richieste push (subscription/push_request_count) per eventuali errori resource_exhausted.
Esamina le quote del progetto e verifica di avere quote rimanenti sufficienti. Vai a IAM e amministrazione > Quota nel 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.
L'abbonamento crea più file del previsto
Per consentire una maggiore scalabilità, l'abbonamento Cloud Storage potrebbe essere gestito da più backend Pub/Sub. Ogni backend scrive in un file Cloud Storage separato, pertanto potresti notare che Cloud Storage crea più file del previsto, soprattutto per i carichi di lavoro con un'elevata produttività.
Si tratta di un comportamento normale. Se vuoi ridurre il numero di file creati dall'abbonamento, puoi aumentare le impostazioni di raggruppamento dei file nell'abbonamento per consentire file di dimensioni maggiori. Puoi anche eseguire il post-trattamento dei file componendoli in un numero minore di file di dimensioni maggiori.
Passaggi successivi
- Se i problemi con l'abbonamento a Cloud Storage persistono, consulta la sezione Ricevere assistenza.