Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jungsoft/apollo-sentry-helper
⚠️ Capture your Apollo GraphQL exceptions into Sentry, in a meaningful way.
https://github.com/jungsoft/apollo-sentry-helper
Last synced: about 1 month ago
JSON representation
⚠️ Capture your Apollo GraphQL exceptions into Sentry, in a meaningful way.
- Host: GitHub
- URL: https://github.com/jungsoft/apollo-sentry-helper
- Owner: jungsoft
- License: mit
- Created: 2020-07-23T16:25:54.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-05-07T19:40:33.000Z (over 3 years ago)
- Last Synced: 2024-11-05T22:12:36.449Z (about 2 months ago)
- Language: TypeScript
- Size: 459 KB
- Stars: 17
- Watchers: 3
- Forks: 2
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/apollo-sentry-helper)
[](https://github.com/jungsoft/apollo-sentry-helper/stargazers)
[](https://github.com/jungsoft/apollo-sentry-helper/issues)
[](https://github.com/jungsoft/apollo-sentry-helper/network/members)
[](https://github.com/jungsoft/apollo-sentry-helper/graphs/contributors)
[](#)
> ⚠️ Capture your Apollo GraphQL exceptions into Sentry, in a meaningful way.
# Apollo Sentry Helper
This package provides a new link to connect Sentry with Apollo Client, in order to automatically report GraphQL errors to Sentry in a meaningful way.
## Installation
⚠️ **Attention!** Currently, there are two tags on the NPM package: `latest` and `next`.
- `latest`: Uses `apollo-link-error`, is compatible with **Apollo Client 2**.
- `next`: Uses `@apollo/client/link/error`, is compatible with **Apollo Client 3**.
### Apollo Client 3
```bash
# With npm
npm install apollo-sentry-helper@next
# With yarn
yarn add apollo-sentry-helper@next
```
### Apollo Client 2
```bash
# With npm
npm install apollo-sentry-helper
# With yarn
yarn add apollo-sentry-helper
```
## Usage
Initialize Sentry as you would normally. Then, build the error link with your settings and add it to your Apollo Client's `link` array:
```jsx
import {
ApolloLink,
ApolloClient,
InMemoryCache,
createHttpLink,
} from "@apollo/client";
import { buildSentryErrorLink } from "apollo-sentry-helper";
const httpLink = createHttpLink({ uri: "API_URI_HERE" });
const sentryErrorLink = buildSentryErrorLink();
const link = ApolloLink.from([
sentryErrorLink, // This needs to be before your httpLink!
// Other links here
httpLink,
]);
const client = new ApolloClient({
cache: new InMemoryCache(),
link,
});
```
## Options
You can customize what is going to be included in the error report, and which errors should be reported.
```jsx
const sentryErrorLink = buildSentryErrorLink({
// Defines if the operation body is going to be included in the error report.
// Defaults to true.
includeBody: true,
// Defines if the response is going to be included in the error report.
// Defaults to true.
includeResponse: true,
// Defines if variables are going to be included in the error report.
// Defaults to true.
includeVariables: true,
// Allows the user to filter errors that should be included in the error report.
// By default errors will only be reported if there was a network error, or if
// the operation hasn't returned any data, meaning that the server processed the request,
// but it was invalid. You can override this behavior by setting the "filter" option.
filter: (error: ErrorResponse) => boolean,
});
```
### Be careful what you include
Please note that Sentry sets some limits to how big events can be. For instance, **events greater than 200KiB are immediately dropped (pre decompression)**. More information on that [here](https://docs.sentry.io/accounts/quotas/#attributes-limits).
Furthermore, much of the data you are sending to Sentry can include (sensitive) personal information. This might lead you to violating the terms of the GDPR, so you'll need to be careful here.
## Contributing
Pull requests are welcome! If you have any feedback, issue or suggestion, feel free to open [a new issue](https://github.com/jungsoft/apollo-sentry-helper/issues/new) so we can talk about it 💬.
## Made possible by
## License
MIT © [Jungsoft](https://github.com/jungsoft)