Health checks

Load balancers often use health checks to determine if a server is available and ready to serve traffic.

GraphQL-level health checks

The easiest way to determine if your GraphQL server is healthy is to run a GraphQL operation.

Every GraphQL server supports a trivial query that requests the

1
https://your.server/graphql?query=%7B__typename%7D

Note that this health check will run an actual GraphQL operation. If your server requires special headers or cookies to run any query, you'll need to provide those with your request.

If you want to create a health check for your HTTP server that is unrelated to the health of the GraphQL execution engine (i.e., such as

Below is an example of an HTTP server health check with

1
// imports, etc.
2

3
const app = express();
4
const server = new ApolloServer({
5
  typeDefs,
6
  resolvers,
7
});
8

9
await server.start();
10
app.use('/graphql', cors<cors.CorsRequest>(), express.json(), expressMiddleware(server));
11
await new Promise<void>((resolve) => app.listen({ port: 4000 }, resolve));
12

13
// Our GraphQL server is listening for GraphQL operations
14
// on `http://localhost:4000/graphql`
15
console.log(`🚀 Server ready at http://localhost:4000/graphql`);
16

17
// Requests to `http://localhost:4000/health` now return "Okay!"
18
app.get('/health', (req, res) => {
19
  res.status(200).send('Okay!');
20
});

1
// imports, etc.
2

3
const app = express();
4
const server = new ApolloServer({
5
  typeDefs,
6
  resolvers,
7
});
8

9
await server.start();
10
app.use('/graphql', cors(), express.json(), expressMiddleware(server));
11

12
await new Promise((resolve) => app.listen({ port: 4000 }, resolve));
13

14
// Our GraphQL server is listening for GraphQL operations
15
// on `http://localhost:4000/graphql`
16
console.log(`🚀 Server ready at http://localhost:4000/graphql`);
17

18
// Requests to `http://localhost:4000/health` now return "Okay!"
19
app.get('/health', (req, res) => {
20
  res.status(200).send('Okay!');
21
});