statsd

Documentation

Overview

Package statsd collects and reports telemetry from http handlers.

Index

• func Codes(statsd io.Writer, key string, interval time.Duration, next http.Handler) http.Handler
• func Durations(statsd io.Writer, key string, interval time.Duration, next http.Handler) http.Handler

Examples

• Codes

Functions

func Codes

func Codes(statsd io.Writer, key string, interval time.Duration, next http.Handler) http.Handler

Codes collects and reports the counts of response codes for the handler chain for all requests.

Example

package main

import (
	"github.com/streadway/handy/statsd"
	"io"
	"io/ioutil"
	"net"
	"net/http"
	"time"
)

func main() {
	var remote io.Writer

	remote, err := net.Dial("udp", "127.0.0.1:8126")
	if err != nil {
		// log error and continue
		remote = ioutil.Discard
	}

	http.ListenAndServe(":8080",
		statsd.Codes(remote, "doc.status", 10*time.Second,
			http.FileServer(http.Dir("/usr/share/doc"))))
}

func Durations

func Durations(statsd io.Writer, key string, interval time.Duration, next http.Handler) http.Handler

Durations writes a statsd formatted packet to the io.Writer with a list of durations recorded for each reporting interval or until a packet is filled.