Geração de registros e monitoramento de chamadas do Secure Web Proxy

Nesta página, mostramos como configurar e usar o Cloud Logging e o Cloud Monitoring com chamadas de extensões de serviço para o Secure Web Proxy.

Logging

O Secure Web Proxy usa o Logging para capturar e armazenar vários tipos de registros, incluindo os relacionados a extensões. Para informações sobre a geração de registros do Secure Web Proxy, consulte Registros.

Em geral, as entradas de registro do balanceador de carga de aplicativo contêm informações úteis para monitorar e depurar o tráfego HTTP ou HTTPS. As entradas de registro contêm os seguintes tipos de informação:

  • Informações mostradas na maioria dos registros do Google Cloud , como gravidade, ID do projeto, número do projeto e carimbo de data/hora, conforme descrito no registro LogEntry.
  • Campos de registro HttpRequest.

Os registros de solicitação para balanceadores de carga HTTP e HTTPS contêm um objeto service_extension_info no payload JSON da entrada de registro do balanceador de carga com as seguintes informações:

Campo Tipo Descrição
backend_target_name string Nome do destino de back-end da extensão.
backend_target_type string Tipo do destino de back-end.
chain string Nome da cadeia de extensão no recurso de extensão de serviço que corresponde à solicitação.
extension string Nome da extensão na cadeia de extensões.
failed_open booleano Quando a configuração da extensão tem failOpen definido como true, o valor true para essa métrica indica que o processamento continuou quando a extensão expirou ou falhou.

Aplica-se apenas a balanceadores de carga de aplicativo externos regionais, balanceadores de carga de aplicativo internos regionais e balanceadores de carga de aplicativo internos entre regiões.
grpc_status enum O status mais recente no stream do gRPC. Para mais informações, consulte Códigos de status do gRPC.
per_processing_request_info matriz Uma lista de estatísticas ProcessingRequest para extensões ext_proc ou estatísticas CheckRequest para extensões ext_authz que ocorrem no stream gRPC.
per_processing_request_info[].event_type enum O tipo de evento de ProcessingRequest. Pode ser um destes: REQUEST_HEADERS, REQUEST_BODY, RESPONSE_HEADERS ou RESPONSE_BODY.
per_processing_request_info[].latency duration A duração entre o envio do primeiro byte da mensagem ProcessingRequest para a extensão e o recebimento do último byte da mensagem ProcessingResponse.
per_processing_request_info[].processing_effect enum O resultado do processamento de cada evento em uma solicitação de processamento.

Aplica-se apenas a balanceadores de carga de aplicativo externos regionais, balanceadores de carga de aplicativo internos regionais e balanceadores de carga de aplicativo internos entre regiões.

Pode ser um dos seguintes valores:

  • NONE: indica que o conteúdo não foi alterado.
  • NONE_FAILED_OPEN: indica que nenhuma mutação foi realizada porque a extensão falhou ao abrir.
  • CONTENT_MODIFIED: indica que o conteúdo foi alterado por uma solicitação de mutação aplicada com sucesso.
  • IMMEDIATE_RESPONSE: indica que uma resposta imediata foi enviada pela extensão para interromper todo o processamento.
  • MUTATION_REJECTED: indica que a extensão solicitou pelo menos uma mudança não permitida e o processamento foi interrompido. As mensagens de erro adequadas são registradas.
  • UNSPECIFIED: indica que o efeito do processamento não é conhecido.
per_processing_request_info[].processing_effect_details string Quando processing_effect é MUTATION_REJECTED, os detalhes sobre por que uma mutação foi rejeitada.

Aplica-se apenas a balanceadores de carga de aplicativo externos regionais, balanceadores de carga de aplicativo internos regionais e balanceadores de carga de aplicativo internos entre regiões.
resource string Nome do recurso de extensão

Monitoramento

Para informações sobre as métricas do Monitoring para o Secure Web Proxy, consulte Métricas disponíveis.

Em Pré-lançamento, é possível monitorar as seguintes métricas para extensões em todos os tipos de balanceadores de carga de aplicativo. Essas métricas têm o prefixo networkservices.googleapis.com/extension. O prefixo é omitido das entradas na tabela a seguir.

A tabela a seguir mostra o tipo de métrica, o nome de exibição, o tipo, a unidade e a descrição de cada métrica:

Tipo de métrica Nome de exibição
Classe, Tipo, Unidade
Descrição
invocation_count Contagem de invocações de extensão
DELTA, INT64, 1
O número de invocações enviadas à extensão.
invocation_latencies Latências de invocação de extensão
DELTA, DISTRIBUTION, ms
A distribuição calculada com base na latência de cada invocação de extensão. Aplicável apenas a extensões de frase de destaque. Não há suporte para plug-ins.
sent_chunks_count Contagem de blocos enviados pela extensão
DELTA, INT64, 1
Aplicável apenas aos eventos request_body e response_body. O número de blocos de dados enviados para a extensão.
received_chunks_count Contagem de blocos recebidos pela extensão
DELTA, INT64, 1
Aplicável apenas aos eventos request_body e response_body. O número de blocos recebidos da extensão.
failed_open_count Invocações com falha da extensão com fail-open
DELTA, INT64, 1
O número de vezes que uma invocação falhou quando o sistema foi configurado para fail-open e a solicitação foi autorizada a continuar.
mutation_rejections_count Contagem de rejeições de mutação de extensão
DELTA, INT64, 1
O número de invocações que solicitaram mutações de cabeçalho da solicitação, corpo ou trailer, mas foram rejeitadas. As rejeições podem ocorrer por vários motivos, como quando a mutação é inválida ou excede os limites de tamanho.
sent_bytes_count Contagem de bytes enviados pela extensão
DELTA, INT64, By
O número de bytes enviados para a extensão.
received_bytes_count Contagem de bytes recebidos da extensão
DELTA, INT64, By
O número de bytes recebidos da extensão.