Questa pagina fornisce alcuni suggerimenti comuni per la risoluzione dei problemi per gli abbonamenti a Cloud Storage.
Controllare lo stato di un abbonamento a Cloud Storage
Per controllare lo stato di una sottoscrizione, segui questi passaggi:
Nella console Google Cloud, vai al Pub/Sub pagina di abbonamento.
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 risolvere il 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 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 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 di nuovo il bucket o aggiorna l'iscrizione per utilizzare un bucket esistente.
Autorizzazione bucket negata: l'account di servizio Pub/Sub no non dispone più dell'autorizzazione per scrivere nel bucket. Controlla 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, ma restano
il backlog degli abbonamenti. 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).
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 un rendimento migliore, valuta la possibilità di utilizzare uno spettro più ampio di chiavi di ordinamento quando pubblichi i messaggi o di disattivare l'ordinamento dei messaggi se il tuo caso d'uso 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. Il sovraccarico aggiuntivo per la creazione e il completamento 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 quota sufficiente rimanente. Passa a IAM e Amministratore > Quote all'interno del progetto contenenti
la sottoscrizione Pub/Sub. Cerca la quota
pubsub.googleapis.com/regionalpushsubscriber. Se raggiungi
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 puoi aumentare le impostazioni per i batch di file di abbonamento per consentire file più grandi. Puoi anche eseguire il post-trattamento dei file componendoli in un numero inferiore di file di dimensioni maggiori.
Passaggi successivi
- Se i problemi con Cloud Storage persistono dell'abbonamento, consulta la pagina Ricevere assistenza.