| package metrics |
| |
| import ( |
| "bufio" |
| "fmt" |
| "log" |
| "net" |
| "strconv" |
| "strings" |
| "time" |
| ) |
| |
| // GraphiteConfig provides a container with configuration parameters for |
| // the Graphite exporter |
| type GraphiteConfig struct { |
| Addr *net.TCPAddr // Network address to connect to |
| Registry Registry // Registry to be exported |
| FlushInterval time.Duration // Flush interval |
| DurationUnit time.Duration // Time conversion unit for durations |
| Prefix string // Prefix to be prepended to metric names |
| Percentiles []float64 // Percentiles to export from timers and histograms |
| } |
| |
| // Graphite is a blocking exporter function which reports metrics in r |
| // to a graphite server located at addr, flushing them every d duration |
| // and prepending metric names with prefix. |
| func Graphite(r Registry, d time.Duration, prefix string, addr *net.TCPAddr) { |
| GraphiteWithConfig(GraphiteConfig{ |
| Addr: addr, |
| Registry: r, |
| FlushInterval: d, |
| DurationUnit: time.Nanosecond, |
| Prefix: prefix, |
| Percentiles: []float64{0.5, 0.75, 0.95, 0.99, 0.999}, |
| }) |
| } |
| |
| // GraphiteWithConfig is a blocking exporter function just like Graphite, |
| // but it takes a GraphiteConfig instead. |
| func GraphiteWithConfig(c GraphiteConfig) { |
| log.Printf("WARNING: This go-metrics client has been DEPRECATED! It has been moved to https://github.com/cyberdelia/go-metrics-graphite and will be removed from rcrowley/go-metrics on August 12th 2015") |
| for _ = range time.Tick(c.FlushInterval) { |
| if err := graphite(&c); nil != err { |
| log.Println(err) |
| } |
| } |
| } |
| |
| // GraphiteOnce performs a single submission to Graphite, returning a |
| // non-nil error on failed connections. This can be used in a loop |
| // similar to GraphiteWithConfig for custom error handling. |
| func GraphiteOnce(c GraphiteConfig) error { |
| log.Printf("WARNING: This go-metrics client has been DEPRECATED! It has been moved to https://github.com/cyberdelia/go-metrics-graphite and will be removed from rcrowley/go-metrics on August 12th 2015") |
| return graphite(&c) |
| } |
| |
| func graphite(c *GraphiteConfig) error { |
| now := time.Now().Unix() |
| du := float64(c.DurationUnit) |
| conn, err := net.DialTCP("tcp", nil, c.Addr) |
| if nil != err { |
| return err |
| } |
| defer conn.Close() |
| w := bufio.NewWriter(conn) |
| c.Registry.Each(func(name string, i interface{}) { |
| switch metric := i.(type) { |
| case Counter: |
| fmt.Fprintf(w, "%s.%s.count %d %d\n", c.Prefix, name, metric.Count(), now) |
| case Gauge: |
| fmt.Fprintf(w, "%s.%s.value %d %d\n", c.Prefix, name, metric.Value(), now) |
| case GaugeFloat64: |
| fmt.Fprintf(w, "%s.%s.value %f %d\n", c.Prefix, name, metric.Value(), now) |
| case Histogram: |
| h := metric.Snapshot() |
| ps := h.Percentiles(c.Percentiles) |
| fmt.Fprintf(w, "%s.%s.count %d %d\n", c.Prefix, name, h.Count(), now) |
| fmt.Fprintf(w, "%s.%s.min %d %d\n", c.Prefix, name, h.Min(), now) |
| fmt.Fprintf(w, "%s.%s.max %d %d\n", c.Prefix, name, h.Max(), now) |
| fmt.Fprintf(w, "%s.%s.mean %.2f %d\n", c.Prefix, name, h.Mean(), now) |
| fmt.Fprintf(w, "%s.%s.std-dev %.2f %d\n", c.Prefix, name, h.StdDev(), now) |
| for psIdx, psKey := range c.Percentiles { |
| key := strings.Replace(strconv.FormatFloat(psKey*100.0, 'f', -1, 64), ".", "", 1) |
| fmt.Fprintf(w, "%s.%s.%s-percentile %.2f %d\n", c.Prefix, name, key, ps[psIdx], now) |
| } |
| case Meter: |
| m := metric.Snapshot() |
| fmt.Fprintf(w, "%s.%s.count %d %d\n", c.Prefix, name, m.Count(), now) |
| fmt.Fprintf(w, "%s.%s.one-minute %.2f %d\n", c.Prefix, name, m.Rate1(), now) |
| fmt.Fprintf(w, "%s.%s.five-minute %.2f %d\n", c.Prefix, name, m.Rate5(), now) |
| fmt.Fprintf(w, "%s.%s.fifteen-minute %.2f %d\n", c.Prefix, name, m.Rate15(), now) |
| fmt.Fprintf(w, "%s.%s.mean %.2f %d\n", c.Prefix, name, m.RateMean(), now) |
| case Timer: |
| t := metric.Snapshot() |
| ps := t.Percentiles(c.Percentiles) |
| fmt.Fprintf(w, "%s.%s.count %d %d\n", c.Prefix, name, t.Count(), now) |
| fmt.Fprintf(w, "%s.%s.min %d %d\n", c.Prefix, name, t.Min()/int64(du), now) |
| fmt.Fprintf(w, "%s.%s.max %d %d\n", c.Prefix, name, t.Max()/int64(du), now) |
| fmt.Fprintf(w, "%s.%s.mean %.2f %d\n", c.Prefix, name, t.Mean()/du, now) |
| fmt.Fprintf(w, "%s.%s.std-dev %.2f %d\n", c.Prefix, name, t.StdDev()/du, now) |
| for psIdx, psKey := range c.Percentiles { |
| key := strings.Replace(strconv.FormatFloat(psKey*100.0, 'f', -1, 64), ".", "", 1) |
| fmt.Fprintf(w, "%s.%s.%s-percentile %.2f %d\n", c.Prefix, name, key, ps[psIdx], now) |
| } |
| fmt.Fprintf(w, "%s.%s.one-minute %.2f %d\n", c.Prefix, name, t.Rate1(), now) |
| fmt.Fprintf(w, "%s.%s.five-minute %.2f %d\n", c.Prefix, name, t.Rate5(), now) |
| fmt.Fprintf(w, "%s.%s.fifteen-minute %.2f %d\n", c.Prefix, name, t.Rate15(), now) |
| fmt.Fprintf(w, "%s.%s.mean-rate %.2f %d\n", c.Prefix, name, t.RateMean(), now) |
| } |
| w.Flush() |
| }) |
| return nil |
| } |