Skip to content

Latest commit

 

History

History
 
 

app

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
static
static
 
 
templates
templates
 
 
.gcloudignore
.gcloudignore
 
 
README.md
README.md
 
 
access.go
access.go
 
 
access_test.go
access_test.go
 
 
admin.go
admin.go
 
 
api.go
api.go
 
 
api_test.go
api_test.go
 
 
app.yaml
app.yaml
 
 
app_test.go
app_test.go
 
 
asset_storage.go
asset_storage.go
 
 
asset_storage_test.go
asset_storage_test.go
 
 
bisect_test.go
bisect_test.go
 
 
cache.go
cache.go
 
 
cache_test.go
cache_test.go
 
 
commit_poll_test.go
commit_poll_test.go
 
 
config.go
config.go
 
 
coverage_batch.go
coverage_batch.go
 
 
cron.yaml
cron.yaml
 
 
dashboard.go
dashboard.go
 
 
discussion.go
discussion.go
 
 
discussion_test.go
discussion_test.go
 
 
email_test.go
email_test.go
 
 
entities_datastore.go
entities_datastore.go
 
 
entities_datastore_test.go
entities_datastore_test.go
 
 
entities_spanner.go
entities_spanner.go
 
 
fix_test.go
fix_test.go
 
 
getjson_test.go
getjson_test.go
 
 
graphs.go
graphs.go
 
 
graphs_test.go
graphs_test.go
 
 
handler.go
handler.go
 
 
index.yaml
index.yaml
 
 
jobs.go
jobs.go
 
 
jobs_test.go
jobs_test.go
 
 
kcidb.go
kcidb.go
 
 
label.go
label.go
 
 
linux_reporting.go
linux_reporting.go
 
 
linux_reporting_test.go
linux_reporting_test.go
 
 
main.go
main.go
 
 
main_test.go
main_test.go
 
 
notifications_test.go
notifications_test.go
 
 
public_json_api.go
public_json_api.go
 
 
reporting.go
reporting.go
 
 
reporting_email.go
reporting_email.go
 
 
reporting_external.go
reporting_external.go
 
 
reporting_lists.go
reporting_lists.go
 
 
reporting_test.go
reporting_test.go
 
 
repro_test.go
repro_test.go
 
 
stats.go
stats.go
 
 
subsystem.go
subsystem.go
 
 
subsystem_test.go
subsystem_test.go
 
 
tree.go
tree.go
 
 
tree_test.go
tree_test.go
 
 
util_test.go
util_test.go
 
 

README.md

Dashboard

dashboard is an App Engine app that powers syzbot. The main deployment is at syzkaller.appspot.com.

It is so-called Standard environment Go app.
To deploy and manage the app you need to install Google Cloud SDK.
For more details about App Engine refer to the docs.

Note: The app is not stable and is not officially supported. It's here only to power the main deployment.

Here is "big" picture of a possible setup: Overall picture of syzbot setup

Note: the vector source is here; to update: make a copy of the source, edit, download a png, update the png and include a link to your vector copy into the PR.

To deploy the app you need to add a .go file with production config. The config specifies kernel namespaces, bug reporting details, API keys, etc. Tests contain a config example, but it's not ready for production use.

The app also needs one or more syz-ci instances running elsewhere. The syz-ci instances do the actual fuzzing, bisection, patch testing, etc.

The app can be deployed by gcloud app deploy ./dashboard/app/app.yaml.

Next optional flags are available:

  1. "--no-promote" to test the app firs and migrate the traffic to it later.
  2. "--verbosity=info" to see what files are going to be deployed.

The app tests can be run with:

go test github.com/google/syzkaller/dashboard/app

During development it's handy to use -short flag to not run the longest tests.

If any of the tests fail, use -v flag to see log of what happens and -run flag to run a single test, e.g.:

go test -short -v -run=TestEmailReport github.com/google/syzkaller/dashboard/app