Tracer is a distributed tracing system, designed after Dapper. The instrumentation is compatible with the OpenTracing specification.
Tracer is currently in alpha state. It is in a working state, but very much unfinished, hardly tested and will contain bugs. You're welcome to test it, though!
The following steps will install Tracer, the Tracer UI and set up PostgreSQL to be used as a storage backend.
The following software is required:
- Go 1.6 or later for building Tracer
- PostgreSQL 9.5 or later for the storage engine
go get github.com/lygo/tracer/cmd/tracer
go get github.com/tracer/tracer-ui/cmd/tracer-ui
Create a PostgreSQL user and schema for Tracer and import the file
$GOPATH/src/github.com/lygo/tracer/storage/postgres/schema.sql.
Example:
$ createuser -s -P tracer // pass tracer
$ createdb testtracer -O tracer
$ psql testtracer tracer < $GOPATH/src/github.com/lygo/tracer/storage/postgres/schema.sql
Now you can start Tracer and its UI:
cp $GOPATH/src/github.com/lygo/tracer/cmd/tracer/example.conf .
# possibly edit example.conf
$GOPATH/bin/tracer -c example.conf &
$GOPATH/bin/tracer-ui -t $GOPATH/src/github.com/tracer/tracer-ui/zipkin-ui &
To insert a basic demo trace, run
go run $GOPATH/src/github.com/lygo/tracer/cmd/demo/demo.go
To view the UI, point your browser at http://localhost:9997/.
If you want to add instrumentation to your own code, check out OpenTracing and opentracing-go for the API. To instantiate a Tracer instance that logs to the server you just started, write something like this:
import "github.com/lygo/tracer"
...
storage, err := tracer.NewGRPC("localhost:9999", &tracer.GRPCOptions{
QueueSize: 1024,
FlushInterval: 1 * time.Second,
}, grpc.WithInsecure())
if err != nil {
log.Fatal(err)
}
t := tracer.NewTracer("frontend", storage, tracer.RandomID{})
This will create a tracer t that sends traces via gRPC to your server.
For more information on Tracer's instrumentation API check godoc.org.