EngineeringProductivity/Projects/Treeherder: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Remove dev now it has been decomissioned)
(update the page: removed or update outdated information)
 
(27 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== Overview ==
== About ==
[https://treeherder.mozilla.org/ Treeherder] is a reporting dashboard for checkins to Mozilla projects (for example, [https://developer.mozilla.org/en-US/docs/mozilla-central mozilla-central] or [https://wiki.mozilla.org/Gaia gaia]). It allows users to see the results of automatic builds and their respective tests. Treeherder also provides a rich set of API's that can be used by other projects interested in this information.
[https://treeherder.mozilla.org/ Treeherder] is a reporting dashboard for checkins to Mozilla projects (for example, [https://github.com/mozilla-firefox/firefox mozilla-firefox/firefox's "main" also known as "mozilla-central" branch]). It allows users to see the results of automatic builds and their respective tests. Treeherder also provides a rich set of APIs that can be used by other projects interested in this information.


Treeherder is the successor to [[Sheriffing/TBPL|TBPL]].
Treeherder is the successor to [[Sheriffing/TBPL|TBPL]].


For tracking performance data, see Treeherder's sister project, [[Auto-tools/Projects/Perfherder|Perfherder]].
For tracking performance data, see Treeherder's sister project, [[EngineeringProductivity/Projects/Perfherder|Perfherder]].
 
For tracking intermittent test failures, see [[EngineeringProductivity/Projects/IntermittentFailuresView|Intermittent Failures View]].


== Contributing ==
== Contributing ==
To make UI changes, in many cases you only need to perform a very simple setup running a local webserver pointing at the production instance, described [https://treeherder-ui.readthedocs.org/en/latest/installation.html here]. If you wish to hack on the backend, or the UI and backend together, you will instead need to set up both the [https://github.com/mozilla/treeherder-ui treeherder-ui] and [https://github.com/mozilla/treeherder treeherder] Github repos as a pair, following [https://treeherder-service.readthedocs.org/en/latest/installation.html these steps].
To make UI-only changes, you only need to perform a very simple setup running a local webserver pointing at the production backend, described [https://treeherder.readthedocs.io/installation.html#ui-development here]. If you wish to hack on the backend, or the UI and backend together, you will instead need to set up a Vagrant environment, using [https://treeherder.readthedocs.io/installation.html#server-and-full-stack-development these steps].
* [https://ateam-bootcamp.readthedocs.org/en/latest/ A-Team Bootcamp]: Best practices for working on A-Team projects (of which Treeherder is one), including valuable information on using Git and Bugzilla. If you're new to Mozilla or the A-Team, please read this guide thoroughly before proceeding.
 
* Good first bugs for new developers: [http://www.joshmatthews.net/bugsahoy/?reporting=1&unowned=1 Bugs Ahoy]
* [https://ateam-bootcamp.readthedocs.io/en/latest/ A-Team Bootcamp]: Best practices for working on A-Team projects (of which Treeherder is one), including valuable information on using Git and Bugzilla. If you're new to Mozilla or the A-Team, please read this guide thoroughly before proceeding.
* Bugzilla: [https://bugzilla.mozilla.org/enter_bug.cgi?product=Tree+Management&component=Treeherder File a bug] / [https://bugzilla.mozilla.org/buglist.cgi?product=Tree+Management&f1=component&v1=Treeherder&o1=substring&resolution=--- All open bugs] / [https://bugzilla.mozilla.org/buglist.cgi?order=Bug%20Number&resolution=FIXED&chfieldto=Now&chfield=resolution&chfieldfrom=-14d&chfieldvalue=FIXED&f1=component&v1=Treeherder&o1=substring Recently fixed] / [[#Bug_Tables|Bug tables]]
* Issue tracker: [https://bugzilla.mozilla.org/enter_bug.cgi?product=Tree+Management&component=Treeherder Report a bug] / [https://bugzilla.mozilla.org/query.cgi?query_format=advanced&product=Tree+Management&f1=component&o1=substring&v1=Treeherder&resolution=--- search open bugs]
* Chat on IRC: [irc://irc.mozilla.org/treeherder #treeherder] / [http://logs.glob.uno/?c=treeherder Channel logs] ([[IRC|learn about IRC]])
* Mozilla Treeherder instances: [https://prototype.treeherder.nonprod.cloudops.mozgcp.net/ Prototype] / [https://treeherder.allizom.org Staging] / [https://treeherder.mozilla.org Production] / [https://whatsdeployed.io/s-dqv Deployed changes info]
* Mailing list: [https://lists.mozilla.org/listinfo/dev-tree-management dev.tree-management] (or [https://groups.google.com/forum/#!forum/mozilla.dev.tree-management via Google groups])
* Meetings: [[Auto-tools/Projects/Treeherder/Meetings|Notes & dial-in details]]
* Mozilla Treeherder instances: [https://treeherder.allizom.org Staging] / [https://treeherder.mozilla.org Production] ([https://mana.mozilla.org/wiki/display/websites/treeherder.mozilla.org mana page])


== Source and Docs ==
== Source and Docs ==
* UI: [https://github.com/mozilla/treeherder-ui Source] / [https://treeherder-ui.readthedocs.org Docs]
* UI & backend: [https://github.com/mozilla/treeherder Source] / [https://treeherder.readthedocs.io Docs]
* Backend: [https://github.com/mozilla/treeherder Source] / [https://treeherder-service.readthedocs.org Docs]
* Treeherder data submission clients:
* Treeherder data submission clients:
** Python: [https://github.com/mozilla/treeherder/tree/master/treeherder/client Source] / [http://treeherder-service.readthedocs.org/en/latest/submitting_data.html docs]
** Pulse: [https://hg.mozilla.org/automation/mozillapulse/ Source] / [http://treeherder.readthedocs.io/submitting_data.html#submitting-using-pulse docs]
** NodeJS: [https://github.com/mozilla/treeherder-node Source] / [https://github.com/mozilla/treeherder-node/blob/master/README.md README]


== Bug Tables ==
== Getting in touch ==
=== [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=%3Atreeherder+-assignee%3Anobody%40mozilla.org Assigned] ===
* Chat on Element: [https://chat.mozilla.org/#/room/#treeherder:mozilla.org #treeherder]
A summary of Treeherder bugs that are being worked on at the moment.
<bugzilla>
{
"component": "Treeherder", "component_type": "contains",
"resolution": "---",
"email1": "nobody@mozilla.org", "email1_type": "not_equals", "email1_assigned_to": "1",
"include_fields": "id,priority,component,summary,assigned_to",
"order": "priority,assigned_to"
}
</bugzilla>
=== [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=%3Atreeherder+P1-2+assignee%3Anobody%40mozilla.org Unassigned P1-2] ===
Ideally these are the bugs that should be worked on next, once the currently assigned bugs are fixed.
<bugzilla>
{
"quicksearch": ":treeherder priority:P1,P2 assignee:nobody@mozilla.org",
"include_fields": "id,priority,component,summary",
"order": "priority,component"
}
</bugzilla>
=== [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=%3Atreeherder+priority%3A--+assignee%3Anobody%40mozilla.org Needing Triage] ===
All bugs that do not have a priority set and are unassigned.
<bugzilla>
{
"component": "Treeherder", "component_type": "contains",
"resolution": "---",
"priority": "--",
"assignee": "nobody@mozilla.org",
"include_fields": "id,component,summary",
"order": "component"
}
</bugzilla>
=== [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=%3Atreeherder All open bugs] ===
<bugzilla>
{
"component": "Treeherder", "component_type": "contains",
"resolution": "---",
"include_fields": "id,priority,component,summary,assigned_to"
}
</bugzilla>
=== [https://bugzilla.mozilla.org/buglist.cgi?order=Bug%20Number&resolution=FIXED&chfieldto=Now&chfield=resolution&chfieldfrom=-14d&chfieldvalue=FIXED&f1=component&v1=Treeherder&o1=substring Recently fixed] ===
Bugs changed to "Resolved FIXED" in the last 14 days.
<bugzilla>
{
  "component": "Treeherder", "component_type": "contains",
  "resolution": "FIXED",
  "changed_after": "-14d",
  "changed_before": "Now",
  "changed_field": "resolution",
  "changed_field_to": "FIXED",
  "include_fields": "id,component,summary,assigned_to",
  "order": "assigned_to,id"
}
</bugzilla>

Latest revision as of 10:21, 24 November 2025

About

Treeherder is a reporting dashboard for checkins to Mozilla projects (for example, mozilla-firefox/firefox's "main" also known as "mozilla-central" branch). It allows users to see the results of automatic builds and their respective tests. Treeherder also provides a rich set of APIs that can be used by other projects interested in this information.

Treeherder is the successor to TBPL.

For tracking performance data, see Treeherder's sister project, Perfherder.

For tracking intermittent test failures, see Intermittent Failures View.

Contributing

To make UI-only changes, you only need to perform a very simple setup running a local webserver pointing at the production backend, described here. If you wish to hack on the backend, or the UI and backend together, you will instead need to set up a Vagrant environment, using these steps.

Source and Docs

Getting in touch

Retrieved from "https://wiki.mozilla.org/index.php?title=EngineeringProductivity/Projects/Treeherder&oldid=1255752"