[fuzzer] Add docs about oss-fuzz dashboard and coverage report

Change-Id: I2ef9ee10a4e3b9c0c250b5ad2c6c99f9415b37db
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/441098
Reviewed-by: John Stiles <johnstiles@google.com>
This commit is contained in:
Kevin Lubick 2021-08-23 08:09:49 -04:00
parent 9ad7874d42
commit e312532442

View File

@ -48,6 +48,18 @@ set up for the [skcms repo](https://skia.googlesource.com/skcms/). The build pro
except instead of compiling using GN targets, the build.sh script compiles the fuzz executables
directly.
### OSS-Fuzz dashboard
<https://oss-fuzz.com/fuzzer-stats> is useful to see metrics on how our fuzzers are running. It
shows things like executions per second (higher is better), edge coverage percent per fuzzer,
what percent of fuzzing runs end in OOM/timeout/crash, the entire corpus of fuzzed inputs
(corpus_backup), etc. Contact aarya@ to get permission to view this dashboard if necessary.
[Per Fuzzer summary for all Skia fuzzers driven by libFuzzer](https://oss-fuzz.com/fuzzer-stats?group_by=by-fuzzer&date_start=2021-08-16&date_end=2021-08-22&fuzzer=libFuzzer&job=libfuzzer_asan_skia&project=skia)
[Five day summary of sksl2glsl driven by afl-fuzz](https://oss-fuzz.com/fuzzer-stats?group_by=by-day&date_start=2021-08-16&date_end=2021-08-22&fuzzer=afl_skia_sksl2glsl&job=afl_asan_skia&project=skia)
That dashboard also has a Coverage Report. Even though it appears the Coverage report is per fuzzer,
the reports always show the aggregated coverage from all fuzzers.
[Example coverage report from 2021 Aug 22](https://storage.googleapis.com/oss-fuzz-coverage/skia/reports/20210822/linux/report.html)
## See Also
- [Creating a binary fuzzer](https://docs.google.com/document/d/1QDX0o8yDdmhbjoudNsXc66iuRXRF5XNNqGnzDzX7c2I/edit)