the Chromium logo

The Chromium Projects

check_gpu_bots script

This is a script I hacked up during my wrangling shift. Hopefully this is only a temporary measure, and will be deprecated by the awesome work being done on the hackability CY and the sheriff-o-matic.


While wrangling, I found it cumbersome and time consuming to keep track of various waterfalls in a browser window with 10+ tabs. This script is meant to be a quick-and-dirty way to avoid having to stare at the waterfalls quite so much during a shift.

How to get it

Here is an older version of the script available for direct download for convenience, but there will be little continued support for it. The canonical version is now checked into the Chromium repository at src/gpu/tools/


The script, when run directly with no args, simply polls the waterfall's JSON API, gathers some information about (hopefully all of) the relevant GPU bots. It then prints out a summary of the offline or failing bots, and exits.

It can also be set up to repeat itself periodically, sort of like an auto-refresh.

The feature that made it most useful to me is that it can also optionally email you when there's something that needs to be looked into. By default, "needs to be looked into" is roughly defined as

As described above, it only sends an email once per bot, the first time something goes wrong. I did that to prevent getting spammed. Currently this can't be overridden with command-line arguments, but I intend to add the ability to override this.

NOTE that currently only gmail addresses are supported as the source email address, since the script hard-codes gmail's smtp server address. In addition, if you use a weak password, gmail may require you to explicitly allow "less secure apps".

Running the script on repeat, and having it set up to email you in case of a problem, takes away a good deal of staring at waterfalls. I recommend that you take a look at the waterfall from time to time, just because this script is not time-tested, and bugs aren't outside the realm of possibility.



Please report bugs to Feedback, features requests, and suggestions are also welcome.