When we ask our customers what they use to track errors and events on their sites, Sentry is typically the answer. That’s why we’ve added it as our latest integration: you can display your Sentry events on the same dashboards and graphs that your application performance is displayed on, giving you more information about the cause of potential problems.
For example, a spike in errors recorded by Sentry would be more useful when you can view it as part of a graph of your overall traffic and error rates. With two clicks from your dashboard, you’re in Sentry and looking at the exact cause of the blip on your graphs.
How it works
When the integration is configured, all new Sentry events will be sent to Hosted Graphite. That means errors and exceptions are available to include in your Hosted Graphite dashboards. Additionally, our Annotations API gives you and your team the context you need to figure out what’s caused something strange in your graphs — or to rule something out. Annotations let you connect your metrics to specific events (for example, when you deploy code, run some tests, or a long-running job completes) and have the following properties:
- title – (required) A short summary of the annotation.
- description – A more in-depth description of the annotation.
- tags – A single word or multiple short strings to organise different types of events. e.g. ‘deployments’, ‘feature’, ‘test’ etc.
- start_time – Unix timestamp describing when the event occurred. If this is not specified, the time of event creation is used.
- end_time – Optional timestamp describing when the event completed.
The Sentry annotation description also has a link to the Sentry event itself, so you can dig a little deeper if you need more context and information.
Setting up Hosted Graphite’s Sentry integration
It only takes a few minutes to add the Sentry integration to your Hosted Graphite account. Follow the steps below to get set up.
Go to the add-ons section of your Hosted Graphite account:
Activate Sentry by clicking the ‘Enable’ button:
Copy your Sentry webhook location by clicking the ‘Copy’ button and follow the mouseover directions:
Adding an Alerting Endpoint (in your Sentry account)
Browse to your Sentry account, visit ‘Project Settings’ section, and click ‘All Integrations’:
Scroll down to ‘WebHooks’ and make sure the tick box is checked. Save changes if necessary:
Browse to the Alerts settings:
Scroll down, and add the Hosted Graphite Sentry webhook location to the field. Don’t forget to save your changes:
Scroll back up and either add or edit an alert Rule that corresponds to the Events you want to send to Hosted Graphite. Only alerts you send will appear on your graphs, so choose triggers and intervals that make sense for your use case:
Ensure the notification is being sent through WebHooks. (You can send it to other services too, if you’d like.)
You’ve now saved a Hosted Graphite webhook for your alerting endpoint and assigned it to an alert. Now, once you’ve triggered some alerts, you can plot them on your graphs.
Once that’s all configured, you’ll start seeing Sentry events on your Hosted Graphite dashboards automatically.