Distributed caching for the Apollo Router

If you have multiple Apollo Router instances, those instances can share a Redis-backed cache for their query plans and automatic persisted queries (APQ). This means that if any of your router instances caches a particular value, all of your instances can look up that value to significantly improve responsiveness.

To use this feature:

• You must have a Redis cluster (or single instance) that your router instances can communicate with.
• You must have a GraphOS Enterprise plan and connect your router to GraphOS.

How it works

Whenever a router instance requires a query plan or APQ query string to resolve a client operation:

1. The router instance checks its own in-memory cache for the required value and uses it if found.
2. If not found, the router instance then checks the distributed Redis cache for the required value and uses it if found. It also then replicates the found value in its own in-memory cache.
3. If not found, the router instance generates the required query plan or requests the full operation string from the client for APQ.
4. The router instance stores the obtained value in both the distributed cache and its in-memory cache.

Distributed query plan caching

To enable distributed caching of query plans, add the following to your router's YAML config file:

1
supergraph:
2
  query_planning:
3
    experimental_cache:
4
      redis: 
5
        urls: ["redis://..."] 

The value of urls is a list of URLs for all Redis instances in your cluster. These can be redis:// or rediss:// URLs.

Distributed APQ caching

To enable distributed caching of automatic persisted queries (APQ), add the following to your router's YAML config file:

1
apq:
2
  router:
3
    cache:
4
      redis: 
5
        urls: ["redis://..."] 

The value of urls is a list of URLs for all Redis instances in your cluster. These can be redis:// or rediss:// URLs.