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
a1.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 de0.0
a1.0
, em que0.0
significa que nenhuma solicitação é registrada e1.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 como0.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:
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.
|
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
Para visualizar as métricas de um recurso monitorado usando o Metrics Explorer, siga estas etapas:
- No Console do Google Cloud, acesse a página 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:
- Em Recurso, selecione ou insira internal_http_lb_rule. Isso seleciona o recurso Regra de balanceamento de carga HTTP/S interno.
- 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 o 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 notificationsAlertas e depois Criar política.
- Clique em Adicionar condição:
- 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.
- 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.
- 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 autorenewAtualizar 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.
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.