Table of Contents
Glitchtip
Glitchtip is an application error tracker. It's basically a free, lightweight alternative for Sentry. It even ingests the exact same data as Sentry, so you can just use Sentry's tools to send errors from your application to Glitchtip.
Our instance runs at https://glitchtip.zeus.gent. Read this page to learn how to use it as a user, how to add Glitchtip to your Zeus application, and to maintain Glitchtip as a sysadmin.
As a user
To get a Glitchtip account, sign in on https://glitchtip.zeus.gent using Github, or create an account. You won't be able to see anything when logging in, this is normal. Request access to the Zeus WPI organisation by asking someone on Mattermost.
As a application maintainer
Add Sentry to your app
Adding Glitchtip to your application is easy:
- Create a Glitchtip project
- Copy the DSN
- Use the copied DSN in the configuration
- Then deploy your application,
- Send a test message to make sure everything works.
For an example in Rails, check out these commits: adding basic Sentry configuration and only use Sentry in production.
Add webhooks to get notified
You'll probably want to add a webhook to Mattermost so you know when something goes wrong:
- On Mattermost, click the icon in the upper left corner
- Choose for “Integrations”
- Choose for “Incoming webhooks”
- Click on “Add incoming webhook” in the top right corner
- Set up your webhook by giving it a decent name, description, etc.
- Copy the webhook URL
- On Glitchtip, in the project settings, create a new project alert
- Add An Alert Recipient
- Choose for “General webhook”
- Paste the URL you copied in step 6
As a sysadmin
Glitchtip is running on Prattchet, on the Glitchtip user, through docker. Check out the `docker-compose.yml` in `~/glitchtip`.