Questo documento spiega come osservare l'applicazione delle quote. Il sistema di quote di Google Distributed Cloud (GDC) con air gap protegge i servizi impedendo picchi imprevisti di utilizzo che potrebbero sovraccaricarli. Per aiutarti a capire come vengono configurate e applicate le quote dei servizi, puoi utilizzare il servizio Library Agent per osservare i comportamenti delle quote, ad esempio la limitazione di frequenza.
Il servizio Library Agent espone due API:
- GetShelf: recupera i dettagli di uno scaffale specifico e non è soggetto a limitazioni di frequenza.
- ListShelves: recupera un elenco di tutti gli scaffali e ha una limitazione di frequenza di due richieste al minuto.
Questa pagina è rivolta agli sviluppatori del gruppo di operatori dell'applicazione, che sono responsabili del monitoraggio delle quote e dei pattern di utilizzo per il loro progetto. Per saperne di più, consulta Pubblico per la documentazione di GDC con air gap.
Prima di iniziare
Prima di interagire con il servizio Library Agent, assicurati di disporre delle autorizzazioni corrette e dell'endpoint di servizio:
Per ottenere le autorizzazioni necessarie per interagire con il servizio Library Agent, chiedi all'amministratore IAM del progetto di concederti il ruolo LibraryAgent User nello spazio dei nomi del progetto. Ad esempio, l'amministratore del progetto IAM può associare il ruolo
libraryagent-useral tuo account utente nello spazio dei nomi del progetto applicando una risorsaRoleBinding:kubectl apply -f - <<EOF apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: name: libraryagent-user-binding namespace: PROJECT_NAMESPACE subjects: - kind: User name: USER_EMAIL_ADDRESS apiGroup: rbac.authorization.k8s.io roleRef: kind: Role name: libraryagent-user apiGroup: rbac.authorization.k8s.io EOFSostituisci quanto segue:
PROJECT_NAMESPACE: lo spazio dei nomi del progetto, ad esempioproject-123.USER_EMAIL_ADDRESS: l'indirizzo email associato alla tua identità utente.
Chiedi a un amministratore della piattaforma che ha accesso al cluster di amministrazione dell'organizzazione e che ha il ruolo DNS Monitor (
dns-monitor-mp) di ottenere il nome DNS per il servizio Library Agent:kubectl get dnsregistration.network.private.gdc.goog -n libraryagent-system libraryagent -o jsonpath='{.status.fqdn}'Se devi modificare la registrazione DNS, l'AP deve avere anche il ruolo DNS Debugger (
dns-debugger-mp).
Osserva i limiti di quota
Per interagire con le API Library Agent e osservare la limitazione di frequenza, segui questi passaggi:
Imposta le variabili di ambiente per il nome DNS e il token di autenticazione:
export DNS_NAME=LIBRARY_AGENT_DNS_NAME export TOKEN="$($HOME/gdcloud auth print-identity-token --audiences=https://$DNS_NAME)"Sostituisci
LIBRARY_AGENT_DNS_NAMEcon il nome DNS ottenuto in precedenza.Chiama l'API
GetShelfper recuperare una sezione specifica per nome. Questo metodo non ha un limite di frequenza:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelves/Shelf1Sostituisci
PROJECT_NAMESPACEcon lo spazio dei nomi del progetto.Ricevi una risposta
HTTP 200 OK.Chiama l'API
ListShelvesper elencare tutti gli scaffali in una località indicata nel nome DNS. Questo metodo è limitato a due richieste al minuto:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelvesSostituisci
PROJECT_NAMESPACEcon lo spazio dei nomi del progetto.Se rientri nel limite di due richieste al minuto, ricevi una risposta
HTTP 200 OK.Per osservare l'applicazione della quota, chiama ripetutamente l'API
ListShelvesfino a superare il limite di frequenza:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelvesSostituisci
PROJECT_NAMESPACEcon lo spazio dei nomi del progetto.Quando superi il limite, ricevi una risposta
HTTP 429 Too Many Requests, che indica che la richiesta è stata limitata dal sistema di quote. L'output è simile al seguente:* Request completely sent off < HTTP/2 429 < x-envoy-ratelimited: true < date: Thu, 24 Apr 2025 18:37:16 GMT < server: istio-envoy < x-envoy-upstream-service-time: 46 < * Connection #0 to host libraryagent.org-1.zone1.google.gdch.test left intactL'applicazione della limitazione di frequenza non è sempre precisa; potrebbe essere necessario più di due richieste in un minuto per attivare l'errore 429.