Realiza verificaciones de estado

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

Consulta la documentación de Apigee Edge.

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

  1. Verificación de estado de la instancia de Apigee a nivel regional: Muestra el estado de la instancia de Apigee general en una región.
  2. Verificaciones de estado a nivel de entorno: Muestra 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 de instancia de Apigee regional 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 los balanceadores de cargas usan en gran medida, determina el estado de las instancias de Apigee y realiza conmutaciones por error regionales. Puedes realizar una verificación de estado a nivel regional si construyes la solicitud de la siguiente manera:

  • Ruta de verificación de estado: /healthz/ingress
  • Agregar encabezado de solicitud: User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress
Apigee Ingress is healthy
En el ejemplo anterior, $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 de 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. Se prefiere este patrón de verificación de estado 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 de 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.
  • Agregar encabezado de 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 el ejemplo anterior, $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 para 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 el ejemplo anterior, $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.