Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(147)

Unified Diff: tools/perf/docs/triaging_data_stoppage_alerts.md

Issue 2712383003: Add updated documentation for debugging data stoppage alerts. (Closed)
Patch Set: Actually add documentation Created 3 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « tools/perf/docs/perf_regression_sheriffing.md ('k') | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: tools/perf/docs/triaging_data_stoppage_alerts.md
diff --git a/tools/perf/docs/triaging_data_stoppage_alerts.md b/tools/perf/docs/triaging_data_stoppage_alerts.md
new file mode 100644
index 0000000000000000000000000000000000000000..586c45d688fb2e416f318942382bd4691b43e168
--- /dev/null
+++ b/tools/perf/docs/triaging_data_stoppage_alerts.md
@@ -0,0 +1,51 @@
+# Triaging Data Stoppage Alerts
+
+## What is a data stoppage alert?
+A data stoppage alert is a new type of alert on the perf dashboard. Instead of a
+performance regression, it indicates that the dashboard is no longer receiving
+data for the given monitored test. A bug created from a data stoppage alert has
+a subject starting with **“No data received for…”**.
+
+## How to triage data stoppage alerts
+
+### Check if the alert is recovered.
+Look at the graph and see if there are new points, if so, mark the alert
+**ignored**.
+
+### File a bug
+Use the triage dialog to file a bug about the failure, and track your
+investigation. Cc the owner of the benchmark from
+[go/chrome-benchmarks](http://goto.google.com/chrome-benchmarks).
+
+### Get the logs
+Each alert has a debug button at the right-hand side of the table. It tries to
+automatically find the last successful build and the first failed build. To get
+the logs:
+ * First try the *"Logs"* link from *"Next revison built"* (this should be the
+ first failed revision). Sometimes this can't be generated properly, so it
+ may not work.
+ * Next try the *"Buildbot status page"* link from *"Next revision built"*.
+ This should take you to the next build. **If this page 404s, it's possible
+ the builder was taken down.** Check the waterfall.
+
+Once you have the logs, put the link in the bug and also paste relevant snippets
+about the failure (error logs) in the bug.
+
+### Check for suspicious changes.
+It has a link to *"View commit log from rXXX to rYYY"*, click the link to view
+CLs in the range. Look through the range for test disables, telemetry/catapult
+changes, and changes to the code under test. If you see a CL that looks like a
+likely culprit, cc the author in the bug.
+
+### Kick off a bisect.
+If the test is failing on the *"Next revision built"*, bisect may be able to
+narrow down the culprit. Go to the graph, click a data point, and click the
+bisect button in the tooltip. **You'll need to change the values for return_code
+bisect as follows**:
+ * **Bug ID**: Make sure to fill in the ID of the bug you just filed.
+ Otherwise the bisect will not update it.
+ * **Earlier revision**: Change this to the *"Last revision uploaded"* from the
+ debug button dialog.
+ * **Later revision**: Change this to the *"Next revision built"* from the
+ debug button dialog.
+ * **Bisect mode**: Change this to **return_code**
« no previous file with comments | « tools/perf/docs/perf_regression_sheriffing.md ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698