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

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

Issue 2611183005: Add "Useful Logs and Debugging Info" section to perf sheriff doc. (Closed)
Patch Set: Created 3 years, 11 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 | « no previous file | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: tools/perf/docs/perf_bot_sheriffing.md
diff --git a/tools/perf/docs/perf_bot_sheriffing.md b/tools/perf/docs/perf_bot_sheriffing.md
index 585391c48c401574af4e94a92313ab0cece63840..181d3dc6e8aeddf5b518de353874402132306543 100644
--- a/tools/perf/docs/perf_bot_sheriffing.md
+++ b/tools/perf/docs/perf_bot_sheriffing.md
@@ -206,14 +206,6 @@ be investigated. When a test fails:
ensure that the bug title reflects something like "Fix and re-enable
testname".
4. Investigate the failure. Some tips for investigating:
- * When viewing buildbot step logs, **use the **<font color="blue">[stdout]</font>** link to view logs!**.
- This will link to logdog logs which do not expire. Do not use or link
- to the logs found through the <font color="blue">stdio</font> link
- whenever possible as these logs will expire.
- * When investigating Android, look for the logcat which is uploaded to
- Google Storage at the end of the run. logcat will contain much more
- detailed Android device and crash info than will be found in
- Telemetry logs.
* If it's a non flaky failure, indentify the first failed
build so you can narrow down the range of CLs that causes the failure.
You can use the
@@ -238,6 +230,51 @@ be investigated. When a test fails:
the logs alone. On other platforms, Devtools will produce tab
screenshots as long as the tab did not crash.
+### Useful Logs and Debugging Info
+
+1. **Telemetry test runner logs**
+
+ **_Useful Content:_** Best place to start. These logs contain all of the
+ python logging information from the telemetry test runner scripts.
+
+ **_Where to find:_** These logs can be found from the buildbot build page.
+ Click the _"[stdout]"_ link under any of the telemetry test buildbot steps
+ to view the logs. Do not use the "stdio" link which will show similiar
+ information but will expire earilier and be slower to load.
+
+2. **Android Logcat (Android)**
+
+ **_Useful Content:_** This file contains all Android device logs. All
+ Android apps and the Android system will log information to logcat. Good
+ place to look if you believe an issue is device related
+ (Android out-of-memory problem for example). Additionally, often information
+ about native crashes will be logged to here.
+
+ **_Where to find:_** These logs can be found from the buildbot status page.
+ Click the _"logcat dump"_ link under one of the _"gsutil upload"_ steps.
+
+3. **Test Trace (Android)**
+
+ **_Useful Content:_** These logs graphically depict the start/end times for
+ all telemetry tests on all of the devices. This can help determine if test
+ failures were caused by an environmental issue.
+ (see [Cross-Device Failures](#Android-Cross-Device-Failures))
+
+ **_Where to find:_** These logs can be found from the buildbot status page.
+ Click the _"Test Trace"_ link under one of the
+ _"gsutil Upload Test Trace"_ steps.
+
+4. **Symbolized Stack Traces (Android)**
+
+ **_Useful Content:_** Contains symbolized stack traces of any Chrome or
+ Android crashes.
+
+ **_Where to find_:** These logs can be found from the buildbot status page.
+ The symbolized stack traces can be found under several steps. Click link
+ under _"symbolized breakpad crashes"_ step to see symbolized Chrome crashes.
+ Click link under _"stack tool with logcat dump"_ to see symbolized Android
+ crashes.
+
### Disabling Telemetry Tests
If the test is a telemetry test, its name will have a '.' in it, such as
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698