Docs
Launch GraphOS Studio

Debugging subgraph requests from the Apollo Router or @apollo/gateway

Log query plans and subgraph calls to help debug problematic queries

federationgatewayroutersubgraphs

As your grows, you may need to debug a problematic for one reason or another. The Apollo Router and @apollo/gateway both serve as an entry point into your federated graph and offer ways to debug requests.

Each client request goes through a process called query planning that generates the requests to execute. You can log out the in both the and gateway.

Output query plans with headers

With the Apollo Router v0.16.0+ and @apollo/gateway v2.5.4+, you can pass the following headers to return the in the response :

  • Including the Apollo-Query-Plan-Experimental header returns the in the response
  • Additionally, including the Apollo-Query-Plan-Experimental-Format header with one of the supported options changes the output format:
    • A value of prettified returns a human-readable string of the
    • A value of internal returns a JSON representation of the

Log Apollo Router subgraph calls

If, instead, you want to debug your HTTP requests in an instance, you can use Rhai scripts to log the necessary information out. An example Rhai script is shown below.

⚠️ CAUTION

While it's possible to log out the , Apollo strongly recommends not doing so to avoid leaking sensitive information into your logs.

fn subgraph_service(service, subgraph) {
service.map_request(|request| {
log_info(`Subgraph: ${subgraph} Query: ${request.subgraph.body.query}`);
});
}

The above uses an inline closure within the map_request function of the subgraph_service hook to log the -related information.

To enable , you must run the with the --dev flag and leverage Apollo Sandbox to display your query plans.

As an alternative to using --dev, you can also enable via the below configuration option, however, Apollo strongly discourages this as the feature may be removed or renamed in the future.

plugins:
experimental.expose_query_plan: true

Log @apollo/gateway subgraph calls

To debug queries to your within an @apollo/gateway instance, you can use a buildService function to log the and body.

⚠️ CAUTION

While it's possible to log out the , Apollo strongly recommends not doing so to avoid leaking sensitive information into your logs.

class DebugDataSource extends RemoteGraphQLDataSource {
willSendRequest({
request
}: GraphQLDataSourceProcessOptions<
Record<string, any>
>): void | Promise<void> {
console.log(`Operation name: ${request.operationName}`);
console.log(`Query body: ${request.query}`);
}
}
const gateway = new ApolloGateway({
debug: true,
supergraphSdl,
buildService({url}) {
return new DebugDataSource({url});
}
});

The above snippet creates a new class called DebugDataSource to log out the and body using the willSendRequest hook, which is called before execution.

Lastly, it also enables the debug setting on the gateway configuration to print out in the logs for further debugging if needed.

Next
Home
Edit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc.

Privacy Policy

Company