Geração de registros e monitoramento do balanceamento de carga HTTP(S) interno

Neste documento, apresentamos as informações necessárias para entender as métricas de geração de registros e monitoramento do balanceamento de carga HTTP(S) interno.

Logging

É possível ativar a geração de registros por serviço de back-end. Um único mapa de URL do balanceador de carga HTTP(S) interno pode referir-se a mais de um serviço de back-end. Por isso, talvez seja necessário ativar a geração de registros para mais de um serviço de back-end, dependendo da configuração.

Como ativar a geração de registros em um serviço de back-end

Console

Acesse a página "Balanceamento de carga" no Console do Google Cloud.
Acessar a página "Balanceamento de carga"
Clique no nome do balanceador de carga.
Clique em Editar .
Clique em Configuração de back-end.
Clique em Editar ao lado do serviço de back-end.
Clique em Configurações avançadas (afinidade de sessão, tempo limite de diminuição da conexão).
Clique em Ativar a geração de registros.
Defina uma fração da Taxa de amostragem. Ela pode ser definida como qualquer número de 0.0 a 1.0 (padrão).
Clique em Update.

gcloud

Atualize o serviço de back-end para ativar a geração de registros com o comando gcloud compute instance-templates create.

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

onde

--enable-logging ativa a geração de registros para esse serviço de back-end.
--logging-sample-rate permite especificar um valor de 0.0 a 1.0, em que 0.0 significa que nenhuma solicitação é registrada e 1.0 significa que 100% das solicitações são registradas. Só é significativo com o parâmetro --enable-logging. Ativar a geração de registros, mas definir a taxa de amostragem como 0.0, equivale a desativar a geração de registros.

Depois de ativar a geração de registros no serviço de back-end, cada solicitação HTTP(S) é registrada usando o Cloud Logging.

Como visualizar os registros

Para visualizar os registros, acesse o Visualizador de registros.

Os registros do balanceador de carga HTTP(S) interno são indexados primeiro por rede e, em seguida, por região.

Para ver os registros de todos os balanceadores de carga HTTP(S) internos, no primeiro menu suspenso, selecione Regra de balanceamento de carga HTTP/S interno.
Para ver os registros de apenas uma rede, selecione Regra de balanceamento de carga HTTP/S interno e, em seguida, selecione o nome de uma rede.
Para ver os registros de apenas uma região da rede, selecione Regra de balanceamento de carga HTTP/S interno > NETWORK > REGION.

Os campos de registro do tipo booleano normalmente só aparecem se tiverem um valor true. Se um campo booleano tem um valor false, esse campo é omitido do registro.

A codificação UTF-8 é aplicada aos campos de registro. Os caracteres que não forem UTF-8 serão substituídos por pontos de interrogação.

É possível configurar a exportação de métricas com base em registros para registros de recursos (resource.type="internal_http_lb_rule"). As métricas criadas são baseadas no recurso "Regra de balanceamento de carga HTTP/S interno (métricas com base em registros)", disponível nos painéis do Cloud Monitoring:

Acessar Monitoring

O que é registrado

As entradas de registro do balanceamento de carga HTTP(S) contêm informações úteis para monitoramento e depuração do tráfego HTTP(S). As entradas de registro contêm:

Informações gerais exibidas na maioria dos registros do Google Cloud, como gravidade, ID do projeto, número do projeto, carimbo de data e hora etc.
campos de registro HttpRequest.

Campos de registro

Os registros são protos do LogEntry.

Campo	Tipo	Descrição
`logName`	string	O nome do recurso do registro a que a entrada pertence. No formato `"projects/PROJECT_ID/logs/requests"`.
`timestamp`	Formato do carimbo de data/hora	A hora em que a solicitação começou.
`severity`	Formato LogSeverity	A gravidade da entrada de registro. O padrão é `LogSeverity.DEFAULT`.
`httpRequest`	Objeto HttpRequest	Um proto HttpRequest que descreve a solicitação HTTP(S) que está sendo registrada.
`trace`	string	O nome do recurso do trace associado à entrada de registro, se houver. Se ele incluir um nome de recurso relativo, presume-se que o nome seja `https://tracing.googleapis.com`. Exemplo: `projects/PROJECT_ID/traces/06796866738c859f2f19b7cfb3214824`
`spanId`	string	O ID do período dentro do trace associado à entrada de registro. Para períodos de trace, esse é o mesmo formato que a API Trace v2 usa: uma codificação hexadecimal de 16 caracteres de uma matriz de 8 bytes, como `000000000000004a`.
`resource`	Objeto MonitoredResource	O recurso monitorado associado a essa entrada de registro. Consulte o objeto MonitoredResource.

MonitoredResource

