In questa pagina viene descritto come creare e personalizzare una coda in modalità push e come esaminare i contenuti di una coda.
Utilizzare un file di configurazione delle code per creare code
Per elaborare un'attività, devi aggiungerla a una coda in modalità push. App Engine fornisce una coda in modalità push predefinita, denominata default, configurata e pronta per essere utilizzata con le impostazioni predefinite. Se vuoi, puoi semplicemente aggiungere tutte le tue attività
alla coda predefinita, senza dover creare e configurare altre code.
Per aggiungere code o cambiare la configurazione predefinita, modifica il file di configurazione della coda per l'applicazione, che carichi su App Engine. Puoi creare fino a 100 code. Le code non possono essere create in modo dinamico.
Questo file di configurazione delle code definisce due code:
queue:
- name: queue-blue
target: v2.task-module
rate: 5/s
- name: queue-red
rate: 1/s
Per caricare il file:
gcloud app deploy queue.yaml
Tutte le attività aggiunte a queue-blue vengono inviate al modulo di destinazione v2.task-module.
La frequenza di aggiornamento di queue-red è cambiata da 5/s a 1/s. Le attività verranno accodate e inviate ai relativi target con una frequenza di un'attività al secondo.
Se elimini una coda, devi attendere circa 7 giorni prima di creare una nuova coda con lo stesso nome.
Esistono molti altri parametri che possono essere aggiunti al file di configurazione per personalizzare il comportamento di una coda in modalità push. Per ulteriori informazioni, consulta il riferimento al file di configurazione della coda.
Definizione della frequenza di elaborazione delle coda in modalità push
Puoi controllare la frequenza con cui le attività vengono elaborate in ciascuna coda
definendo altre istruzioni, ad esempio
rate,
bucket_size
e
max_concurrent_requests.
La coda di attività utilizza i bucket di token per controllare la frequenza di esecuzione delle attività. Ogni coda denominata contiene un token bucket che contiene i token, fino al massimo specificato da bucket_size o fino a un massimo di 5 token se non specifichi la dimensione del bucket.
Ogni volta che la tua applicazione esegue un'attività, un token viene rimosso dal bucket.
L'app continua a elaborare le attività in coda finché il bucket della coda non esaurisce i token. App Engine riempie continuamente il bucket con nuovi token in base al rate specificato per la coda.
Se la tua coda contiene attività da elaborare e il bucket della coda contiene token, App Engine elabora contemporaneamente tutte le attività necessarie. Questo può portare a un aumento dell'elaborazione, consumando risorse di sistema e competendo con le richieste agli utenti.
Se vuoi impedire l'esecuzione contemporanea di troppe attività o per evitare la contesa del datastore, utilizza max_concurrent_requests.
L'esempio seguente mostra come impostare max_concurrent_requests per limitare
le attività e anche come regolare la dimensione e la tariffa del bucket in base alle esigenze
e alle risorse disponibili della tua applicazione:
queue:
- name: queue-blue
rate: 20/s
bucket_size: 40
max_concurrent_requests: 10
Impostazione dei limiti di spazio di archiviazione per tutte le code
Puoi utilizzare il file di configurazione delle code per definire la quantità totale di spazio di archiviazione che i dati delle attività possono utilizzare in tutte le code. Per definire il limite di spazio di archiviazione totale, includi un elemento denominato total_storage_limit al livello più alto:
# Set the total storage limit for all queues to 120MB
total_storage_limit: 120M
queue:
- name: queue-blue
rate: 35/s
Il valore è un numero seguito da un'unità: B per i byte, K per i kilobyte, M
per i megabyte, G per i gigabyte, T per i terabyte. Ad esempio, 100K specifica un limite di 100 kilobyte. Se l'aggiunta di un'attività fa sì che la coda superi il limite di archiviazione, la chiamata per aggiungere l'attività non andrà a buon fine. Il limite predefinito è 500M (500 megabyte) per le app gratuite. Per le app fatturate non esiste un limite fino a quando non ne hai impostato esplicitamente uno. Puoi utilizzare questo limite per proteggere la tua app da un errore di programmazione bomba fork in cui ogni attività aggiunge più altre attività durante l'esecuzione.
Se l'app riceve errori per una quota insufficiente durante l'aggiunta di attività, può essere utile aumentare il limite di spazio di archiviazione totale. Se utilizzi questa funzionalità, ti consigliamo vivamente di impostare un limite che corrisponde allo spazio di archiviazione richiesto per diversi giorni di attività. Ciò consente di eseguire temporaneamente il backup delle code e di continuare ad accettare nuove attività mentre lavori nel backlog, pur rimanendo al sicuro da un errore di programmazione di una bomba a forcella.
Monitoraggio delle code nella console Google Cloud
Nella console Google Cloud, vai alla pagina Cloud Tasks.
Tieni presente che se visiti la pagina Coda di attività di App Engine, saranno disponibili istruzioni che ti guideranno alla pagina di Cloud Tasks. Questo aggiornamento nella console Google Cloud non cambia il funzionamento delle code di attività.
Abilitare l'API Cloud Tasks.
Nella pagina Cloud Tasks, vedrai un elenco di tutte le code nell'applicazione. Se fai clic sul nome di una coda, viene visualizzata la pagina Dettagli coda, che mostra tutte le attività nella coda selezionata.
Passaggi successivi
Scopri di più sulla creazione delle attività.