graphite

Documentation

Index

• func Graphite(r metrics.Registry, d time.Duration, prefix string, addr *net.TCPAddr)
• func GraphiteOnce(c GraphiteConfig) error
• func GraphiteWithConfig(c GraphiteConfig)
• type GraphiteConfig

Examples

• Graphite
• GraphiteWithConfig

Functions

func Graphite

func Graphite(r metrics.Registry, d time.Duration, prefix string, addr *net.TCPAddr)

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.

Example

addr, _ := net.ResolveTCPAddr("net", ":2003")
go Graphite(metrics.DefaultRegistry, 1*time.Second, "some.prefix", addr)

func GraphiteOnce

func GraphiteOnce(c GraphiteConfig) error

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 GraphiteWithConfig

func GraphiteWithConfig(c GraphiteConfig)

GraphiteWithConfig is a blocking exporter function just like Graphite, but it takes a GraphiteConfig instead.

Example

addr, _ := net.ResolveTCPAddr("net", ":2003")
go GraphiteWithConfig(GraphiteConfig{
	Addr:          addr,
	Registry:      metrics.DefaultRegistry,
	FlushInterval: 1 * time.Second,
	DurationUnit:  time.Millisecond,
	Percentiles:   []float64{0.5, 0.75, 0.99, 0.999},
})

Types

type GraphiteConfig

type GraphiteConfig struct {
	Addr          *net.TCPAddr     // Network address to connect to
	Registry      metrics.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
}

GraphiteConfig provides a container with configuration parameters for the Graphite exporter