渤盛增设外部收藏家

Question

What is the procedure to define new external collectors in bosun using scollector.
Can we write python or shell scripts to collect data?

Answer 1

The documentation around this is not quite up to date. You can do it as described in http://godoc.org/bosun.org/cmd/scollector#hdr-External_Collectors , but we also support JSON output which is better.

Either way, you write something and put it in the external collectors directory, followed by a frequency directory, and then an executable script or binary. Something like:

<external_collectors_dir>/<freq_sec>/foo.sh.

If the directory frequency is zero 0, then the the script is expected to be continuously running, and you put a sleep inside the code (This is my preferred method for external collectors). The scripts outputs the telnet format, or the undocumented JSON format to stdout. Scollector picks it up, and queues that information for sending.

I created an issue to get this documented not long ago https://github.com/bosun-monitor/bosun/issues/1225. Until one of us gets around to that, here is the PR that added JSON https://github.com/bosun-monitor/bosun/commit/fced1642fd260bf6afa8cba169d84c60f2e23e92