README ¶
The purpose of these packages is to provide tracing on top of commonly used packages from the standard library as well as the community in a "plug-and-play" manner. This means that by simply importing the appropriate path, functions are exposed having the same signature as the original package. These functions return structures which embed the original return value, allowing them to be used as they normally would with tracing activated out of the box.
All of these libraries are supported by our APM product.
Usage
First, find the library which you'd like to integrate with. The naming convention for the integration packages is:
- If the package is from the standard library (eg.
database/sql
), it will be located at the same path. - If the package is hosted on Github (eg.
github.com/user/repo
), it will be located at the shorthand pathuser/repo
. - If the package is from anywhere else (eg.
google.golang.org/grpc
), it can be found under the full import path.
Each integration comes with thorough documentation and usage examples. A good overview can be seen on our godoc page.
Directories ¶
Path | Synopsis |
---|---|
aws
|
|
aws-sdk-go/aws
Package aws provides functions to trace aws/aws-sdk-go (https://github.com/aws/aws-sdk-go).
|
Package aws provides functions to trace aws/aws-sdk-go (https://github.com/aws/aws-sdk-go). |
bradfitz
|
|
gomemcache/memcache
Package memcache provides functions to trace the bradfitz/gomemcache package (https://github.com/bradfitz/gomemcache).
|
Package memcache provides functions to trace the bradfitz/gomemcache package (https://github.com/bradfitz/gomemcache). |
database
|
|
sql
Package sql provides functions to trace the database/sql package (https://golang.org/pkg/database/sql).
|
Package sql provides functions to trace the database/sql package (https://golang.org/pkg/database/sql). |
garyburd
|
|
redigo
Package redigo provides functions to trace the garyburd/redigo package (https://github.com/garyburd/redigo).
|
Package redigo provides functions to trace the garyburd/redigo package (https://github.com/garyburd/redigo). |
gin-gonic
|
|
gin
Package gin provides functions to trace the gin-gonic/gin package (https://github.com/gin-gonic/gin).
|
Package gin provides functions to trace the gin-gonic/gin package (https://github.com/gin-gonic/gin). |
globalsign
|
|
mgo
Package mgo provides functions and types which allow tracing of the MGO MongoDB client (https://github.com/globalsign/mgo)
|
Package mgo provides functions and types which allow tracing of the MGO MongoDB client (https://github.com/globalsign/mgo) |
go-redis
|
|
redis
Package redis provides tracing functions for tracing the go-redis/redis package (https://github.com/go-redis/redis).
|
Package redis provides tracing functions for tracing the go-redis/redis package (https://github.com/go-redis/redis). |
Package gocql provides functions to trace the gocql/gocql package (https://github.com/gocql/gocql).
|
Package gocql provides functions to trace the gocql/gocql package (https://github.com/gocql/gocql). |
google.golang.org
|
|
grpc
Package grpc is a generated protocol buffer package.
|
Package grpc is a generated protocol buffer package. |
grpc.v12
Package grpc is a generated protocol buffer package.
|
Package grpc is a generated protocol buffer package. |
gorilla
|
|
mux
Package mux provides tracing functions for tracing the gorilla/mux package (https://github.com/gorilla/mux).
|
Package mux provides tracing functions for tracing the gorilla/mux package (https://github.com/gorilla/mux). |
graph-gophers
|
|
graphql-go
Package graphql provides functions to trace the graph-gophers/graphql-go package (https://github.com/graph-gophers/graphql-go).
|
Package graphql provides functions to trace the graph-gophers/graphql-go package (https://github.com/graph-gophers/graphql-go). |
internal
|
|
jmoiron
|
|
sqlx
Package sqlx provides functions to trace the jmoiron/sqlx package (https://github.com/jmoiron/sqlx).
|
Package sqlx provides functions to trace the jmoiron/sqlx package (https://github.com/jmoiron/sqlx). |
julienschmidt
|
|
httprouter
Package httprouter provides functions to trace the julienschmidt/httprouter package (https://github.com/julienschmidt/httprouter).
|
Package httprouter provides functions to trace the julienschmidt/httprouter package (https://github.com/julienschmidt/httprouter). |
k8s.io
|
|
client-go/kubernetes
Package kubernetes provides functions to trace k8s.io/client-go (https://github.com/kubernetes/client-go).
|
Package kubernetes provides functions to trace k8s.io/client-go (https://github.com/kubernetes/client-go). |
net
|
|
http
Package http provides functions to trace the net/http package (https://golang.org/pkg/net/http).
|
Package http provides functions to trace the net/http package (https://golang.org/pkg/net/http). |
olivere
|
|
elastic
Package elastic provides functions to trace the gopkg.in/olivere/elastic.v{3,5} packages.
|
Package elastic provides functions to trace the gopkg.in/olivere/elastic.v{3,5} packages. |