Logging e monitoraggio per i callout di Secure Web Proxy

Questa pagina mostra come configurare e utilizzare Cloud Logging e Cloud Monitoring con i callout di Service Extensions per Secure Web Proxy.

Logging

Secure Web Proxy utilizza Logging per acquisire e archiviare diversi tipi di log, inclusi quelli relativi alle estensioni. Per informazioni sul logging di Secure Web Proxy, vedi Log.

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 visualizzate nella maggior parte dei Google Cloud log, come gravità, ID progetto, numero di progetto e timestamp, come descritto nel LogEntry.
  • HttpRequestHttpRequest.

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 Nome del target di backend dell'estensione.
backend_target_type string Tipo di target di backend.
chain string Nome della catena di estensioni all'interno della risorsa di 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 raggiunto il timeout 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 cross-region.
grpc_status enum Lo stato più recente sullo stream gRPC. Per ulteriori informazioni, vedi codici di stato gRPC.
per_processing_request_info matrice Un elenco di statistiche ProcessingRequest per le estensioni ext_proc o statistiche CheckRequest per le estensioni ext_authz che si verificano sullo 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 dal momento in cui viene inviato il primo byte del ProcessingRequest messaggio all'estensione al momento in cui viene ricevuto l'ultimo byte del ProcessingResponse messaggio.
per_processing_request_info[].processing_effect enum Il risultato dell'elaborazione per 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 cross-region.

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 il contenuto è stato modificato da una richiesta di mutazione applicata correttamente.
  • IMMEDIATE_RESPONSE: indica che l'estensione ha inviato una risposta immediata per interrompere tutte le ulteriori elaborazioni.
  • MUTATION_REJECTED: indica che l'estensione ha richiesto almeno una modifica non consentita e l'ulteriore elaborazione è stata interrotta. Vengono registrati i 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, bilanciatori del carico delle applicazioni interni regionali e bilanciatori del carico delle applicazioni interni cross-region.
resource string Nome della risorsa di estensione

Monitoraggio

Per informazioni sulle metriche di Monitoring per Secure Web Proxy, vedi Metriche disponibili.

In Anteprima, puoi monitorare le seguenti metriche per le estensioni sui bilanciatori del carico delle applicazioni esterni regionali, sui bilanciatori del carico delle applicazioni interni regionali e sui bilanciatori del carico delle applicazioni interni cross-region. Queste metriche hanno il prefisso networkservices.googleapis.com. Il prefisso viene omesso dalle voci nella tabella seguente.

La tabella seguente 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 delle chiamate di estensione
DELTA, INT64, 1
Il numero di chiamate inviate all'estensione.
extension/invocation_latencies Latenze delle chiamate di estensione
DELTA, DISTRIBUTION, ms
La distribuzione calcolata dalla latenza di ogni chiamata di estensione.
extension/sent_chunks_count Conteggio dei 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 Conteggio dei 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 di estensione non riuscite con fail-open
DELTA, INT64, 1
Il numero di volte in cui una chiamata non è riuscita quando il sistema è stato configurato per il fail-open e la richiesta è stata autorizzata a procedere.
extension/mutation_rejections_count Conteggio dei rifiuti di mutazione dell'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 una serie di motivi, ad esempio quando la mutazione non è valida o supera i limiti di dimensione.
extension/sent_bytes_count Conteggio dei byte inviati dall'estensione
DELTA, INT64, By
Il numero di byte inviati all'estensione.
extension/received_bytes_count Conteggio dei byte ricevuti dall'estensione
DELTA, INT64, By
Il numero di byte ricevuti dall'estensione.