View a markdown version of this page

Registros de verificação de saúde - Elastic Load Balancing

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Registros de verificação de saúde

O Elastic Load Balancing fornece registros de verificação de saúde que capturam informações detalhadas sobre o status da verificação de saúde de seus alvos registrados, incluindo motivos de falha quando as verificações de saúde falham. Os registros de verificação de integridade são compatíveis com instâncias do EC2, endereços IP e destinos de funções do Lambda. Cada entrada de registro contém informações como tipo ou conexão de solicitação de verificação de integridade, data e hora, endereço de destino, ID do grupo-alvo, status de integridade e código do motivo. Você pode usar esses registros de verificação de integridade para analisar os padrões de integridade do alvo, monitorar as transições de integridade e solucionar problemas.

Os registros de verificação de saúde são um recurso opcional que está desativado por padrão. Depois de habilitar os registros de verificação de saúde para seu balanceador de carga, o Elastic Load Balancing captura os registros e os armazena como arquivos compactados no bucket do Amazon S3 que você especificar. Você pode desativar os registros de verificação de saúde a qualquer momento.

Você receberá cobranças pelos custos de armazenamento do Amazon S3, mas não haverá cobranças pela largura de banda usada pelo Elastic Load Balancing para enviar arquivos de log para o Amazon S3. Para obter mais informações sobre os custos de armazenamento, consulte Preços do Amazon S3.

Importante

Embora os registros “antigos” tradicionais (descritos nesta seção) permaneçam disponíveis, o Application Load Balancer agora oferece opções aprimoradas de registro por meio de CloudWatch registros. CloudWatch Os registros oferecem opções de entrega mais flexíveis, inclusive para Amazon CloudWatch Logs, Amazon Data Firehose e Amazon Simple Storage Service. Para configurar essas opções aprimoradas de registro, acesse a guia Integrações do seu balanceador de carga. Para obter mais informações sobre CloudWatch registros, consulteCloudWatch Registros do seu Application Load Balancer.

Arquivos de log de verificação de integridade

O Elastic Load Balancing publica um arquivo de log para cada nó do balanceador de carga a cada 5 minutos. O balanceador de carga pode fornecer vários registros no mesmo período quando um grande número de destinos é anexado ao balanceador de carga ou quando um pequeno intervalo de verificação de integridade é configurado (por exemplo, a cada 5 segundos).

Os nomes dos arquivos dos registros de verificação de integridade usam o seguinte formato:

bucket[/prefix]/AWSLogs/aws-account-id/elasticloadbalancing/region/yyyy/mm/dd/health_check_log_aws-account-id_elasticloadbalancing_region_app.load-balancer-id_end-time_ip-address_random-string.log.gz
bucket

O nome do bucket do S3.

prefix

(Opcional) O prefixo (hierarquia lógica) no bucket. O prefixo especificado não pode incluir a string AWSLogs. Para mais informações, consulte Organizar objetos usando prefixos.

AWSLogs

Adicionamos a parte do nome do arquivo que começa com AWSLogs após o nome do bucket e o prefixo opcional que você especificar.

aws-account-id

O ID da AWS conta do proprietário.

region

A Região para seu load balancer e o bucket do S3.

aaaa/mm/dd

A data em que o log foi entregue.

load-balancer-id

O ID de recursos do load balancer. Se o ID de recursos contiver barras (/), elas são substituídos por pontos (.).

end-time

A data e a hora em que o intervalo de registro terminou. Por exemplo, a hora final de 20140215T2340Z contém entradas para solicitações feitas entre 23h35 e 23h40 no horário UTC ou Zulu.

ip-address

O endereço IP do nó do load balancer que processou a solicitação. Para um load balancer interno, esse é um endereço IP privado.

random-string

Uma string aleatória gerada pelo sistema.

Veja um exemplo de um nome de arquivo de log com um prefixo:

s3://amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/elasticloadbalancing/us-east-2/2022/05/01/health_check_log_123456789012_elasticloadbalancing_us-east-2_app.my-loadbalancer.1234567890abcdef_20220215T2340Z_172.160.001.192_20sg8hgm.log.gz

Veja um exemplo de um nome de arquivo de log sem um prefixo:

s3://amzn-s3-demo-logging-bucket/AWSLogs/123456789012/elasticloadbalancing/us-east-2/2022/05/01/health_check_log_123456789012_elasticloadbalancing_us-east-2_app.my-loadbalancer.1234567890abcdef_20220215T2340Z_172.160.001.192_20sg8hgm.log.gz

Você pode armazenar arquivos de log em seu bucket indefinidamente. Você também pode definir as regras de ciclo de vida do Amazon S3 para arquivar ou excluir os arquivos de log automaticamente. Para obter mais informações, consulte o Gerenciamento do ciclo de vida do objeto no Guia do usuário do Amazon S3.

Entradas de registro de verificação de integridade

O Elastic Load Balancing registra os resultados da verificação de integridade do alvo, incluindo os motivos da falha de todos os alvos registrados desse balanceador de carga. Cada entrada de registro contém os detalhes de um único resultado de verificação de saúde feito no alvo registrado.

Sintaxe

