How google/clusterfuzz works
ClusterFuzz is a distributed fuzzing platform: projects configure targets, worker bots run fuzzing engines, and the service processes findings into deduplicated crashes, triage and issue-tracker actions for users to review. The map also includes minimization, regression bisection, storage and performance statistics as documented capabilities. The excerpts and source index support selected implementation links; other capability links cite the README, so unsampled runtime wiring is not asserted.
Main entry points: fuzz_task.py Bot task runner · crash_analyzer.py Crash analysis · server.py Web application · engine.py Fuzzing engines
Components 15
Web management
- Web application
src/appengine/server.py - Authentication
src/appengine/libs/auth.py - Crash queries
src/appengine/handlers/crash_query.py
Fuzzing workers
- Bot task runner
src/clusterfuzz/_internal/bot/tasks/utasks/fuzz_task.py - Engine interface
src/clusterfuzz/fuzz/engine.py - Fuzzing engines
src/clusterfuzz/_internal/bot/fuzzers/libFuzzer/engine.py - Engine utilities
src/clusterfuzz/_internal/bot/fuzzers/engine_common.py
Crash analysis
- Testcase minimization
src/clusterfuzz/_internal/bot/minimizer/minimizer.py - Crash analysis
src/clusterfuzz/_internal/crash_analysis/crash_analyzer.py - Regression bisection
src/clusterfuzz/_internal/base/bisection.py - Issue management
src/clusterfuzz/_internal/issue_management/issue_filer.py
Platform services
- Crash records
src/clusterfuzz/_internal/datastore/data_types.py - Cloud storage
src/clusterfuzz/_internal/google_cloud_utils/storage.py - Fuzzer statistics
src/clusterfuzz/_internal/metrics/fuzzer_stats.py
Other components
- Fuzzing project
Connections 17
- Fuzzing project → Web application: manages fuzzing
- Web application → Authentication: authenticates users
src/appengine/server.py - Web application → Crash queries: routes requests
src/appengine/server.py - Crash queries → Crash records: queries records
src/appengine/handlers/crash_query.py - Bot task runner → Fuzzing engines: runs fuzzing
- Fuzzing engines → Engine interface: implements interface
src/clusterfuzz/_internal/bot/fuzzers/libFuzzer/engine.py - Fuzzing engines → Engine utilities: uses utilities
src/clusterfuzz/_internal/bot/fuzzers/libFuzzer/engine.py - Bot task runner → Crash records: records findings
- Bot task runner → Cloud storage: stores testcases
- Bot task runner → Fuzzer statistics: reports performance
- Bot task runner → Testcase minimization: minimizes testcases
- Bot task runner → Crash analysis: analyzes crashes
- Crash analysis → Crash records: deduplicates crashes
- Crash analysis → Regression bisection: finds regressions
- Crash analysis → Issue management: files bug reports
- Issue management → Fuzzing project: notifies maintainers
- Fuzzing project → Crash queries: reviews findings