Após implantar uma aplicação no SAE, use o recurso de verificação de integridade para confirmar se a aplicação funciona corretamente e identificar problemas quando ocorrerem exceções. O SAE permite configurar verificações de integridade durante a criação e a implantação da aplicação. Este tópico descreve como configurar as verificações de integridade no console do SAE.
Contexto
Como funcionam as verificações de integridade
Uma verificação de integridade usa sondas de atividade, prontidão ou inicialização para verificar periodicamente uma instância da aplicação e relatar os resultados ao console do SAE. Isso ajuda a entender a integridade geral do serviço em um ambiente de cluster e a localizar problemas.
O SAE é construído sobre Kubernetes e oferece os seguintes tipos de verificação de integridade:
-
Sonda de atividade: Determina se uma instância da aplicação está em execução.
Se a sonda for bem-sucedida: A instância da aplicação está íntegra e o SAE não executa nenhuma ação.
Se a sonda falhar: A instância da aplicação não está íntegra e o SAE reinicia a instância.
-
Sonda de prontidão: Determina se uma instância da aplicação está pronta para processar tráfego recebido.
Se a sonda for bem-sucedida: A instância da aplicação está pronta e o SAE aloca tráfego para a instância.
Se a sonda falhar: A instância da aplicação não está pronta. O SAE relata uma exceção para a instância e não aloca tráfego para ela.
-
Sonda de inicialização: Determina se uma instância da aplicação foi iniciada com sucesso.
Se a sonda for bem-sucedida: A instância da aplicação foi iniciada com sucesso. As sondas de atividade e de prontidão, se configuradas, começam apenas após o sucesso da sonda de inicialização.
Se a sonda falhar: A instância da aplicação não conseguiu iniciar. O SAE relata uma exceção e reinicia automaticamente a instância.
Critérios de sucesso e falha
Sucesso: Uma sonda é considerada bem-sucedida quando o número de verificações consecutivas com sucesso atinge o limiar de integridade especificado.
Falha: Se uma única verificação de integridade falhar, o SAE continua a realizar verificações no intervalo configurado. Caso o número de falhas consecutivas atinja o limiar de não integridade especificado, o SAE toma medidas. Para uma sonda de atividade com falha, o SAE reinicia a instância da aplicação. Para uma sonda de prontidão com falha, o SAE remove a instância do endpoint de serviço para que ela não receba mais tráfego.
Parâmetros de verificação de integridade
O SAE usa os seguintes parâmetros para verificar o status das aplicações e das instâncias da aplicação.
-
Atraso inicial
O atraso em segundos após o início da aplicação antes que a primeira sonda comece. Esse valor deve ser maior que o tempo de inicialização da aplicação para evitar falhas na sonda e reinicializações subsequentes durante a implantação.
-
Tempo limite
O tempo limite para uma única sonda, em segundos. O valor padrão é 1. Por exemplo, se você definir esse valor como 10, a sonda falhará se não receber uma resposta dentro de 10 segundos. Se você definir esse parâmetro como 0 ou deixá-lo vazio, o tempo limite padrão de 1 segundo será usado.
-
Período
O intervalo entre as verificações de integridade, em segundos. O valor padrão é 30. Por exemplo, se você definir esse valor como 5, uma verificação será realizada a cada 5 segundos. Para acelerar a inicialização, o SAE pode executar a sonda de prontidão com mais frequência do que o período configurado imediatamente após o início de uma instância, permitindo que ela receba tráfego mais rapidamente.
Procedimento
-
Criar uma aplicação
Na lista de aplicações do SAE, selecione a região e o namespace desejados na parte superior e clique em Create Application. Após configurar as definições na página basic information, clique em Next: advanced settings.
Modificar uma aplicação em execução
AvisoA reimplantação de uma aplicação a reinicia. Para evitar interrupções de serviço ou outros erros inesperados, realize operações de implantação fora dos horários de pico.
Na lista de aplicações do SAE, selecione a região e o namespace desejados na parte superior e clique no Application ID da sua aplicação para acessar a página de detalhes. No painel de navegação à esquerda, clique em basic information e, em seguida, clique em deploy application no canto superior direito.
Modificar uma aplicação parada
Na lista de aplicações do SAE, selecione a região e o namespace desejados na parte superior e clique no Application ID da sua aplicação para acessar a página de detalhes. Clique em basic information e, em seguida, clique em Modify Application Configuration.
Expanda a seção Application health check settings e configure os parâmetros conforme necessário.
Configuração
-
Conforme necessário, ative Enable application instance liveness check (Liveness configuration), Enable application readiness probe (Readiness configuration) ou Enable startup probe configuration. Os parâmetros de configuração são os mesmos para os três tipos de sonda.
NotaÉ possível configurar as sondas de atividade, prontidão e inicialização individualmente ou em qualquer combinação. Recomendamos configurar todas as três.
Quando todas as três verificações de integridade estiverem configuradas, a sonda de inicialização será executada primeiro. As sondas de atividade e de prontidão começam apenas após o sucesso da sonda de inicialização, respeitando cada uma seu atraso inicial configurado.
-
Selecione um Check method e configure seus parâmetros.
Verificação por requisição HTTP: Verifica a integridade da instância enviando uma requisição HTTP. A instância é considerada íntegra se o código de status estiver entre 200 e 399; caso contrário, é considerada não íntegra.
Verificação por porta TCP: Verifica a integridade da instância estabelecendo uma conexão de soquete TCP. A instância é considerada íntegra se a conexão for bem-sucedida; caso contrário, é considerada não íntegra.
Verificação por comando executável: Verifica a integridade da instância executando um comando dentro dela. A instância é considerada íntegra se o comando retornar um código de saída 0; caso contrário, é considerada não íntegra.
Requisição HTTP
Parâmetro
Descrição
Path
O caminho a ser acessado no servidor HTTP.
Port
A porta a ser acessada no servidor HTTP.
Advanced settings
Expanda advanced settings para configurar uma verificação opcional que valida se o corpo da resposta contém uma palavra-chave especificada.
Protocol
Selecione HTTP ou HTTPS.
initial delay (seconds)
O atraso em segundos após o início da aplicação antes que a primeira sonda comece. Esse valor deve ser maior que o tempo de inicialização da aplicação para evitar falhas na sonda e reinicializações subsequentes durante a implantação.
timeout (seconds)
O tempo limite para uma única sonda, em segundos. O valor padrão é 1. Por exemplo, se você definir esse valor como 10, a sonda falhará se não receber uma resposta dentro de 10 segundos. Se você definir esse parâmetro como 0 ou deixá-lo vazio, o tempo limite padrão de 1 segundo será usado.
period (seconds)
O intervalo entre as verificações de integridade, em segundos. O valor padrão é 30. Por exemplo, se você definir esse valor como 5, uma verificação será realizada a cada 5 segundos. Para acelerar a inicialização, o SAE pode executar a sonda de prontidão com mais frequência do que o período configurado imediatamente após o início de uma instância, permitindo que ela receba tráfego mais rapidamente.
healthy threshold (times)
O número mínimo de sucessos consecutivos necessários para que uma sonda seja considerada bem-sucedida após ter falhado. Para uma sonda de atividade, esse valor deve ser 1.
unhealthy threshold (times)
O número de falhas consecutivas após o qual uma sonda é considerada como tendo falhado.
Porta TCP
Parâmetro
Descrição
TCP port
A porta TCP a ser acessada para a verificação de integridade.
initial delay (seconds)
O atraso em segundos após o início da aplicação antes que a primeira sonda comece. Esse valor deve ser maior que o tempo de inicialização da aplicação para evitar falhas na sonda e reinicializações subsequentes durante a implantação.
timeout (seconds)
O tempo limite para uma única sonda, em segundos. O valor padrão é 1. Por exemplo, se você definir esse valor como 10, a sonda falhará se não receber uma resposta dentro de 10 segundos. Se você definir esse parâmetro como 0 ou deixá-lo vazio, o tempo limite padrão de 1 segundo será usado.
period (seconds)
O intervalo entre as verificações de integridade, em segundos. O valor padrão é 30. Por exemplo, se você definir esse valor como 5, uma verificação será realizada a cada 5 segundos. Para acelerar a inicialização, o SAE pode executar a sonda de prontidão com mais frequência do que o período configurado imediatamente após o início de uma instância, permitindo que ela receba tráfego mais rapidamente.
healthy threshold (times)
O número mínimo de sucessos consecutivos necessários para que uma sonda seja considerada bem-sucedida após ter falhado. Para uma sonda de atividade, esse valor deve ser 1.
unhealthy threshold (times)
O número de falhas consecutivas após o qual uma sonda é considerada como tendo falhado.
Comando executável
Parâmetro
Descrição
initial delay (seconds)
O atraso em segundos após o início da aplicação antes que a primeira sonda comece. Esse valor deve ser maior que o tempo de inicialização da aplicação para evitar falhas na sonda e reinicializações subsequentes durante a implantação.
timeout (seconds)
O tempo limite para uma única sonda, em segundos. O valor padrão é 1. Por exemplo, se você definir esse valor como 10, a sonda falhará se não receber uma resposta dentro de 10 segundos. Se você definir esse parâmetro como 0 ou deixá-lo vazio, o tempo limite padrão de 1 segundo será usado.
period (seconds)
O intervalo entre as verificações de integridade, em segundos. O valor padrão é 30. Por exemplo, se você definir esse valor como 5, uma verificação será realizada a cada 5 segundos. Para acelerar a inicialização, o SAE pode executar a sonda de prontidão com mais frequência do que o período configurado imediatamente após o início de uma instância, permitindo que ela receba tráfego mais rapidamente.
healthy threshold (times)
O número mínimo de sucessos consecutivos necessários para que uma sonda seja considerada bem-sucedida após ter falhado. Para uma sonda de atividade, esse valor deve ser 1.
unhealthy threshold (times)
O número de falhas consecutivas após o qual uma sonda é considerada como tendo falhado.
Command
O comando a ser executado dentro da instância. Para obter mais informações sobre comandos de sonda, consulte Configure Probes na documentação do Kubernetes.
NotaO SAE fornece dois interpretadores de shell:
-
>_ /bin/sh
-
>_ /bin/bash
Exemplo: O comando
cat /tmp/healthyverifica periodicamente a existência do arquivo/tmp/healthy. A verificação é bem-sucedida (retorna 0) se o arquivo existir.
Verificar os resultados
Após configurar as verificações de integridade, acesse a página basic information da aplicação e clique na aba Instances. Na área Default Group, visualize o status de execução de cada instância. Passe o mouse sobre o ícone de status para visualizar detalhes sobre a configuração da verificação de integridade.
|
Status de execução |
Descrição |
|
Indica que nenhuma verificação de integridade está configurada para a instância. Nota
|
|
Falha nas verificações de integridade de atividade e prontidão O status da instância é Running, mas uma mensagem vermelha de Health check failed é exibida. |
Indica que a verificação de integridade falhou e a instância não está íntegra. Nota
Passe o mouse sobre o status da instância para visualizar o motivo da falha. Para etapas de resolução, clique em Troubleshooting Guide. |
|
Verificação de integridade aprovada O status da instância aparece em verde como Running, sem mensagens de aviso. |
Indica que a verificação de integridade foi aprovada e a instância está íntegra. |
Causas comuns de falhas na verificação de integridade
O atraso inicial é muito curto, fazendo com que a verificação de integridade comece antes que a aplicação seja totalmente inicializada. Aumente o atraso e tente novamente.
A configuração da verificação de integridade está incorreta. Verifique a porta e o caminho.
O serviço está sob carga excessiva. Verifique os dados de monitoramento da aplicação para confirmar. Se esta for a causa, aumente o número de instâncias, use um tipo de instância maior ou diminua o tamanho do heap da JVM.
A aplicação falha ao iniciar. Tente desativar as verificações de integridade para diagnosticar o problema. Se a aplicação ainda assim falhar ao iniciar, talvez seja necessário otimizar seu código.