Backend: Error Monitoring
Backend: Logging
Go
JS
Python
Ruby
Java
Rust
Hosting Providers
Backend: Tracing
Native OpenTelemetry
Fullstack Frameworks
Overview
Self Host & Local Dev
Menu
Apollo Server Error Monitoring
Learn how to set up highlight.io on your Apollo Server backend.
1
Add `tracingOrigins` to your client Highlight snippet.
This backend SDK requires one of the Highlight frontend SDKs to be installed, so please make sure you've followed the fullstack mapping guide first.
H.init("<YOUR_PROJECT_ID>", {
tracingOrigins: ['localhost', 'example.myapp.com/backend'],
networkRecording: {
enabled: true,
recordHeadersAndBody: true,
},
});
2
Install the relevant Highlight SDK(s).
Install @highlight-run/node, @highlight-run/apollo with your package manager.
npm install --save @highlight-run/node @highlight-run/apollo
3
Initialize the Highlight JS SDK.
Initialize the Highlight JS SDK with your project ID.
import { H } from '@highlight-run/node'
H.init({
projectID: '<YOUR_PROJECT_ID>',
serviceName: '<YOUR_SERVICE_NAME>',
environment: 'production',
})
4
Add the Apollo Server integration.
ApolloServerHighlightPlugin
is an Apollo Server plugin to capture errors in your graphql handlers.
import { ApolloServer } from '@apollo/server'
import { ApolloServerHighlightPlugin } from '@highlight-run/apollo'
// on legacy Apollo V3, use the following import
// import { ApolloServerV3HighlightPlugin as ApolloServerHighlightPlugin } from '@highlight-run/apollo'
// ...
const server = new ApolloServer({
typeDefs,
resolvers,
plugins: [
ApolloServerHighlightPlugin({ projectID: '<YOUR_PROJECT_ID>', serviceName: 'my-apollo-app', serviceVersion: 'git-sha', environment: 'production' }),
],
})
5
Optionally, report manual errors in your app.
If you need to report exceptions outside of a handler, use the Highlight SDK.
const parsed = H.parseHeaders(request.headers)
H.consumeError(error, parsed?.secureSessionId, parsed?.requestId)
6
Verify that your SDK is reporting errors.
You'll want to throw an exception in one of your apollo handlers. Access the API handler and make sure the error shows up in Highlight.
const server = new ApolloServer({
typeDefs,
resolvers: {
Query: {
books: () => {
throw new Error('a sample error!');
},
},
},
});
7
Set up logging.
With the JS SDKs, your logs are reported automatically from console methods. See the JS logging setup guide for more details.