Socorro: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(remove obsolete info)
Line 5: Line 5:
[[Breakpad]] is a set of libraries by Mozilla products for client-side crash reporting.   
[[Breakpad]] is a set of libraries by Mozilla products for client-side crash reporting.   


[[Socorro/SocorroServer|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.
[https://github.com/mozilla/socorro/ Socorro] is a server for collecting, processing and reporting on crashes from Breakpad.


[[Socorro/SocorroUI|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.
= How to file a bug for Socorro =


[[Socorro/Middleware|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.  
Thanks for finding and reporting a bug!
 
If this is your first time filing a bug with Bugzilla, you may find this [https://bugzilla.mozilla.org/enter_bug.cgi?format=guided Guided Bug Entry form] useful.  You can leave the Version set to 'unspecified' if you don't know which version of Socorro you are using.
 
If you're well-versed with Bugzilla, you may find our [https://bugzilla.mozilla.org/enter_bug.cgi?product=Socorro&component=General Regular Bug Entry form] more to your liking. The important fields to set in this form are: component, summary, description, and (if known) assignee, blockers, depends. Don't worry, we'll set the values of the fields you don't have answers for.


== Details ==
== Details ==


* [[Socorro/Filling A Bug|Filing A Bug]]
* [http://socorro.readthedocs.org/ Socorro Documentation on readthedocs.org]
* [http://socorro.readthedocs.org/ Socorro Documentation on readthedocs.org]
* [[Socorro/Architecture_Overview|Architecture Overview]]
* [[Socorro/Glossary|Glossary]]
* [[Socorro/Documentation Wanted|Documentation Wanted]]


= Code Repository =
= Code Repository =
Line 26: Line 26:


Socorro is an open source project and we welcome code contributions.  You may use [http://bugzilla.mozilla.org Bugzilla] to [https://bugzilla.mozilla.org/buglist.cgi?product=Socorro&resolution=--- browse through open Socorro bugs] or [https://bugzilla.mozilla.org/enter_bug.cgi?product=Socorro add a new Socorro bug].
Socorro is an open source project and we welcome code contributions.  You may use [http://bugzilla.mozilla.org Bugzilla] to [https://bugzilla.mozilla.org/buglist.cgi?product=Socorro&resolution=--- browse through open Socorro bugs] or [https://bugzilla.mozilla.org/enter_bug.cgi?product=Socorro add a new Socorro bug].
* [[Socorro/SocorroUI/Code Review|Socorro Code Review Practices]]
* [[Socorro/SocorroServer/Coding Standards|Socorro Server Coding Standards]] (Python)
* [[Socorro/SocorroUI/Coding Standards|Socorro UI Coding Standards]] (PHP)


== Staging and Testing ==
== Staging and Testing ==
* We use both trunk and release branches. Please see [[Socorro/Release_Branch_Strategy|Release Branch Strategy]] page for more info.
* We use both trunk and release branches. Please see [[Socorro/Release_Branch_Strategy|Release Branch Strategy]] page for more info.
* [https://hudson.mozilla.org/job/socorro/ Hudson] watches for checkins, runs unit/functional tests
* [https://ci.mozilla.org/job/socorro/ Jenkins] watches for checkins, runs unit/functional tests
* QA has Selenium tests on a separate Hudson instance (runs against staging)
* QA has Selenium tests on a separate Jenkins instance (runs against staging)
* [https://intranet.mozilla.org/Socorro_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]].
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]].
Line 45: Line 40:


*[[Breakpad/Status Meetings|Status Meetings]]
*[[Breakpad/Status Meetings|Status Meetings]]
*[[Socorro:SOLR_API|Solr API Specs]]
= Roadmap =
*[[SocorroRoadmap2010]]
*[http://spreadsheets.google.com/ccc?key=t6zyWLsUinWwzS2_igS2grQ Q4 2010 Schedule]
*[[Breakpad/2009Q3RoadMap|Q4 2009]]
*[[Breakpad/2009Q3RoadMap|Q3 2009]]
*[[Breakpad/2009Q3RoadMap|Q2 2009]]


= Contact Us =
= Contact Us =

Revision as of 06:56, 24 June 2013

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 is a server for collecting, processing and reporting on crashes from Breakpad.

How to file a bug for Socorro

Thanks for finding and reporting a bug!

If this is your first time filing a bug with Bugzilla, you may find this Guided Bug Entry form useful. You can leave the Version set to 'unspecified' if you don't know which version of Socorro you are using.

If you're well-versed with Bugzilla, you may find our Regular Bug Entry form more to your liking. The important fields to set in this form are: component, summary, description, and (if known) assignee, blockers, depends. Don't worry, we'll set the values of the fields you don't have answers for.

Details

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.

Staging and Testing

  • We use both trunk and release branches. Please see Release Branch Strategy page for more info.
  • Jenkins watches for checkins, runs unit/functional tests
  • QA has Selenium tests on a separate Jenkins instance (runs against staging)

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

Planning

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: