go-collectd
Utilities for using collectd together with Go.
Synopsis
package main
import (
"context"
"time"
"collectd.org/api"
"collectd.org/exec"
)
func main() {
vl := api.ValueList{
Identifier: api.Identifier{
Host: exec.Hostname(),
Plugin: "golang",
Type: "gauge",
},
Time: time.Now(),
Interval: exec.Interval(),
Values: []api.Value{api.Gauge(42)},
}
exec.Putval.Write(context.Background(), &vl)
}
Description
This is a very simple package and very much a Work in Progress, so expect things to move around and be renamed a lot.
The repository is organized as follows:
- Package
collectd.org/api
declares data structures you may already know from the collectd source code itself, such asValueList
. - Package
collectd.org/exec
declares some utilities for writing binaries to be executed with the exec plugin. It provides some utilities (getting the hostname, e.g.) and an executor which you may use to easily schedule function calls. - Package
collectd.org/format
declares functions for formatting ValueLists in other format. Right now, onlyPUTVAL
is implemented. Eventually I plan to add parsers for some formats, such as the JSON export. - Package
collectd.org/network
implements collectd's binary network protocol. It offers client and server implementations, seenetwork.Client
andnetwork.ListenAndWrite()
for more details.
Install
To use this package in your own programs, simply use go get
to fetch the
packages you need, for example:
go get collectd.org/api
Author
Florian "octo" Forster <ff at octo.it>