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, consulta 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 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

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

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.