Realiza verificaciones de estado

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Apigee expone verificaciones de estado en diferentes niveles, que puedes aprovechar según el caso de uso.

  1. Verificación de estado a nivel regional o de la instancia de Apigee: Muestra el estado general de la instancia de Apigee en una región.
  2. Verificaciones de estado a nivel del entorno: Muestran el estado de un entorno en particular en la instancia de Apigee.
  3. Verificación de estado personalizada a través de un proxy de API: Para casos de uso complejos, puedes configurar un proxy de API dedicado como extremo de verificación de estado personalizado.

Realiza una verificación de estado a nivel regional

Apigee ofrece una verificación de estado a nivel regional o de la instancia de Apigee para evaluar el estado general de la instancia de Apigee en una región específica. Este patrón de verificación de estado, que usan mucho los balanceadores de cargas, determina el estado de las instancias de Apigee y realiza conmutaciones por error regionales. Para realizar una verificación de estado a nivel regional, construye la solicitud de la siguiente manera:

  • Ruta de verificación de estado: /healthz/ingress
  • Agrega el encabezado de la solicitud: User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress
Apigee Ingress is healthy
, en la que $HOST representa el nombre de host definido en el grupo de entornos de Apigee que entrega el balanceador de cargas.

Realiza una verificación de estado a nivel del entorno

Apigee ofrece una verificación de estado a nivel del entorno para evaluar el estado de un entorno en particular que entrega la instancia de Apigee. Este patrón de verificación de estado es preferible cuando deseas realizar conmutaciones por error regionales en función del estado de ciertos entornos críticos o selectivos. Puedes realizar una verificación de estado a nivel del entorno llamando a cualquier proxy de API válido en un entorno si construyes la solicitud de la siguiente manera:

  • Ingresa /healthz/ a la ruta base del proxy.
  • Agrega el encabezado de la solicitud: User-Agent: GoogleHC.

Por ejemplo, supongamos que /catalog es una ruta base del proxy válida que se implementa en un entorno. Para realizar una verificación de estado, llama al proxy de la siguiente manera: 

$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog
Server Ready
, en la que $HOST representa el nombre de host definido en el grupo de entornos de Apigee que entrega el balanceador de cargas.

Realiza una verificación de estado personalizada a través de un proxy de API

Si deseas realizar validaciones adicionales, puedes definir una lógica de verificación de estado personalizada en un proxy de API implementado en un entorno. Por ejemplo, puedes fallar en la verificación de estado cuando varios entornos están inactivos. O bien, puedes fallar en la verificación de estado en función de la latencia o el estado objetivo.

En este caso, puedes realizar la verificación de estado mediante una llamada normal a la API de ese proxy.

Por ejemplo, supongamos que deseas verificar el estado de un entorno llamado prod. Implementa un proxy de API en ese entorno con la ruta base /healthcheck-prod. Para verificar el estado del entorno prod que entrega la instancia de Apigee, llama al proxy de la siguiente manera: 

$ curl https://$HOST/healthcheck-prod
, en la que $HOST representa el nombre de host definido en el grupo de entornos de Apigee que entrega el balanceador de cargas.

Notas de uso

Para las verificaciones de estado a nivel regional y del entorno: Si las realizan balanceadores de cargas de Google Cloud, el balanceador de cargas configura elUser-Agent. Si tu propio cliente consume estas llamadas a la API de verificación de estado, debes asegurarte de que se establezca la User-Agent correcta.

En Apigee Hybrid: la función de verificación de estado solo está disponible para la versión 1.4 y las versiones posteriores.