Campo	Tipo	Descrição
`networkName`	string	O nome da rede VPC do balanceador de carga.
`region`	string	O nome da região do Google Cloud do balanceador de carga.
`urlMapName`	string	O nome do objeto do mapa de URL configurado para selecionar um serviço de back-end.
`forwardingRuleName`	string	O nome do objeto da regra de encaminhamento.
`targetProxyName`	string	O nome do objeto do proxy de destino referenciado pela regra de encaminhamento.
`matchedUrlPathRule`	string	A regra de caminho do mapa de URL ou a regra de rota configurada como parte da chave do mapa de URL. Pode ser `UNMATCHED` ou `UNKNOWN` como substituto. `UNMATCHED` refere-se a uma solicitação que não corresponde a regras de caminho de URL e, portanto, usa a regra de caminho padrão. `UNKNOWN` indica um erro interno.
`backendTargetName`	string	O nome do back-end selecionado para processar a solicitação, com base na regra de caminho do mapa de URL ou na regra de rota que corresponde à solicitação.
`backendTargetType`	string	O tipo de destino de back-end (`BACKEND_SERVICE` / `UNKNOWN`).
`backendName`	string	O nome do grupo de instâncias de back-end ou NEG.
`backendType`	string	O tipo do back-end: grupo de instâncias ou NEG.
`backendScope`	string	O escopo do back-end: nome da zona ou nome da região. Poderá ser `UNKNOWN` sempre que `backendName` for desconhecido.
`backendScopeType`	string	O escopo do back-end (`REGION`/`ZONE`). Poderá ser `UNKNOWN` sempre que `backendName` for desconhecido.

Monitoring

O balanceamento de carga HTTP(S) interno exporta dados de monitoramento para o Monitoring.

É possível usar as métricas de monitoramento para:

avaliar a configuração, o uso e o desempenho de um balanceador de carga;
resolver problemas;
Melhorar a utilização de recursos e a experiência do usuário

Além dos painéis predefinidos no Monitoring, é possível criar painéis personalizados, configurar alertas e consultar as métricas por meio da API Monitoring.

Como visualizar métricas do Cloud Monitoring

Se quiser usar o Metrics Explorer para visualizar as métricas de um recurso monitorado, siga estas etapas:

No Console do Google Cloud, acesse a página Monitoring.
Acessar Monitoring

Se você nunca tiver usado o Cloud Monitoring, no primeiro acesso ao Monitoring no Console do Google Cloud, um espaço de trabalho será criado automaticamente, e seu projeto será associado a ele. Caso contrário, se o seu projeto não estiver associado a um espaço de trabalho, uma caixa de diálogo será exibida, e será possível criar um espaço de trabalho ou adicionar seu projeto a um espaço de trabalho atual. Recomendamos que você crie um espaço de trabalho. Depois de fazer a seleção, clique em Adicionar.
No painel de navegação do Monitoring, clique em Metrics Explorer.
Verifique se Métrica é a guia selecionada.
No campo Encontrar tipo de recurso e métrica, selecione no menu ou digite o nome do recurso e da métrica. Use as seguintes informações para preencher os campos:
1. Em Recurso, selecione ou insira internal_http_lb_rule. Isso seleciona o recurso Regra de balanceamento de carga HTTP/S interno.
2. Em Métricas, selecione a partir do menu.
Para modificar como os dados são exibidos, use os menus Filtro, Agrupar por e Agregador. Por exemplo, é possível agrupar por rótulos de recurso ou métrica. Para mais informações, consulte Como selecionar métricas.

Como definir políticas de alertas

É possível criar políticas de alertas para monitorar os valores das métricas e ser notificado quando elas violarem uma condição.

Para criar uma política de alertas que monitora um ou mais recursos do balanceador de carga HTTP/S interno, siga estas etapas:

No Console do Google Cloud, acesse a página Monitoring.
Acessar Monitoring

Se você nunca tiver usado o Cloud Monitoring, no primeiro acesso ao Monitoring no Console do Google Cloud, um espaço de trabalho será criado automaticamente, e seu projeto será associado a ele. Caso contrário, se o seu projeto não estiver associado a um espaço de trabalho, uma caixa de diálogo será exibida, e será possível criar um espaço de trabalho ou adicionar seu projeto a um espaço de trabalho atual. Recomendamos que você crie um espaço de trabalho. Depois de fazer a seleção, clique em Adicionar.
No painel de navegação do Monitoring, selecione Alertas e depois Criar política.
Clique em Adicionar condição:
1. As configurações no painel Destino especificam o recurso e a métrica a serem monitorados. No campo Localizar tipo e métrica do recurso, selecione o recurso Balanceador de carga HTTP/S interno. Em seguida, selecione uma métrica da lista.
2. As configurações da política de alertas no painel Configuração determinam quando o alerta é acionado. A maioria dos campos nesse painel é preenchida com valores padrão. Para mais informações sobre os campos no painel, consulte Configuração na documentação das políticas de alertas.
3. Clique em Adicionar.
Para acessar a seção de notificações, clique em Próxima.
Opcional: para adicionar notificações à sua política de alertas, clique em Canais de notificação. Na caixa de diálogo, selecione um ou mais canais de notificação no menu e clique em OK.
Se um canal que você quer adicionar não estiver listado, clique em Gerenciar canais de notificação. Você será direcionado para a página Canais de notificação em uma nova guia do navegador. Nessa seção, é possível atualizar os canais de notificação configurados. Depois de concluir as atualizações, retorne à guia original, clique em Atualizar e selecione os canais de notificação que serão adicionados à política de alertas.
Para avançar à seção de documentação, clique em Próxima.
Clique em Nome e digite um nome para a política de alertas.
Opcional: clique em Documentação e adicione as informações que quer incluir em uma mensagem de notificação.
Clique em Salvar.

