Questo documento spiega come utilizzare e gestire le prenotazioni Pub/Sub Lite. Questo documento spiega anche il concetto di unità di capacità e come determinare quante sono necessarie per soddisfare la velocità effettiva della tua applicazione.
Panoramica delle prenotazioni Lite
Esegui il provisioning delle prenotazioni Lite e condividi dinamicamente la capacità della velocità effettiva tra uno o più argomenti Lite in una regione. Questi argomenti possono essere argomenti Lite a livello di regione o zona. L'utilizzo delle prenotazioni Lite è un'opzione migliore rispetto all'impostazione della capacità di velocità effettiva dei singoli argomenti Lite. Con le prenotazioni Lite, puoi gestire e monitorare meno risorse. Inoltre, non è necessario scegliere la capacità di velocità effettiva dei singoli argomenti Lite.
Per utilizzare una prenotazione Lite, devi collegare un argomento Lite che si trova nella stessa regione alla prenotazione Lite specifica. Puoi collegare una singola prenotazione Lite ad argomenti Lite a livello di zona e di regione. Tutte le partizioni di un argomento Lite collegato a una prenotazione Lite utilizzano dinamicamente la capacità di velocità effettiva di cui è stato eseguito il provisioning nella prenotazione Lite. Se specifichi una prenotazione Lite per un argomento Lite, puoi anche includere limiti di frequenza per limitare la capacità di velocità effettiva di ogni partizione dell'argomento Lite.
Panoramica delle unità di capacità
Il provisioning della capacità di velocità effettiva di una prenotazione Lite viene eseguito in unità di capacità.
Un'unità di capacità corrisponde alla seguente velocità effettiva:
Tipo di argomento Lite | Velocità effettiva di pubblicazione in MiBps | Velocità effettiva di sottoscrizione in MiBps |
---|---|---|
Zonale | 1 | 2 |
Regionale | 0,25 | 0.5 |
Linee guida per assegnare un nome a una prenotazione
Il nome di una risorsa Pub/Sub Lite identifica in modo univoco una risorsa Pub/Sub Lite, ad esempio un argomento, una sottoscrizione o una prenotazione. Il nome della risorsa deve rientrare nel formato seguente:
projects/project-identifier/collection/ID
project-identifier
: deve essere l'ID o il numero del progetto, disponibile nella console Google Cloud. Ad esempio,my-cool-project
è un ID progetto.123456789123
è un numero di progetto.collection
: deve esseretopics
,subscriptions
oreservations
.ID
: deve essere conforme alle seguenti linee guida:- Non iniziare con la stringa
goog
- Inizia con una lettera
- Contiene tra 3 e 255 caratteri
- Contenere solo i seguenti caratteri: lettere
[A-Za-z]
, numeri[0-9]
, trattini-
, trattini bassi_
, punti.
, tilde~
, segni più+
e segni di percentuale%
Puoi utilizzare i caratteri speciali nell'elenco precedente nei nomi delle risorse senza codifica URL. Tuttavia, devi assicurarti che tutti gli altri caratteri speciali siano codificati o decodificati correttamente quando li utilizzi negli URL. Ad esempio,
mi-tópico
è un ID non valido. Tuttavia,mi-t%C3%B3pico
è valido. Questo formato è importante quando effettui chiamate REST.- Non iniziare con la stringa
Linee guida per l'utilizzo di una prenotazione Lite
La velocità effettiva di provisioning con le prenotazioni Lite è obbligatoria per gli argomenti Lite a livello di regione ed è facoltativa per gli argomenti Lite a livello di zona. Una prenotazione Lite è una risorsa a livello di regione.
Quando prevedi di configurare una prenotazione Lite, tieni presente quanto segue:
Il numero di unità di capacità necessarie per una prenotazione Lite deve corrispondere alla velocità effettiva massima prevista in un determinato minuto per tutti gli argomenti e le sottoscrizioni nella prenotazione Lite.
Quando la velocità effettiva combinata di tutti gli argomenti Lite in una prenotazione Lite raggiunge la sua capacità, la pubblicazione e la pubblicazione vengono limitate. I server Pub/Sub Lite interrompono l'invio di messaggi ai client e i messaggi vengono inseriti nel buffer nel client dell'editore. Puoi configurare un avviso per
reservation/throughput_capacity/utilization
per informarti quando la prenotazione rischia di essere limitata, in modo da poter aumentare le dimensioni della prenotazione.Puoi aggiornare la velocità effettiva delle prenotazioni tutte le volte che vuoi. Le modifiche diventeranno effettive in meno di un minuto. Tuttavia, se riduci la velocità effettiva di una prenotazione, continui a ricevere l'addebito dell'importo più elevato per un periodo di 24 ore. Pub/Sub Lite è intrinsecamente un sistema di pagamento per capacità, in cui gli scale up sono istantanei e gli scale down sono possibili.
Tutti gli argomenti Lite collegati a una prenotazione Lite utilizzano lo stesso pool di capacità di velocità effettiva. Di conseguenza, è possibile che un argomento Lite utilizzi improvvisamente una grande quantità di capacità di velocità effettiva, eliminando altri argomenti Lite e impedendo loro di pubblicare o ricevere messaggi. Se hai bisogno di un isolamento completo degli argomenti Lite, puoi collegarli a prenotazioni indipendenti.
Impatto delle partizioni su una prenotazione Lite
Il numero totale di partizioni in tutti gli argomenti Lite in una prenotazione Lite non deve essere maggiore del numero di unità di capacità prenotate. Ad esempio, non puoi collegare una prenotazione Lite con 10 unità di capacità a un argomento Lite o a un set di argomenti Lite il cui numero totale di partizioni è maggiore di 10.
Calcolare le unità di capacità per una prenotazione Lite
Le dimensioni di una prenotazione Lite sono definite dal numero di unità di capacità. Gli esempi riportati di seguito mostrano come stimare la capacità richiesta per singoli argomenti Lite.
Determinare la velocità effettiva di pubblicazione massima.
Stima il picco della velocità effettiva di tutti gli argomenti Lite collegati alla prenotazione Lite. Una stima approssimativa della velocità effettiva è sufficiente, dal momento che puoi sempre aggiornare la dimensione della prenotazione.
Determina la velocità effettiva di sottoscrizione massima.
La velocità effettiva di sottoscrizione massima viene calcolata in modo simile alla velocità effettiva di pubblicazione massima. Tuttavia, tieni presente che i tuoi sottoscrittori non devono necessariamente ricevere messaggi con la frequenza massima degli editori. Se i ritardi nell'elaborazione sono accettabili, puoi utilizzare Pub/Sub Lite per eseguire il buffering dei messaggi ed elaborarli a una velocità costante. Allo stesso tempo, potresti voler avere una capacità di abbonamento superiore alla capacità di pubblicazione per soddisfare i tempi di inattività occasionali degli abbonati.
Determina il numero totale di unità di capacità richieste.
La tabella nella sezione precedente specifica il numero di MiBps che un'unità di capacità può supportare per operazioni diverse. Di seguito è riportata la formula per calcolare le unità di capacità richieste per una prenotazione Lite di esempio:
- Velocità effettiva di pubblicazione massima degli argomenti Lite a livello di zona =
Pz MiBps
- Velocità effettiva di pubblicazione massima degli argomenti Lite a livello di regione =
Pr MiBps
- Velocità effettiva massima di sottoscrizione degli argomenti Lite a livello di zona =
Sz MiBps
Velocità effettiva di sottoscrizione massima degli argomenti Lite a livello di regione =
Sr MiBps
Numero di unità di capacità richieste =
(Pz / 1 MiBps) + (Pr/0.25 MiBps) + (Sz/2 MiBps) + (Sr/0.5 MiBps)
Se il numero non è intero, devi arrotondarlo.
- Velocità effettiva di pubblicazione massima degli argomenti Lite a livello di zona =
Configura la capacità di velocità effettiva senza una prenotazione Lite
Capacità di velocità effettiva di pubblicazione degli argomenti: puoi specificare da 4 a 16 MiBps di capacità di velocità effettiva e il valore deve essere un numero intero.
Capacità di velocità effettiva di sottoscrizione argomento: puoi specificare da 4 a 32 MiBps di capacità di velocità effettiva e il valore deve essere un numero intero.
Per la velocità effettiva di sottoscrizione, ti consigliamo di eseguire il provisioning della capacità di velocità effettiva in modo che corrisponda alla velocità effettiva di pubblicazione prevista e al numero di sottoscrizioni per il tuo argomento.
La capacità di publisher e sottoscrittore di cui è stato eseguito il provisioning per un singolo argomento non sono intercambiabili. Per questo motivo, consigliamo sempre di utilizzare le prenotazioni.
Esistono differenze nella fatturazione quando esegui il provisioning della capacità direttamente per gli argomenti anziché utilizzare le prenotazioni. Per maggiori dettagli, consulta la pagina dei prezzi di Pub/Sub Lite.
Crea una prenotazione Lite
Una prenotazione Lite deve trovarsi nello stesso progetto e nella stessa regione di qualsiasi argomento Lite collegato. Per un elenco delle zone e delle regioni disponibili, consulta Località di Pub/Sub Lite.
Puoi creare una prenotazione Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Prenotazioni di Lite.
Fai clic su Crea prenotazione Lite.
Seleziona una regione.
Inserisci un ID prenotazione Lite.
Esegui il provisioning della quantità di unità di capacità di velocità effettiva.
Fai clic su Crea.
gcloud
Per creare una prenotazione Lite, utilizza il comando gcloud pubsub lite-reservations create
:
gcloud pubsub lite-reservations create myRes \ --location=us-central1 \ --throughput-capacity=INTEGER_NUMBER_OF_UNITS
gcloud pubsub lite-topics create myTopic \ --throughput-reservation=myRez \ --zone=ZONE \ --location=us-central1a \ --partitions \ --storage
Go
Prima di eseguire questo esempio, segui le istruzioni per la configurazione di Go in Librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione Java in Librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client di Pub/Sub Lite.
Aggiorna una prenotazione Lite
Puoi aggiornare il numero di unità di capacità configurate per una prenotazione Lite.
Puoi aggiornare una prenotazione Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Prenotazioni di Lite.
Fai clic sull'ID prenotazione Lite.
Nella pagina dei dettagli della prenotazione Lite, fai clic su Modifica.
gcloud
Per aggiornare una prenotazione Lite, utilizza il comando gcloud pubsub lite-reservations update
:
gcloud pubsub lite-reservations update RESERVATION_ID \ --location=REGION \ --throughput-capacity=THROUGHPUT_CAPACITY
Sostituisci quanto segue:
- RESERVATION_ID: l'ID della prenotazione Lite
- REGION: la regione della prenotazione
- THROUGHPUT_CAPACITY: la capacità di velocità effettiva della prenotazione.
Go
Prima di eseguire questo esempio, segui le istruzioni per la configurazione di Go in Librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione Java in Librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client di Pub/Sub Lite.
Recuperare i dettagli della prenotazione Lite
Puoi ottenere i dettagli di una prenotazione Lite utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Prenotazioni di Lite.
Fai clic sull'ID prenotazione Lite.
gcloud
Per ottenere i dettagli di una prenotazione Lite, utilizza il comando gcloud pubsub lite-reservations describe
:
gcloud pubsub lite-reservations describe RESERVATION_ID \ --location=REGION
Sostituisci quanto segue:
- RESERVATION_ID: l'ID della prenotazione Lite
- REGION: la regione della prenotazione
Go
Prima di eseguire questo esempio, segui le istruzioni per la configurazione di Go in Librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione Java in Librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client di Pub/Sub Lite.
Elenco prenotazioni Lite
Console
Vai alla pagina Prenotazioni di Lite.
gcloud
Per visualizzare un elenco delle prenotazioni Lite in un progetto, utilizza il comando gcloud pubsub lite-reservations list
:
gcloud pubsub lite-reservations list \ --location=REGION
Sostituisci quanto segue:
- REGION: la regione della prenotazione
Go
Prima di eseguire questo esempio, segui le istruzioni per la configurazione di Go in Librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione Java in Librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client di Pub/Sub Lite.
Elimina una prenotazione Lite
Puoi eliminare le prenotazioni Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite. Per eliminare una prenotazione, non deve contenere argomenti. Puoi collegare gli argomenti esistenti a un'altra prenotazione, quindi eliminarla.
Console
Vai alla pagina Prenotazioni di Lite.
Fai clic sull'ID prenotazione Lite.
Nella pagina dei dettagli della prenotazione Lite, fai clic su Elimina.
Nella finestra di dialogo visualizzata, fai clic su Elimina per confermare che vuoi eliminare la prenotazione Lite.
gcloud
Per eliminare una prenotazione Lite, utilizza il comando gcloud pubsub lite-reservations delete
:
gcloud pubsub lite-reservations delete RESERVATION_ID \ --location=REGION
Sostituisci quanto segue:
- RESERVATION_ID: l'ID della prenotazione Lite
- REGION: la regione della prenotazione
Go
Prima di eseguire questo esempio, segui le istruzioni per la configurazione di Go in Librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione Java in Librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client di Pub/Sub Lite.
Passaggi successivi
- Scopri di più sui prezzi di Pub/Sub Lite.
- Crea un argomento Lite.