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.

Socorro Middleware is the interface between the Web UI and the Server of Socorro, providing a consistent way of retrieving data through different storage systems.

Details

• Filing A Bug
• Socorro Documentation on readthedocs.org
• Architecture Overview
• Glossary
• Documentation Wanted

Code Repository

The Socorro project is currently hosted on Github at https://github.com/mozilla/socorro

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)

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.

Release

• Socorro Release Procedure

Planning

• Status Meetings
• Solr API Specs

Roadmap

• SocorroRoadmap2010
• Q4 2010 Schedule
• Q4 2009
• Q3 2009
• Q2 2009

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)