trc provides in-process request tracing, an efficient alternative to logging. The package is heavily inspired by https://golang.org/x/net/trace, much gratitude to those authors.
Most users should import package eztrc, which offers an API designed for most common use cases.
Here's a quick-and-dirty usage example for a typical HTTP server.
func main() {
server := NewServer(...) // your HTTP server
traced := eztrc.Middleware(categorize)(server)
go func() { log.Fatal(http.ListenAndServe(":8080", traced)) }() // normal API
traces := eztrc.Handler()
go func() { log.Fatal(http.ListenAndServe(":8081", traces)) }() // traces UI
select {}
}
func categorize(r *http.Request) string {
return r.Method + " " + r.URL.Path // assuming a fixed and finite set of possible paths
}
func someFunction(ctx context.Context, ...) {
eztrc.Tracef(ctx, "this is a log statement")
// ...
}Traces can be viewed, queried, etc. through a web UI.
See the examples directory for more complete example applications.
The current API is experimental and unstable. Breaking changes are guaranteed. Use at your own risk.