Performance Tracing for GraphQL with Apollo and it’s friends

Often when you develop an application performance matters. The most important asset you have when it comes to perceived performance is the response time of your backend services. If you use it is most likely the system that comes right before the user-facing application, so it should be the central part to take a look at when it comes to performance. GraphQL If you only use a GraphQL backend and you have no other backend systems and no frontend under your control read no further. GraphQL comes with a built-in tracing solution for this use case, their . It gives you a lot of insights about GraphQL, but only about GraphQL, this is why I would like to show you a second option, that allows you to include performance data from all your systems: Apollo Performance Analytics apollo-opentracing Getting Started Apollo offers this great concept of extensions to introduce cross-cutting functionality to your GraphQL server. As a user of an extension, you just need to add it in an array as a function that returns an instance of the extension. In our case, we initiate the extension with two tracers, one for the GraphQL server internal traces called local and one for the traces the application receives in its role as a server. Opentracing When a GraphQL backend with this is deployed with an opentracing compatible tracer, for example with and you get a nice performance graph like this out of the box: Zipkin zipkin-javascript-opentracing Ideally, you could also add your frontend as the first layer, seeing exactly which action in which frontend took how long and went to which system. With this in place, you make it very easy for everyone in your organization to reason about performance and you enable new developers to understand your software system by exploring it, while also getting a feeling for the timings of each service. Sounds great, what else do I need to know? Here are some small insights that may help you make the most out of this extension: Which Tracers can I use? There are two Opentracing tracers for Javascript that I am aware of: and by jaeger this is a great intro article RisingStack with the Opentracing adapter by me (so if the docs are unclear, please let me know!) zipkin zipkin-javascript-opentracing What does it cost? In performance tracing you always pay for insight with actual performance. Different tracers might have different performance characteristics, but in general they need to make HTTP requests in order to store their tracing data and this puts at least a little bit of stress on your system. The way that the tracing community decided to go with this is to add the concept of samplers. A sampler is a function that decides if a span should really be traced or not. By only tracing a certain percentage of incoming requests you can still get enough data that allows you to reason about performance easily, without putting the stress on all of your customers. In development I always work with a 100% sample rate, I want to see what is going on in my system. What can I learn here? You can learn about performance tracing (see further reading) and why it might help you By looking into the very minimal source code of you can learn about all the API apollo provides to hook into different lifecycle events of resolving a GraphQL query apollo-opentracing Further reading If you are interested in diving into performance tracing, here are some introduction blog posts I wrote: Performance Monitoring for the Frontend — An introduction Performance Monitoring for the Frontend — Using Zipkin