Documentation
¶
Overview ¶
Package gorm provides helper functions for tracing the gorm.io/gorm package (https://github.com/go-gorm/gorm).
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Open ¶
Open opens a new (traced) database connection. The used driver must be formerly registered using (git.proto.group/protoobp/pobp-trace-go/contrib/database/sql).Register.
Example ¶
package main
import (
"log"
sqltrace "git.proto.group/protoobp/pobp-trace-go/contrib/database/sql"
gormtrace "git.proto.group/protoobp/pobp-trace-go/contrib/gorm.io/gorm.v1"
"github.com/jackc/pgx/v4/stdlib"
"gorm.io/driver/postgres"
"gorm.io/gorm"
)
type User struct {
gorm.Model
Name string
}
func main() {
// Register augments the provided driver with tracing, enabling it to be loaded by gormtrace.Open.
sqltrace.Register("pgx", &stdlib.Driver{}, sqltrace.WithServiceName("my-service"))
sqlDb, err := sqltrace.Open("pgx", "postgres://pqgotest:password@localhost/pqgotest?sslmode=disable")
if err != nil {
log.Fatal(err)
}
db, err := gormtrace.Open(postgres.New(postgres.Config{Conn: sqlDb}), &gorm.Config{})
if err != nil {
log.Fatal(err)
}
var user User
// All calls through gorm.DB are now traced.
db.Where("name = ?", "jinzhu").First(&user)
}
Types ¶
type Option ¶
type Option func(*config)
Option represents an option that can be passed to Register, Open or OpenDB.
func WithAnalytics ¶
WithAnalytics enables Trace Analytics for all started spans.
func WithAnalyticsRate ¶
WithAnalyticsRate sets the sampling rate for Trace Analytics events correlated to started spans.
func WithErrorCheck ¶
WithErrorCheck specifies a function fn which determines whether the passed error should be marked as an error. The fn is called whenever a gorm operation finishes
func WithServiceName ¶
WithServiceName sets the given service name when registering a driver, or opening a database connection.