Saiba mais em Políticas de alertas.

Como definir painéis personalizados do Monitoring

É possível criar painéis personalizados do Monitoring nas métricas de balanceamento de carga HTTP(S) interno:

Acesse o Monitoring no Console do Google Cloud.
Acessar "Monitoramento"
Selecione Painéis > Criar painel.
Clique em Adicionar gráfico.
Dê um título ao gráfico.
Selecione as métricas e os filtros. Para métricas, o tipo de recurso é Balanceador de carga HTTP/S interno.
Clique em Salvar.

Frequência e retenção de relatórios de métricas

As métricas dos balanceadores de carga são exportadas para o Monitoring em lotes de granularidade de 1 minuto. Os dados de monitoramento são retidos por seis semanas. O painel fornece análise de dados em intervalos padrão de 1H (uma hora), 6H (seis horas), 1D (um dia), 1W (uma semana) e 6W (seis semanas). É possível solicitar manualmente a análise em qualquer intervalo, de 6W a 1 minuto.

Como monitorar métricas de balanceadores de carga HTTP(S) internos

As seguintes métricas para balanceadores de carga HTTP(S) internos são relatadas no Monitoring:

Metric	FQDN	Descrição
Contagem de solicitações	`loadbalancing.googleapis.com/https/internal/request_count`	O número de solicitações exibidas pelo balanceador de carga HTTP(S) interno.
Contagem de bytes da solicitação	`loadbalancing.googleapis.com/https/internal/request_bytes`	O número de bytes enviados como solicitações dos clientes para o balanceador de carga HTTP(S) interno.
Contagem de bytes da resposta	`loadbalancing.googleapis.com/https/internal/response_bytes`	O número de bytes enviados como respostas do balanceador de carga HTTP(S) interno para o cliente.
Latências totais	`loadbalancing.googleapis.com/https/internal/total_latencies`	Uma distribuição da latência, em milissegundos, medida a partir do momento em que o primeiro byte da solicitação é recebido pelo proxy até o momento em que o último byte da resposta é enviado pelo proxy.
Latências de back-end	`loadbalancing.googleapis.com/https/internal/backend_latencies`	Uma distribuição da latência, em milissegundos, medida a partir do momento em que o proxy envia o primeiro byte da solicitação ao back-end até quando o proxy recebe o último byte da resposta do back-end.

Dimensões de filtros de métricas do balanceador de carga HTTP(S) interno

As métricas são agregadas para cada balanceador de carga HTTP(S) interno. As métricas agregadas podem ser filtradas pelas seguintes dimensões:

Propriedade	Descrição
BACKEND_SCOPE	A zona ou região do Google Cloud Platform do grupo de back-ends que veiculou a solicitação do cliente, ou a string especial para casos em que o grupo de back-ends não foi atribuído. Exemplos: `us-central1-a`, `europe-west1-b`, `asia-east1`, `UNKNOWN`.
PROXY_REGION	Região do balanceador de carga HTTP(S) interno, cliente e back-end. Exemplos: `us-central1`, `europe-west1` ou `asia-east1`.
BACKEND	O nome do grupo de instâncias de back-end ou NEG que exibiu a solicitação do cliente.
BACKEND_TARGET	O nome do serviço de back-end que exibiu a solicitação do cliente.
MATCHED_URL_RULE	A regra de caminho do mapa de URL ou a regra de rota que correspondeu ao prefixo da solicitação HTTP(S) do cliente (até 50 caracteres)

A métrica Response code class fraction é aceita em todo o balanceador de carga. Não é permitida mais granularidade.

A seguir

Leia as informações conceituais sobre o balanceamento de carga HTTP(S) interno.
Crie um balanceador de carga HTTP(S) interno.
Consulte Balanceamento de carga interno e nomes do DNS para as opções de nome do DNS disponíveis que o balanceador de carga pode usar.