stackexchange/bosun repository overview

This docker image contains all the dependencies needed for a bosun server. It is designed for test use and is not suitable for production use since data is not persisted. OpenTSDB and HBase can take 15 or more seconds to initialize after the image is running.

⁠Supported Tags and Release Notes:

• 0.5.0, latest Release Notes⁠
• 0.6.0-pre 1a9d75de9668515429859d8486554e7425ba45ca⁠

⁠Usage

$ docker run -d -p 4242:4242 -p 8070:8070 stackexchange/bosun

Bosun should now be running on port 8070 on your docker host (use -p 80:8070 if you want to serve via port 80 instead). OpenTSDB's interface can be accessed on port 4242. You can also use -p 5252:5252 to expose the internal tsdbrelay instance (for external counters), -p 9565:9565 to allow access to the ledis instance, or -p 16010:16010 to allow direct access to hbase.

⁠Reporting Data

In order to log data from other hosts in your environment, you will need to invoke scollector⁠ with the -h docker-server-addr:8070.

⁠Updating Bosun binary

To update the bosun binary without losing existing data, first enter the docker instance: docker exec -it <id> bash where is the id or name of the docker container running bosun. Determine which bosun release you want at https://github.com/bosun-monitor/bosun/releases⁠ and copy the URL to the linux-amd64 release. From inside the docker container, run:

$ apt-get update && apt-get install -y wget
$ wget -O /bosun/bosun <bosun-release-URL>
$ kill -HUP 1

Where is from the github releases page. The kill -HUP 1 restarts supervisord and all its processes.