Go JavaScript TypeScript HTML CSS Shell Python
Failed to load latest commit information.
_version cmd/bosun: Major Notification Overhaul (#2135) Sep 28, 2017
annotate try text Nov 17, 2017
build cmd/bosun: add support for elastic v5 Oct 19, 2017
cmd cmd/silence: use SSL to talk to bosun (#2278) Jul 11, 2018
collect cmd/bosun: add notification stats to /api/health (#2222) Feb 20, 2018
docs cmd/bosun: add percentiles to window func (#2254) May 18, 2018
graphite Allow to query graphite with Auth informations Sep 25, 2015
metadata cmd/scollector: add sync stats to redis collector (#2232) Mar 14, 2018
models cmd/bosun: Major Notification Overhaul (#2135) Sep 28, 2017
opentsdb fixes 2211 (#2212) May 4, 2018
plugins scollector: move static files from Puppet to the RPM Feb 4, 2015
slog slog: create a function that will recover panics and log them using s… Jan 10, 2017
snmp cmd/scollector: snmp lag monitoring and support non 1.3 oids May 16, 2017
util util: don't try to clean IP addresses. Also don't clean twice on Set (#… Sep 12, 2016
vendor vendor: govmomi vmware lib Mar 1, 2018
.gitignore meta: update .gitignore Mar 3, 2018
.travis.yml travis: remove slack notification / go 1.9 (#2203) Dec 14, 2017
AUTHORS Less original spelling of original Mar 12, 2015
CONTRIBUTING.md bosun: display UTC on timestamps Aug 25, 2017
LICENSE Move LICENSE to root directory Dec 4, 2014
README.md readme: document go and tsc versions Jun 28, 2018
build.scollector.sh build: make executable Jun 18, 2015
build.tsdbrelay.sh cmd/tsdbrelay: build file also had incorrect line endings Aug 18, 2016
mk_rpm_fpmdir.bosun-silence.txt Rename mk_rpm_fpmdir.silence.txt -> mk_rpm_fpmdir.bosun-silence.txt Jul 31, 2015
mk_rpm_fpmdir.scollector.txt scollector: move static files from Puppet to the RPM Feb 4, 2015
mk_rpm_fpmdir.tsdbrelay.txt Add fpm config for tsdbrelay. Apr 29, 2015



Bosun is a time series alerting framework developed by Stack Exchange. Scollector is a metric collection agent. Learn more at bosun.org.

Build Status


To build bosun and scollector, clone to $GOPATH/src/bosun.org:

$ go get bosun.org/cmd/bosun

bosun and scollector are found under the cmd directory. Run go build in the corresponding directories to build each project.



  • npm install typescript@<version> -g to be able to compile the ts files to js files. The current version of typescript to install will be in the .tavis.yml file in the root of this repo.
  • go get github.com/mjibson/esc to embed the static files. Run go generate in cmd/bosun when new static assets (like JS and CSS files) are added or changed.

The w.sh script will automatically build and run bosun in a loop. It will update itself when go/js/ts files change, and it runs in read-only mode, not sending any alerts.

$ cd cmd/bosun
$ ./w.sh

Go Version:

  • See the version number in .travis.yml in the root of this repo for the version of Go to use. Generally speaking, you should be able to use newer versions of Go if you are able to build Bosun without error.


  • Bosun includes miniprofiler in the web UI which can help with debugging. The key combination ALT-P will show miniprofiler. This allows you to see timings, as well as the raw queries sent to TSDBs.