A gateway instance is offline

What it means#

A running copy of APIM, the program that serves your APIs, has stopped reporting. On a hub server, that copy serves no calls, and at a site, the site’s gateway may be down.

What raises it#

The instance has sent no status for two minutes. A hub instance is named hub-<n> after its server. Its status is kept for a week, so a stopped instance stays on the list. A hub instance that never reported at all, or has been silent for more than a week, shows without a time.

What to check#

List the APIM instances, with whether each reported in the last two minutes:

$ weikio get apim-instances

See the whole platform’s health:

$ weikio platform health

How to fix it#

For a hub instance, start it on the hub server of the same number, in the stack’s folder:

$ docker compose up -d apim

For a site’s instance, check that the gateway runs at the site and that the site can reach the hub.