bun

Documentation

Overview

Package bun provides helper functions for tracing the github.com/uptrace/bun package (https://github.com/uptrace/bun).

Example

package main

import (
	"context"
	"database/sql"

	"github.com/uptrace/bun"
	"github.com/uptrace/bun/dialect/sqlitedialect"

	buntrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/uptrace/bun"

	_ "modernc.org/sqlite"
)

func main() {
	sqlite, err := sql.Open("sqlite", "file::memory:?cache=shared")
	if err != nil {
		panic(err)
	}
	db := bun.NewDB(sqlite, sqlitedialect.New())

	// Wrap the connection with the APM hook.
	buntrace.Wrap(db)
	var user struct {
		Name string
	}
	_ = db.NewSelect().Column("name").Table("users").Scan(context.Background(), &user)
}

Index

• func Wrap(db *bun.DB, opts ...Option)
• type Option
  • func WithService(name string) Option

Examples

• Package

Functions

func Wrap

func Wrap(db *bun.DB, opts ...Option)

Wrap augments the given DB with tracing.

Types

type Option

type Option = v2.Option

Option represents an option that can be used to create or wrap a client.

func WithService

func WithService(name string) Option

WithService sets the given service name for the client.