A tabela a seguir descreve os campos de uma entrada de registro de verificação de integridade, em ordem. Todos os campos são delimitados por espaços. Quando adicionamos um novo campo, o adicionamos ao final da entrada de log. Enquanto preparamos o lançamento de um novo campo, você pode ver um “-” adicional no final antes que o campo seja lançado. Certifique-se de configurar a análise de log para que pare após o último campo documentado e para que atualize a análise de log após o lançamento de um novo campo.

Campo (posição) Description

type (1)

O tipo de solicitação ou conexão de verificação de integridade. Os valores possíveis são as seguintes (ignorar todos os outros valores):

  • http-- HTTP

  • https-- HTTP sobre TLS

  • h2-- HTTP/2 sobre TLS

  • grpc-- gRPC

  • lambda-- Função Lambda

time (2)

Data e hora de quando a verificação de integridade é iniciada em um alvo, no formato ISO 8601.

latência (3)

Tempo total decorrido (em segundos) para concluir a verificação de saúde atual.

target_addr (4)

Endereço IP e porta do destino no formato, IP:Port. O ARN do Lambda se o alvo for uma função do Lambda.

target_group_id (5)

Nome do grupo-alvo ao qual o alvo está associado.

status (6)

O status da verificação de saúde. Esse valor é PASS se a verificação de saúde for bem-sucedida. Em uma verificação de saúde malsucedida, o valor é FAIL

código_de_status (7)

O código de resposta recebido do alvo para a solicitação de verificação de integridade.

código_motivo (8)

O motivo da falha se a verificação de integridade falhar. Consulte Códigos de motivo de erro

cotovelo (9)

O ID de recursos do load balancer. Se você estiver analisando entradas no log de acesso, observe que as IDs dos recursos podem conter barras (/).

endereço_IP (10)

O endereço IP do nó do load balancer que processou a solicitação. Para um load balancer interno, esse é um endereço IP privado.

Códigos de motivo de erro

Se a verificação de integridade do alvo falhar, o balanceador de carga registrará um dos seguintes códigos de motivo no registro de verificação de integridade.

Código Description

TimedOut

A verificação de integridade falhou porque a tentativa de conexão com o alvo atingiu o tempo limite ou o alvo não respondeu dentro do período de tempo limite configurado para verificação de integridade. Isso pode ocorrer quando o grupo de segurança do alvo bloqueia o tráfego de entrada na porta de verificação de integridade, o alvo demora a responder ou o handshake TLS não é concluído a tempo

ConnectionReset

A verificação de integridade falhou porque o alvo redefiniu ou fechou corretamente a conexão antes que uma resposta válida fosse retornada

ResponseCodeMismatch

O código de status HTTP da resposta do alvo à solicitação de verificação de integridade não correspondeu ao código de status configurado

ResponseStringMismatch

O corpo de resposta retornado pelo alvo não continha a string configurada na configuração de verificação de integridade do grupo-alvo

InternalError

Erro interno do balanceador de carga

TargetError

O Target retorna o código de erro 5xx em resposta à solicitação de verificação de integridade

GRPCStatusHeaderEmpty

A resposta de destino do GRPC tem um cabeçalho grpc-status sem valor

GRPCUnexpectedStatus

O alvo do GRPC responde com um status de grpc inesperado

nota

O novo código TimedOut do motivo do erro substitui os códigos do ConnectionTimedOut motivo RequestTimedOut e.

Exemplo de entradas de log do

Veja a seguir exemplos de entradas de registro de verificação de integridade. Observe que o texto de exemplo aparece em várias linhas apenas para facilitar a leitura.

Veja a seguir um exemplo de entrada de registro para uma verificação de saúde bem-sucedida.

http 2025-10-31T12:44:59.875678Z 0.019584011 172.31.20.97:80 HCLogsTestIPs PASS 200 -

Veja a seguir um exemplo de entrada de registro para uma falha na verificação de integridade.

http 2025-10-31T12:44:58.901409Z 1.121980746 172.31.31.9:80 HCLogsTestIPs FAIL 502 TargetError

Configurar notificações de entrega de logs

Para receber notificações quando o Elastic Load Balancing entregar logs ao seu bucket do S3, use Notificações de eventos do Amazon S3. O Elastic Load Balancing usa PutObject CreateMultipartUpload, e POST Object para entregar registros para o Amazon S3. Para ter certeza de que você receberá todas as notificações de entrega de logs, inclua todos esses eventos de criação de objetos em sua configuração.

Para obter mais informações, consulte Notificações de eventos do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

Processando arquivos de log de verificação de integridade

Os arquivos de log da verificação de integridade são compactados. Se você baixar os arquivos, deverá descompactá-los para visualizar as informações.

Se houver uma grande demanda no seu site, o load balancer poderá gerar arquivos de log com gigabytes de dados. Você pode não conseguir processar uma quantidade tão grande de dados usando o processamento linha por linha. Assim, pode ter de usar ferramentas analíticas que forneçam soluções de processamento paralelo. Por exemplo, você pode usar as seguintes ferramentas analíticas para analisar e processar registros de verificação de integridade:

  • O Amazon Athena é um serviço de consultas interativas que facilita a análise de dados no Amazon S3 usando SQL padrão.

  • Loggly

  • Splunk

  • Sumo logic