Socorro
Socorro is the name for the Mozilla Crash Stats project. It is an open source project which other companies are also using for crash statistics.
Overview
Breakpad is a set of libraries by Mozilla products for client-side crash reporting.
Socorro Server is a Python API and a collection of applications and web services that use the API. The applications together embody a set of servers to take crash dumps generated by remote clients, process using the breakpad_stackdump application and save the results in HBase. Additional processes aggregate and filter data for storage in a relational database.
Socorro UI is the web interface for viewing and parsing crash reports, as well as aggregated data surrounding crash reports. It is written in PHP atop the Kohana framework.
Details
Code Repository
The Socorro project is currently hosted on Google Code at http://code.google.com/p/socorro/ .
The project will be moving to Github in the near future. Once this move takes place, we will update the documentation here accordingly.
Committing Code to Socorro
Socorro is an open source project and we welcome code contributions. You may use Bugzilla to browse through open Socorro bugs or add a new Socorro bug.
- Socorro Code Review Practices
- Socorro Server Coding Standards (Python)
- Socorro UI Coding Standards (PHP)
- SVN standards
Staging and Testing
- We use both trunk and release branches. Please see Release Branch Strategy page for more info.
- Hudson watches for checkins, runs unit/functional tests
- QA has Selenium tests on a separate Hudson instance (runs against staging)
- Staging environments. We will shortly have two: one running trunk and one running the release branch. Right now there is one. It automatically picks up builds from Hudson against trunk.
There is an extraction script to create a copy of the production PostgreSQL database containing only a few weeks of data. It is documented in ExtractDBscript.
Planning
Roadmap
Contact Us
We will be happy to answer your questions to help you get your Socorro install up off the ground. You may contact the Socorro team at either:
- irc: irc.mozilla.org #breakpad
- email: socorro-dev@mozilla.com
- mailing list: tools-socorro@lists.mozilla.org (https://lists.mozilla.org/listinfo/tools-socorro)