Informações de registo da verificação de funcionamento

Pode obter registos de verificações de funcionamento do balanceamento de carga quando um ponto final muda o estado de funcionamento. Pode usar os registos de verificação de estado para o seguinte:

• Depuração e resolução de problemas em direto do estado de funcionamento do seu ponto final
• Obter visibilidade do estado de saúde do seu ponto final
• Fins de auditoria e conformidade

As verificações de funcionamento registam informações de transição de estado no Registo. Ativa ou desativa o registo por verificação de funcionamento.

Para ver os registos de verificação de funcionamento no Logging, tem de se certificar de que não tem uma exclusão de registos que se aplique às verificações de funcionamento. Para ver instruções sobre como verificar se os registos GCE Instance Group e Network Endpoint Group são permitidos, consulte o artigo Filtros de exclusão.

Ative e desative o registo

Esta secção descreve como ativar o registo numa verificação de funcionamento nova ou existente e como desativar o registo numa verificação de funcionamento existente.

Ative o registo numa nova verificação de funcionamento

gcloud compute health-checks create PROTOCOL HEALTH_CHECK_NAME \
    --enable-logging

resource "google_compute_health_check" "health_check_tcp_with_logging" {
  provider = google-beta

  name = "health-check-tcp"

  timeout_sec        = 1
  check_interval_sec = 1

  tcp_health_check {
    port = "22"
  }

  log_config {
    enable = true
  }
}

Ative o registo numa verificação de funcionamento existente

gcloud compute health-checks update PROTOCOL HEALTH_CHECK_NAME \
    --enable-logging

Desative o registo numa verificação de funcionamento existente

gcloud compute health-checks update PROTOCOL HEALTH_CHECK_NAME \
    --no-enable-logging

Ver registos

1. Para ver os registos, aceda ao Explorador de registos.

   Os registos de verificações de estado são indexados por grupo de instâncias ou grupo de pontos finais de rede.

2. Para ver todos os registos, no menu Recurso, selecione GCE Instance Group ou Network Endpoint Group, consoante o tipo de back-end.

3. Em alternativa, cole o seguinte no campo Consulta. Substitua PROJECT_ID pelo ID do seu projeto.

   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
   

Pode configurar a exportação de métricas baseadas em registos para verificações de estado do balanceador de carga.

Use filtros para ver registos

Também pode obter registos com base em pesquisas mais específicas. Por exemplo, o filtro seguinte mostra todos os registos de um endereço IP de instância de back-end especificado:

  logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.ipAddress="IP_ADDRESS"

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

A codificação UTF-8 é aplicada aos campos de registo. Os carateres que não são carateres UTF-8 são substituídos por pontos de interrogação.

O que é registado

As entradas do registo de verificação de estado contêm informações úteis para monitorizar e depurar o estado dos seus pontos finais. As entradas do registo contêm os seguintes tipos de informações:

• Informações gerais apresentadas na maioria dos registos, como a gravidade, o ID do projeto, o número do projeto e a data/hora.
• Campos específicos das verificações de estado, descritos nas tabelas seguintes.

Estados da verificação de funcionamento

Um ponto final é considerado HEALTHY ou UNHEALTHY. Estes são os estados básicos. Dentro de cada um destes estados básicos, existem vários estados mais detalhados.

Os NEGs híbridos e os NEGs de Internet regionais que usam verificações de estado do Envoy distribuídas não suportam estados de saúde detalhados.

A tabela seguinte mostra o mapeamento entre os estados de saúde básicos e detalhados.

As alterações de estado nem sempre alteram o comportamento do equilibrador de carga. Considere o seguinte caso:

1. O servidor está a dar a resposta errada, pelo que o ponto final é considerado UNHEALTHY.
2. Em seguida, o servidor deixa de responder e o novo estado é TIMEOUT.
3. O balanceador de carga continua a considerar o ponto final como UNHEALTHY, porque o estado TIMEOUT detalhado é mapeado para o estado UNHEALTHY básico.

A tabela seguinte fornece uma definição de cada estado de integridade.

Existem vários verificadores de estado a sondar cada ponto final; Google Cloud remove as entradas duplicadas do registo antes de registar, para que apenas sejam gerados registos únicos.

Se um verificador de estado for reiniciado, pode ver ocasionalmente o estado de saúde registado a mudar de UNKNOWN para um dos estados conhecidos indicados anteriormente, mesmo que o estado de saúde do ponto final não tenha mudado efetivamente. Google Cloud usa heurísticas de melhor esforço para suprimir essas entradas de registo.

Se estiver a usar a drenagem de ligações, os registos de verificação do estado de funcionamento não são gerados com o estado de funcionamento do ponto final DRAINING. Isto deve-se ao facto de os registos de verificação de funcionamento refletirem os resultados observados pelas sondas de verificação de funcionamento, e a drenagem de ligações não afetar os resultados observados pela sonda de verificação de funcionamento. A drenagem de ligações funciona apenas informando o balanceador de carga de que o novo estado é DRAINING e substitui efetivamente o estado de saúde real do ponto final, conforme observado pelo verificador de estado.

Pode interagir com os registos através da API Cloud Logging. A API oferece formas de filtrar interativamente os registos que têm campos específicos definidos e exportar registos correspondentes para o Cloud Logging, o Cloud Storage, o BigQuery ou o Pub/Sub. Para mais informações sobre a Cloud Logging API, consulte a vista geral da Cloud Logging API.

Entrada do registo de verificação de funcionamento

O LogEntry jsonPayload é preenchido com um campo healthCheckProbeResult que contém as seguintes informações.

Exemplos de filtros

Esta secção fornece exemplos de filtros de registos comuns.

Encontre todos os resultados da verificação de estado de um grupo de instâncias específico

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"  AND
resource.type="gce_instance_group" AND
resource.labels.instance_group_name="INSTANCE_GROUP_NAME"

Encontre todos os resultados da verificação de saúde de um NEG específico

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"  AND
resource.type="gce_network_endpoint_group" AND
resource.labels.network_endpoint_group_id="ENDPOINT_GROUP_ID"

Encontre todas as transições de verificação de estado para o endereço IP da instância de back-end 10.128.15.201

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.ipAddress="10.128.15.201"

Encontre todos os pontos finais que estavam anteriormente em bom estado, mas que agora estão com tempo limite excedido

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
jsonPayload.healthCheckProbeResult.previousDetailedHealthState="HEALTHY"
jsonPayload.healthCheckProbeResult.detailedHealthState="TIMEOUT"

Encontre registos de saúde de um intervalo de tempo específico

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fhealthchecks"
timestamp>"2019-02-14T02:20:00.0Z"
timestamp<"2019-02-14T03:30:00.0Z"

Limitações

• Os registos são gerados apenas para a transição do estado de funcionamento do ponto final.
• As verificações de funcionamento antigas não são suportadas.
• Os conjuntos de alvos não são suportados.
• Os registos não são gerados quando o estado de funcionamento do ponto final é UNKNOWN.
• No caso de migrações de VMs, pode não ver entradas de registo geradas quando o estado de funcionamento do ponto final transita para o estado UNHEALTHY.
• Os registos não são gerados quando os pontos finais são eliminados. Por exemplo, quando para uma VM.

O que se segue?

• Leia informações conceptuais sobre as verificações de saúde.
• Crie uma verificação de funcionamento.
• Leia sobre o registo.