How To Use

Auto-revert !

For compile failures and consistent gtest failures, Findit started to auto-revert culprits by creating & committing a revert like this. For compile failures, Findit is usually pretty quick for CXX/CC failures (compile x.cc into x.o), and it is recommended that sheriffs wait for Findit in such cases (~70% of all compile step failures).

  • Sheriffs and troopers: Findit is limited to auto-commit 4 reverts and auto-create another 6 for each failure type* within 24 hours. But if it runs into a serious bug like reverting many commits crazily, please follow the playbook to take appropriate actions.
  • Developers: If you don't want Findit to auto-revert your change, please add a flag 'NOAUTOREVERT=true' in your CL description (example).

* In total, Findit is expected to auto-commit no more than 8 and auto-create no more than 12 within 24 hours.

How to get analysis results?

1. Read results on Sheriff-o-Matic

Findit is integrated with Sheriff-O-Matic (aka SoM) to show analysis results on SoM automatically. For failures on SoM, there is no need to manually trigger the analysis in Findit.

Findit is integrated with Sheriff-o-Matic

2. Trigger analysis on Findit

Open https://findit-for-me.appspot.com/, paste the build URL, trigger an analysis by clicking the Analyze button, and wait for the result.

How to interpret analysis results?

1. On Sheriff-O-Matic UI

Findit provides different information to each failure based on its findings or its status.

  • Revert CL created by Findit

Chromium Sheriffs: Please review and commit the revert CL if you confirm the revert is correct.

  • Revert CL submitted by Findit

Chromium Sheriffs: Please confirm if the revert CL is correct. If not, please revert it and file a bug.

  • Suspected/Culprit CL
  • Flaky test(s)
  • Still running
  • No result
  • Not support

2. On Findit UI

The result from heuristic analysis is usually shown first, because it is as quick as ~ 2 minutes. Later, try-job results for compile and gtest failures will be shown instead.

  • Compile failures
  • Time for analysis:
    • Heuristic result: ~ 2 minutes
    • Try-job result: median = 14 minutes
  • Test failures
  • Time for analysis:
    • Heuristic result: ~ 2 minutes
    • Try-job result: median = 24 minutes