go-web-analytics

A minimal analytics package to start collecting traffic data without client dependencies.

Logging incoming requests

import "github.com/JakeKalstad/go-web-analytics"

analytics := NewAnalytics(AnalyticsConfiguration{
			Name:                 "sanjuanpuertorico",
			Password:             os.Getenv("DASHBOARD_KEY"),
			GroupByURLSegment:    1,
			EntriesByURLSegment:  2,
			WriteScheduleSeconds: 30,
			Directory:            "logs",
			HashIPSecret:         os.Getenv("HASH_IP_KEY"),
			UserAgentBlackList:   DefaultUserAgentBlacklist,
		}, fmt.Println)


router.Use(func(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		analytics.InsertRequest(r)
		next.ServeHTTP(w, r)
	})
})

Dashboard

router.HandleFunc("/analytics", analytics.Dashboard).Methods("GET")

Configuration

type AnalyticsConfiguration struct {
    HashIPSecret         string
    GroupByURLSegment    int
    EntriesByURLSegment  int
    WriteScheduleSeconds int
    Name                 string
    Password             string
    Directory            string
    UserAgentBlackList   []string
}

HashIPSecret is a seed that if provided will be used to hash the IP so you don't have plaintext user IPs stored

GroupByURLSegment index in the URL split by / to group the results

EntriesByURLSegment index in the URL split by / to count as results

WriteScheduleSeconds how often we write to the file Name of file

Directory parent directory for the log files

Password for a dashboard if it's used /analytics?k=mypassword

UserAgentBlacklist entries to check if the user agent contains in order to avoid things like bots or automated tests