Add IPVS input plugin (#4890)

plugins/inputs/ipvs/ipvs.go

@@ -0,0 +1,112 @@
+// +build linux
+
+package ipvs
+
+import (
+	"errors"
+	"fmt"
+	"math/bits"
+	"strconv"
+	"syscall"
+
+	"github.com/docker/libnetwork/ipvs"
+	"github.com/influxdata/telegraf"
+	"github.com/influxdata/telegraf/plugins/inputs"
+)
+
+// IPVS holds the state for this input plugin
+type IPVS struct {
+	handle *ipvs.Handle
+}
+
+// Description returns a description string
+func (i *IPVS) Description() string {
+	return "Collect virtual and real server stats from Linux IPVS"
+}
+
+// SampleConfig returns a sample configuration for this input plugin
+func (i *IPVS) SampleConfig() string {
+	return ``
+}
+
+// Gather gathers the stats
+func (i *IPVS) Gather(acc telegraf.Accumulator) error {
+	if i.handle == nil {
+		h, err := ipvs.New("") // TODO: make the namespace configurable
+		if err != nil {
+			return errors.New("Unable to open IPVS handle")
+		}
+		i.handle = h
+	}
+
+	services, err := i.handle.GetServices()
+	if err != nil {
+		i.handle.Close()
+		i.handle = nil // trigger a reopen on next call to gather
+		return errors.New("Failed to list IPVS services")
+	}
+	for _, s := range services {
+		fields := map[string]interface{}{
+			"connections": s.Stats.Connections,
+			"pkts_in":     s.Stats.PacketsIn,
+			"pkts_out":    s.Stats.PacketsOut,
+			"bytes_in":    s.Stats.BytesIn,
+			"bytes_out":   s.Stats.BytesOut,
+			"pps_in":      s.Stats.PPSIn,
+			"pps_out":     s.Stats.PPSOut,
+			"cps":         s.Stats.CPS,
+		}
+		acc.AddGauge("ipvs_virtual_server", fields, serviceTags(s))
+	}
+
+	return nil
+}
+
+// helper: given a Service, return tags that identify it
+func serviceTags(s *ipvs.Service) map[string]string {
+	ret := map[string]string{
+		"sched":          s.SchedName,
+		"netmask":        fmt.Sprintf("%d", bits.OnesCount32(s.Netmask)),
+		"address_family": addressFamilyToString(s.AddressFamily),
+	}
+	// Per the ipvsadm man page, a virtual service is defined "based on
+	// protocol/addr/port or firewall mark"
+	if s.FWMark > 0 {
+		ret["fwmark"] = strconv.Itoa(int(s.FWMark))
+	} else {
+		ret["protocol"] = protocolToString(s.Protocol)
+		ret["address"] = s.Address.String()
+		ret["port"] = strconv.Itoa(int(s.Port))
+	}
+	return ret
+}
+
+// helper: convert protocol uint16 to human readable string (if possible)
+func protocolToString(p uint16) string {
+	switch p {
+	case syscall.IPPROTO_TCP:
+		return "tcp"
+	case syscall.IPPROTO_UDP:
+		return "udp"
+	case syscall.IPPROTO_SCTP:
+		return "sctp"
+	default:
+		return fmt.Sprintf("%d", p)
+	}
+}
+
+// helper: convert addressFamily to a human readable string
+func addressFamilyToString(af uint16) string {
+	switch af {
+	case syscall.AF_INET:
+		return "inet"
+	case syscall.AF_INET6:
+		return "inet6"
+	default:
+		return fmt.Sprintf("%d", af)
+	}
+}
+
+func init() {
+	inputs.Add("ipvs", func() telegraf.Input { return &IPVS{} })
+}