Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
O Apigee expõe verificações de funcionamento a diferentes níveis, que pode tirar partido consoante o exemplo de utilização.
- Verificação do estado de funcionamento ao nível regional / da instância do Apigee: devolve o estado de funcionamento geral da instância do Apigee numa região.
- Verificações de funcionamento ao nível do ambiente: devolve o estado de funcionamento de um ambiente específico na instância do Apigee.
- Verificação de estado personalizada através de um proxy de API: para exemplos de utilização complexos, pode configurar um proxy de API dedicado como um ponto final de verificação de estado personalizado.
Realizar uma verificação de funcionamento ao nível regional
O Apigee oferece uma verificação do estado de funcionamento ao nível regional / da instância do Apigee para avaliar o estado de funcionamento geral da instância do Apigee numa região específica. Este padrão de verificação de funcionamento, amplamente usado pelos balanceadores de carga, determina o estado de funcionamento das instâncias do Apigee e executa failovers regionais. Pode fazer uma verificação de estado ao nível regional construindo o pedido da seguinte forma:
- Caminho da verificação de estado:
/healthz/ingress - Adicione o cabeçalho do pedido:
User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress Apigee Ingress is healthy
$HOST representa o nome do anfitrião definido no
grupo de ambientes do Apigee
que é publicado pelo equilibrador de carga.
Realizar uma verificação de funcionamento ao nível do ambiente
O Apigee oferece uma verificação de estado ao nível do ambiente para avaliar o estado de um ambiente específico servido pela instância do Apigee. Este padrão de verificação de estado é preferível quando quer fazer failovers regionais com base no estado de determinados ambientes críticos/seletivos. Pode realizar uma verificação do estado de funcionamento ao nível do ambiente chamando qualquer proxy de API válido num ambiente construindo o pedido da seguinte forma:
- Adicione
/healthz/ao caminho base do proxy. - Adicione o cabeçalho do pedido:
User-Agent: GoogleHC.
Por exemplo, parta do princípio de que /catalog é um basepath de proxy válido implementado num ambiente. Para fazer uma verificação de estado, chame o proxy da seguinte forma:
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog Server Ready
$HOST representa o nome do anfitrião definido no
grupo de ambientes do Apigee
que é publicado pelo equilibrador de carga.
Realizar uma verificação de estado personalizada através de um proxy de API
Se quiser realizar validações adicionais, pode definir uma lógica de verificação de estado personalizada num proxy de API implementado num ambiente. Por exemplo, pode falhar a verificação de estado quando vários ambientes estão inativos. Em alternativa, pode não passar na verificação de estado com base no estado ou na latência do destino.
Neste caso, pode fazer a verificação do estado fazendo uma chamada API normal a esse proxy.
Por exemplo, suponha que quer verificar o estado de funcionamento de um ambiente denominado prod.
Implemente um proxy de API nesse ambiente com o caminho base /healthcheck-prod.
Para verificar o estado do ambiente prod apresentado pela instância do Apigee,
chame o proxy da seguinte forma:
$ curl https://$HOST/healthcheck-prod
$HOST representa o nome do anfitrião definido no
grupo de ambientes do Apigee
que é publicado pelo equilibrador de carga.
Notas de utilização
Para verificações de funcionamento ao nível regional e ao nível do ambiente: se forem realizadas pelos
balanceadores de carga do Google Cloud,
o balanceador de carga define o cabeçalho User-Agent correto. Se o seu próprio cliente consumir estas chamadas da API de verificação do estado, tem de se certificar de que o User-Agent correto está definido.
Para o Apigee Hybrid: a funcionalidade de verificação de funcionamento só está disponível para a versão 1.4 e superiores.