Apollo Server

Our 2.x integration is deprecated, please upgrade to 3.x. Migration information is available here.

The AppSignal for Node.js integration for Apollo GraphQL (apollo-server) v2.0.0+.


The @appsignal/apollo-server is not compatible with the 3.x Node.js integration.

Our migration guide. explains how you can upgrade your Apollo Server integration from 2.x to 3.x.

Add both the @appsignal/nodejs and @appsignal/apollo-server packages to your package.json. Then, run yarn install/npm install.

You can also add these packages to your package.json on the command line:

yarn add @appsignal/nodejs@2 @appsignal/apollo-server
npm install --save @appsignal/nodejs@2 @appsignal/apollo-server

You can then import and use the package in your app.


The module includes an Apollo Server plugin for automatically instrumenting the resolvers of your application.

To use the Apollo Server plugin, require it from the @appsignal/apollo-server package, and pass it in the plugins property when initialising ApolloServer, with an Appsignal instance as an argument:

const { createApolloPlugin } = require("@appsignal/apollo-server");
const server = new ApolloServer({
  /* ... */
  plugins: [createApolloPlugin(appsignal)],

NOTE: In order for a GraphQL query to have its own entry in the Performance view of AppSignal.com, you must give it a name. For example, the named query query AllBooks {books} will show up in the performance view as an entry named AllBooks, but the unnamed query {books} will be grouped together with all other unnamed queries, showing up in the performance view as a single entry named [unknown graphql query].

Full example

const { Appsignal } = require("@appsignal/nodejs");
const { createApolloPlugin } = require("@appsignal/apollo-server");
// You can also use one of the apollo-server integrations here,
// e.g. `apollo-server-<integration>`. Note that you will also need to require
// the AppSignal integration for it separately.
const { ApolloServer } = require("apollo-server");
const appsignal = new Appsignal({
  active: true,
  pushApiKey: "<YOUR API KEY>", // Note: renamed from `apiKey` in version 2.2.5
// The GraphQL schema
const typeDefs = gql`
  type Query {
    "A simple type for getting started!"
    hello: String
// A map of functions which return data for the schema.
const resolvers = {
  Query: {
    hello: () => "world",
const server = new ApolloServer({
  plugins: [createApolloPlugin(appsignal)],
server.listen().then(({ url }) => {
  console.log(`🚀 Server ready at ${url}`);


The integration will send the following instrumentation data to AppSignal:

  • ✅ Query duration
  • ✅ GraphQL query bodies
  • ✅ Errors

Need more help?

Contact us and speak directly with the engineers working on AppSignal. They will help you get set up, tweak your code and make sure you get the most out of using AppSignal.

Contact us

Start a trial - 30 days free

AppSignal is a great way to monitor your Ruby, Elixir & Node.js applications. Works great with Rails, Phoenix, Express and other frameworks, with support for background jobs too. Let's improve your apps together.

Start a trial