Sentry

From Tardis
Revision as of 13:59, 17 February 2015 by Skull (talk | contribs)
Jump to: navigation, search
Note: This system is currently installed but is still being set up and is not yet ready for production use.

Sentry is hosted on Judoon and can be accessed at http://judoon.tardis.ed.ac.uk/.

Sentry is a realtime event logging and aggregation platform. It specializes in monitoring errors and extracting all the information needed to do a proper post-mortem without any of the hassle of the standard user feedback loop. (From PyPI)

Registration

Typically you will be registering in response to an invite to join an organisation. In this case, you will get an email from Sentry with text such as

You have been invited to join the ORGNAME organization on Sentry.

ORGNAME is using Sentry to capture exceptions in real-time.

To accept this invitation, proceed to the following url:

http://judoon.tardis.ed.ac.uk/accept/<int>/<key>/

When you follow the link in the email, you will be able to create an account if you do not already have one.

Documentation

Documentation for Sentry is available within Sentry itself at http://judoon.tardis.ed.ac.uk/docs/.

Useful information in the documentation includes how to set up the raven client in Python, PHP, Ruby, JavaScript, Java, Node.js and Go.

Components

This section goes into the technical setup of the sentry server, Judoon

PostgreSQL

We're using peer authentication for PostgreSQL, so if you need to get at the command line for sentry's db, use the following:

root@judoon# sudo -u sentry psql

Nginx

There is only one VHost enabled in Nginx, sentry.

Because we're just using the one VHost, Nginx logs are just in the default /var/log/nginx folder.

Redis

Redis is still in a default config.

Supervisor

Supervisor is in use to daemonize Gunicorn and Celery.

Config for supervisord lives at /etc/supervisord.conf.

Individual app configs go in /etc/supervisor/ and can be viewed with supervisorctl.

Sentry

Configuration lives at /etc/sentry.conf.py.