GlitchTip/README.md

GlitchTip Backend

GlitchTip is an open source, Sentry API compatible error tracking platform. It is a partial fork/mostly reimplementation of Sentry's open source codebase before it went proprietary. Its goals are to be a modern, easy-to-develop error tracking platform that respects your freedom to use it any way you wish. Some differences include:

• A modern development environment with Python 3 and Django 3.1.
• Simplicity over features. We use Postgres to store error data. Our code base is a fraction of the size of Sentry and looks like a typical Django app. We leverage existing open source Django ecosystem apps whenever possible.
• Respects your privacy. No massive JS bundles. No invasive tracking. No third party spying. Even our marketing site runs Matomo and respects Do Not Track. GlitchTip will never report home. We will never know if you run it yourself.
• Commitment to open source. We use open source tools like GitLab whenever possible. With our MIT license, you can use it for anything you'd like and even sell it. We believe in competition and hope you make GlitchTip even better.

Project status: Stable. Open an issue and say hello if you'd like to help. We are able to process basic error requests from the open source Sentry client tools. More features are on the way.

Developing

We use Docker for development. View our Contributing documentation if you'd like to help make GlitchTip better.

Run local dev environment

1. Ensure docker and docker-compose are installed
2. docker-compose up
3. `docker-compose run --rm web ./manage.py migrate

Run tests with docker-compose run --rm web ./manage.py test

VS Code (Optional)

VS Code can do type checking and type inference. However, it requires setting up a virtual environment.

1. Install Python 3 dependencies. For Ubuntu this is apt install python3-dev python3-venv
2. Install poetry
3. Create Python virtual environment python3 -m venv env
4. Activate environment source env/bin/activate
5. Install packages poetry install

Load testing

Locust is built into the dev dependencies. To run with locus run docker-compose -f docker-compose.yml -f docker-compose.locust.yml up

Now go to localhost:8089 to run the test.

Locust will not be intalled to production docker images and cannot be run from them.

Acknowledgements

• Thank you to the Sentry team for their ongoing open source SDK work and formerly open source backend of which this project is based on.
• We use Rocket Chat for embedded support on glitchtip.com and in app
• Matomo is used for analytics and is not shared with any third party