https://github.com/moesif/moesif-apollo-graphql-example
An example of using Moesif with Apollo GraphQL server.
https://github.com/moesif/moesif-apollo-graphql-example
analytics apollo debugging graphql
Last synced: 6 months ago
JSON representation
An example of using Moesif with Apollo GraphQL server.
- Host: GitHub
- URL: https://github.com/moesif/moesif-apollo-graphql-example
- Owner: Moesif
- Created: 2018-10-11T23:06:44.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-21T19:21:58.000Z (9 months ago)
- Last Synced: 2025-04-01T20:51:30.016Z (6 months ago)
- Topics: analytics, apollo, debugging, graphql
- Language: JavaScript
- Homepage: https://www.moesif.com
- Size: 945 KB
- Stars: 2
- Watchers: 6
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Moesif Apollo GraphQL Example
[Moesif](https://www.moesif.com/features/graphql-analytics) is an API Analytics and monitoring platform for [GraphQL](https://www.moesif.com/features/graphql-analytics).
[Apollo](https://www.apollographql.com/) is a popular frameworks for creating and using [GraphQL](https://graphql.org/learn/) in the Node.js ecosystem.
This example builds upon the [get started example](https://www.apollographql.com/docs/apollo-server/essentials/server.html#middleware) from the official guide on Apollo's website to demonstrate how you can set up Moesif quickly using the [moesif express](https://www.moesif.com/docs/server-integration/express/) middleware.
## Summary of key changes
Apollo sever works with any express app. When you set up Apollo with express, you can simply add the moesif-express
middleware. Below summarizes the code needed. See `index.js` from this package for details.
```javascript
const { ApolloServer, gql } = require('apollo-server-express');
const express = require('express');
const moesifExpress = require('moesif-express');
// ...
const server = new ApolloServer({ typeDefs, resolvers });
const app = express();
const moesifOptions = {
applicationId: 'Your Moesif Application Id'
};
const moesifMiddleware = moesifExpress(moesifOptions);
// this adds moesif middleware to express app.
app.use(moesifMiddleware);
// this adds apollo server to the express app.
server.applyMiddleware({ app });
app.listen({ port: 6868 });
```
Your Moesif Application Id can be found in the [_Moesif Portal_](https://www.moesif.com/).
After signing up for a Moesif account, your Moesif Application Id will be displayed during the onboarding steps.
You can always find your Moesif Application Id at any time by logging
into the [_Moesif Portal_](https://www.moesif.com/), click on the top right menu,
and then clicking _Installation_.
## To run this example:
- open up `index.js` and replace application id with the application id obtained from Moesif.
- run `npm install` to install all dependencies.
- start the app `node index.js`
- use browser to navigate to `http://localhost:6868/graphql`
- run some test queries, for example:
```
query {
books { title }
}
```
You should see the GraphQL request captured in your Event Stream, it is where it will show up first.
## Notes
- You'll notice other requests besides GraphQL are captured also. That is ok and expected, since moesif-express
works at a lower level than GraphQL. You can change this default by modify the skip option of moesif-express.
- If you are using Apollo to create a wrapper around other restful APIs, you may consider capture all outgoing API calls so you get the big pictures of how everything is connected:
```javascript
moesifMiddleware.startCaptureOutgoing();
```
- Go to [moesif-express](https://github.com/Moesif/moesif-express) SDK documentation for more configuration options.
- For more information on what you can do with [API analytics for GraphQL check out here](https://www.moesif.com/docs/platform/graphql/).