Hosted Graphite + Sentry: Event and error tracking on your dashboards

November 21, 2017

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:

Hosted Graphite add-ons

Activate Sentry by clicking the ‘Enable’ button:

Activate Sentrry

Copy your Sentry webhook location by clicking the ‘Copy’ button and follow the mouseover directions:

Sentry webhook

Adding an Alerting Endpoint (in your Sentry account)

Browse to your Sentry account, visit ‘Project Settings’ section, and click ‘All Integrations’:

Hosted Graphite All Integrations

Scroll down to ‘WebHooks’ and make sure the tick box is checked. Save changes if necessary:

Save changes to webhooks

Browse to the Alerts settings:

Hosted Graphite Alerts

Scroll down, and add the Hosted Graphite Sentry webhook location to the field. Don’t forget to save your changes:

Sentry webhook

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:

Alert rules

Ensure the notification is being sent through WebHooks. (You can send it to other services too, if you’d like.)

Save webhook rules

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.

Heather Wiencko

Software Engineering Manager at Hosted Graphite.

Related Posts

See why thousands of engineers trust Hosted Graphite with their monitoring