summaryrefslogtreecommitdiffstats
path: root/testing/docs/sheriffed-intermittents/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'testing/docs/sheriffed-intermittents/index.md')
-rw-r--r--testing/docs/sheriffed-intermittents/index.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/testing/docs/sheriffed-intermittents/index.md b/testing/docs/sheriffed-intermittents/index.md
new file mode 100644
index 0000000000..1fbe2be670
--- /dev/null
+++ b/testing/docs/sheriffed-intermittents/index.md
@@ -0,0 +1,44 @@
+Sheriffed intermittent failures
+===============================
+The Firefox Sheriff team looks at all failures for tasks which are visible by default
+in Treeherder (tier 1 and 2) and are part of a push on a sheriffed tree (autoland,
+mozilla-central, mozilla-beta, mozilla-release, mozilla-esr trees) and determines if the
+failure is a regression or an intermittent failure. In the case of an intermittent
+failure, the sheriffs annotate the failure and the annotation is logged in
+[Treeherder](https://treeherder.mozilla.org/intermittent-failures).
+
+In most cases the sheriffs will determine if a new bug is needed or an existing bug
+already tracks this kind of failure. In most cases sheriffs will annotate the failure
+using a "Single Tracking Bug", in other cases there will be specific failures that are
+tracked seperately.
+
+Single tracking bugs
+--------------------
+Single tracking bugs are used to track test failures seen in CI. These are tracked
+at the test case level (typically path/filename) instead of the error message.
+We have found that many times we have >1 bug tracking failures on a test case,
+but none of the bugs are frequent enough to get attention of the test owners.
+In addition, when a developer is looking into fixing an intermittent failure, they
+are debugging the file, and it is great to see ALL the related failures in one place.
+
+There are 2 ways to get detailed information about test failures:
+1. [Treeherder](https://treeherder.mozilla.org/intermittent-failures), when viewing a specific issue,
+there is a table, on the far right side of the table is the column titled `Log`.
+If you click the text box underneath that, a drop down of all failure types will be populated,
+selecting a failure will filter on that failure to see logs, etc.
+2. from `mach test-info`, one can view a breakdown of all failures and where they occur
+(example: `./mach test-info failure-report --bugid 1781668`)
+
+
+The workflow of single tracking bugs is as follows:
+ - Sheriffs find new failures in CI and create new bugs. If Treeherder can find the path,
+ Treeherder will recommend a `single tracking bug` and strip out the error message.
+ - Sheriffs will annotate existing bugs if the failure to annotate has a test path and in
+ the list of bug suggestions there is a `single tracking bug`. Treeherder will offer
+ that up as the choice as long as the test paths match (and other criteria like crashes,
+ assertions, leaks, etc. are met)
+ - Sheriffs will needinfo triage owner if enough failures occur
+ (currently 30 failures a week, etc.)
+ - Developers will be able to investigate the set of failures, any specific bugs they are
+ fixing (for some or all of the conditions). It is best practice to use the
+ `single tracking bug` as a META bug and file a new bug blocking the META bug with the specific fix.