Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Logging e monitoraggio per i callout di Cloud Load Balancing

Questa pagina mostra come configurare e utilizzare Cloud Logging e Cloud Monitoring con i callout di Service Extensions per Cloud Load Balancing.

Logging

Questa sezione descrive il logging per i callout del bilanciatore del carico delle applicazioni.

Abilita il logging su un servizio di backend

Puoi abilitare il logging per i callout del bilanciatore del carico delle applicazioni durante la creazione del servizio abilitando il logging sul servizio di backend che è la destinazione di una richiesta (e non sul servizio di backend associato all'estensione).

Per abilitare il logging per il servizio di backend di destinazione, utilizza il comando gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Sostituisci quanto segue:

BACKEND_SERVICE: il nome del servizio di backend
RATE: un valore compreso tra 0.0 e 1.0, dove 0.0 indica che nessuna richiesta viene registrata e 1.0 indica che il 100% delle richieste viene registrato. Il valore predefinito è 1.0. Questa impostazione è efficace solo se utilizzata con il parametro enable-logging. Se ometti enable-logging, il logging viene disattivato.
REGION: la regione del backend
LOGGING_OPTIONAL_MODE: attiva il logging per i campi facoltativi in una di queste modalità:
- INCLUDE_ALL_OPTIONAL include tutti i campi facoltativi.
- EXCLUDE_ALL_OPTIONAL (valore predefinito) esclude tutti i campi facoltativi.
- CUSTOM include un elenco personalizzato di campi facoltativi.
OPTIONAL_FIELDS: un elenco separato da virgole di campi facoltativi quando selezioni la modalità CUSTOM

Dopo aver attivato il logging sul servizio di backend, le richieste HTTP o HTTPS vengono registrate utilizzando le richieste di log di Cloud Logging.

Per visualizzare i log, nella console Google Cloud , vai alla pagina Esplora log.

Per saperne di più, consulta le pagine "Monitora e risolvi i problemi" della documentazione del bilanciatore del carico delle applicazioni, ad esempio Logging e monitoraggio del bilanciatore del carico delle applicazioni interno.

Messaggi di log per un servizio di backend

In generale, le voci di log del bilanciatore del carico delle applicazioni contengono informazioni utili per monitorare ed eseguire il debug del traffico HTTP o HTTPS. Le voci di log contengono i seguenti tipi di informazioni:

Informazioni mostrate nella maggior parte dei log Google Cloud , come gravità, ID progetto, numero di progetto e timestamp, come descritto nel log LogEntry.
Campi log HttpRequest.

I log delle richieste per i bilanciatori del carico HTTP e HTTPS contengono un oggetto service_extension_info nel payload JSON della voce di log del bilanciatore del carico con le seguenti informazioni:

Campo	Tipo	Descrizione
`backend_target_name`	string	Il nome del target di backend dell'estensione.
`backend_target_type`	string	Il tipo di target di backend.
`chain`	string	Nome della catena di estensioni all'interno della risorsa dell'estensione di servizio che corrisponde alla richiesta.
`extension`	string	Nome dell'estensione all'interno della catena di estensioni.
`failed_open`	boolean	Quando la configurazione dell'estensione ha `failOpen` impostato su `true`, il valore `true` per questa metrica indica che l'elaborazione è continuata quando l'estensione ha esaurito il tempo o non è riuscita. Si applica solo ai bilanciatori del carico delle applicazioni esterni regionali, ai bilanciatori del carico delle applicazioni interni regionali e ai bilanciatori del carico delle applicazioni interni tra regioni.
`grpc_status`	enum	Lo stato più recente dello stream gRPC. Per saperne di più, consulta Codici di stato gRPC.
`per_processing_request_info`	matrice	Un elenco di statistiche `ProcessingRequest` per le estensioni `ext_proc` o di statistiche `CheckRequest` per le estensioni `ext_authz` che si verificano nello stream gRPC.
`per_processing_request_info[].event_type`	enum	Il tipo di evento di `ProcessingRequest`. Può essere uno dei seguenti: `REQUEST_HEADERS`, `REQUEST_BODY`, `RESPONSE_HEADERS` o `RESPONSE_BODY`.
`per_processing_request_info[].latency`	duration	La durata dall'invio del primo byte del messaggio `ProcessingRequest` all'estensione alla ricezione dell'ultimo byte del messaggio `ProcessingResponse`.
`per_processing_request_info[].processing_effect`	enum	Il risultato dell'elaborazione di ogni evento in una richiesta di elaborazione. Si applica solo ai bilanciatori del carico delle applicazioni esterni regionali, ai bilanciatori del carico delle applicazioni interni regionali e ai bilanciatori del carico delle applicazioni interni tra regioni. Può essere uno dei seguenti valori: `NONE`: indica che i contenuti non sono stati modificati. `NONE_FAILED_OPEN`: indica che non sono state eseguite mutazioni perché l'estensione non è riuscita ad aprirsi. `CONTENT_MODIFIED`: indica che i contenuti sono stati modificati da una richiesta di modifica applicata correttamente. `IMMEDIATE_RESPONSE`: indica che l'estensione ha inviato una risposta immediata per interrompere qualsiasi ulteriore elaborazione. `MUTATION_REJECTED`: indica che l'estensione ha richiesto almeno una modifica non consentita e che l'ulteriore elaborazione è stata interrotta. Vengono registrati messaggi di errore appropriati. `UNSPECIFIED`: indica che l'effetto dell'elaborazione non è noto.
`per_processing_request_info[].processing_effect_details`	string	Quando `processing_effect` è `MUTATION_REJECTED`, i dettagli sul motivo per cui una mutazione è stata rifiutata. Si applica solo ai bilanciatori del carico delle applicazioni esterni regionali, ai bilanciatori del carico delle applicazioni interni regionali e ai bilanciatori del carico delle applicazioni interni tra regioni.
`resource`	string	Nome della risorsa dell'estensione

Monitoraggio

Questa sezione descrive come monitorare i callout configurati utilizzando Service Extensions per Cloud Load Balancing.

Visualizza una dashboard di Monitoring

I bilanciatori del carico delle applicazioni esportano i dati di monitoraggio in Cloud Monitoring.

Utilizza le metriche di Monitoring per i seguenti scopi:

Valutazione della configurazione, dell'utilizzo e delle prestazioni di un bilanciatore del carico
Risoluzione dei problemi
Migliorare l'utilizzo delle risorse e l'esperienza utente

Per visualizzare una dashboard predefinita, segui questi passaggi:

Nella console Google Cloud , vai alla pagina Panoramica delle dashboard.
Vai alla panoramica delle dashboard
Nella sezione Categorie, fai clic su GCP.
- Per visualizzare un elenco di dashboard per tutti i tuoi bilanciatori del carico, nell'elenco Dashboard GCP, fai clic sulla dashboard denominata Bilanciatori del carico Google Cloud. Per visualizzare la dashboard di un bilanciatore del carico specifico, individua il bilanciatore del carico nell'elenco e fai clic sul nome.
- Per visualizzare le dashboard predefinite solo per i bilanciatori del carico, seleziona la dashboard appropriata.

Oltre alle dashboard predefinite in Monitoring, puoi creare dashboard personalizzate, configurare avvisi e fare query sulle metriche tramite l'API Cloud Monitoring.

Metriche di monitoraggio per i callout

Puoi monitorare le seguenti metriche per i servizi di backend di callout.

In Anteprima, puoi monitorare le seguenti metriche per le estensioni su tutti i tipi di bilanciatori del carico delle applicazioni. Queste metriche hanno il prefisso networkservices.googleapis.com. Il prefisso è omesso dalle voci della tabella seguente.

La seguente tabella fornisce il tipo di metrica, il nome visualizzato, il tipo, l'unità e la descrizione di ogni metrica.

Tipo di metrica	Nome visualizzato Tipo, tipo, unità Descrizione
`extension/invocation_count`	Conteggio chiamate estensione `DELTA`, `INT64`, `1` Il numero di chiamate inviate all'estensione.
`extension/invocation_latencies`	Latenze di chiamata dell'estensione `DELTA`, `DISTRIBUTION`, `ms` La distribuzione calcolata dalla latenza di ogni chiamata dell'estensione. Applicabile solo alle estensioni callout; non supportato per i plug-in.
`extension/sent_chunks_count`	Numero di blocchi inviati dall'estensione `DELTA`, `INT64`, `1` Applicabile solo agli eventi `request_body` e `response_body`. Il numero di blocchi di dati inviati all'estensione.
`extension/received_chunks_count`	Numero di blocchi ricevuti dall'estensione `DELTA`, `INT64`, `1` Applicabile solo agli eventi `request_body` e `response_body`. Il numero di blocchi ricevuti dall'estensione.
`extension/failed_open_count`	Chiamate non riuscite dell'estensione con fail-open `DELTA`, `INT64`, `1` Il numero di volte in cui una chiamata non è riuscita quando il sistema era configurato per il fail-open e la richiesta è stata autorizzata a procedere.
`extension/mutation_rejections_count`	Numero di rifiuti di mutazioni di estensione `DELTA`, `INT64`, `1` Il numero di chiamate che hanno richiesto mutazioni di intestazione, corpo o trailer, ma sono state rifiutate. I rifiuti possono verificarsi per vari motivi, ad esempio quando la mutazione non è valida o supera i limiti di dimensione.
`extension/sent_bytes_count`	Conteggio byte inviati dall'estensione `DELTA`, `INT64`, `By` Il numero di byte inviati all'estensione.
`extension/received_bytes_count`	Conteggio byte ricevuti dall'estensione `DELTA`, `INT64`, `By` Il numero di byte ricevuti dall'estensione.

Puoi anche monitorare le seguenti metriche. Queste metriche hanno il prefisso loadbalancing.googleapis.com/. Il prefisso viene omesso dalle voci della tabella.

Tipo di metrica	Nome visualizzato Tipo, tipo, unità Descrizione
`https/backend_request_count`, `https/external/regional/backend_request_count`, `https/internal/backend_request_count`	Conteggio richieste backend `DELTA`, `INT64`, `1` Il numero di volte in cui un servizio di backend di callout viene chiamato dal bilanciatore del carico delle applicazioni.
`https/backend_request_bytes_count`, `https/external/regional/backend_request_bytes_count`, `https/internal/backend_request_bytes_count`	Byte delle richieste di backend `DELTA`, `INT64`, `By` Il numero di byte inviati dal bilanciatore del carico al servizio di backend del callout.
`https/backend_response_bytes_count`, `https/external/regional/backend_response_bytes_count`, `https/internal/backend_response_bytes_count`	Byte di risposta del backend `DELTA`, `INT64`, `By` Il numero di byte ricevuti dal bilanciatore del carico dal backend dell'estensione.
`https/backend_latencies`, `https/external/regional/backend_latencies`, `https/internal/backend_latencies`	Latenza di backend `DELTA`, `DISTRIBUTION`, `ms` Una distribuzione calcolata dalla somma delle latenze di ogni chiamata dell'estensione tra il bilanciatore del carico e il servizio di backend del callout. Campionamento eseguito ogni 60 secondi.

Passaggi successivi

Visualizza i messaggi di log per i callout