api/vendor/github.com/getsentry/sentry-go/MIGRATION.md

raven-go to sentry-go Migration Guide

Installation

raven-go

go get github.com/getsentry/raven-go

sentry-go

go get github.com/getsentry/sentry-go@v0.0.1

Configuration

raven-go

import "github.com/getsentry/raven-go"

func main() {
    raven.SetDSN("___PUBLIC_DSN___")
}

sentry-go

import (
    "fmt"
    "github.com/getsentry/sentry-go"
)

func main() {
    err := sentry.Init(sentry.ClientOptions{
        Dsn: "___PUBLIC_DSN___",
    })

    if err != nil {
        fmt.Printf("Sentry initialization failed: %v\n", err)
    }
}

raven-go

SetDSN()
SetDefaultLoggerName()
SetDebug()
SetEnvironment()
SetRelease()
SetSampleRate()
SetIgnoreErrors()
SetIncludePaths()

sentry-go

sentry.Init(sentry.ClientOptions{
    Dsn: "___PUBLIC_DSN___",
    DebugWriter: os.Stderr,
    Debug: true,
    Environment: "environment",
    Release: "release",
    SampleRate: 0.5,
    // IgnoreErrors: TBD,
    // IncludePaths: TBD
})

Available options: see Configuration section.

Providing SSL Certificates

By default, TLS uses the host's root CA set. If you don't have ca-certificates (which should be your go-to way of fixing the issue of missing certificates) and want to use gocertifi instead, you can provide pre-loaded cert files as one of the options to the sentry.Init call:

package main

import (
    "log"

    "github.com/certifi/gocertifi"
    "github.com/getsentry/sentry-go"
)

sentryClientOptions := sentry.ClientOptions{
    Dsn: "___PUBLIC_DSN___",
}

rootCAs, err := gocertifi.CACerts()
if err != nil {
    log.Println("Couldn't load CA Certificates: %v\n", err)
} else {
    sentryClientOptions.CaCerts = rootCAs
}

sentry.Init(sentryClientOptions)

Usage

Capturing Errors

raven-go

f, err := os.Open("filename.ext")
if err != nil {
    raven.CaptureError(err, nil)
}

sentry-go

f, err := os.Open("filename.ext")
if err != nil {
    sentry.CaptureException(err)
}

Capturing Panics

raven-go

raven.CapturePanic(func() {
    // do all of the scary things here
}, nil)

sentry-go

func() {
    defer sentry.Recover()
    // do all of the scary things here
}()

Capturing Messages

raven-go

raven.CaptureMessage("Something bad happened and I would like to know about that")

sentry-go

sentry.CaptureMessage("Something bad happened and I would like to know about that")

Capturing Events

raven-go

packet := &raven.Packet{
    Message: "Hand-crafted event",
    Extra: &raven.Extra{
        "runtime.Version": runtime.Version(),
        "runtime.NumCPU": runtime.NumCPU(),
    },
}
raven.Capture(packet)

sentry-go

event := &sentry.NewEvent()
event.Message = "Hand-crafted event"
event.Extra["runtime.Version"] = runtime.Version()
event.Extra["runtime.NumCPU"] = runtime.NumCPU()

sentry.CaptureEvent(event)

Additional Data

See Context section.

Event Sampling

raven-go

raven.SetSampleRate(0.25)

sentry-go

sentry.Init(sentry.ClientOptions{
    SampleRate: 0.25,
})

Awaiting the response (not recommended)

raven.CaptureMessageAndWait("Something bad happened and I would like to know about that")

sentry-go

sentry.CaptureMessage("Something bad happened and I would like to know about that")

if sentry.Flush(time.Second * 2) {
    // event delivered
} else {
    // timeout reached
}

Context

Per-event

raven-go

raven.CaptureError(err, map[string]string{"browser": "Firefox"}, &raven.Http{
    Method: "GET",
    URL: "https://example.com/raven-go"
})

sentry-go

sentry.WithScope(func(scope *sentry.Scope) {
    scope.SetTag("browser", "Firefox")
    scope.SetContext("Request", map[string]string{
        "Method": "GET",
        "URL": "https://example.com/raven-go",
    })
    sentry.CaptureException(err)
})

Globally

SetHttpContext

raven-go

raven.SetHttpContext(&raven.Http{
    Method: "GET",
    URL: "https://example.com/raven-go",
})

sentry-go

sentry.ConfigureScope(func(scope *sentry.Scope) {
    scope.SetContext("Request", map[string]string{
        "Method": "GET",
        "URL": "https://example.com/raven-go",
    })
})

SetTagsContext

raven-go

t := map[string]string{"day": "Friday", "sport": "Weightlifting"}
raven.SetTagsContext(map[string]string{"day": "Friday", "sport": "Weightlifting"})

sentry-go

sentry.ConfigureScope(func(scope *sentry.Scope) {
    scope.SetTags(map[string]string{"day": "Friday", "sport": "Weightlifting"})
})

SetUserContext

raven-go

raven.SetUserContext(&raven.User{
    ID: "1337",
    Username: "kamilogorek",
    Email: "kamil@sentry.io",
    IP: "127.0.0.1",
})

sentry-go

sentry.ConfigureScope(func(scope *sentry.Scope) {
    scope.SetUser(sentry.User{
        ID: "1337",
        Username: "kamilogorek",
        Email: "kamil@sentry.io",
        IPAddress: "127.0.0.1",
    })
})

ClearContext

raven-go

raven.ClearContext()

sentry-go

sentry.ConfigureScope(func(scope *sentry.Scope) {
    scope.Clear()
})

WrapWithExtra

raven-go

path := "filename.ext"
f, err := os.Open(path)
if err != nil {
    err = raven.WrapWithExtra(err, map[string]string{"path": path, "cwd": os.Getwd()}
    raven.CaptureError(err, nil)
}

sentry-go

// use `sentry.WithScope`, see "Context / Per-event Section"
path := "filename.ext"
f, err := os.Open(path)
if err != nil {
    sentry.WithScope(func(scope *sentry.Scope) {
        sentry.SetExtras(map[string]interface{}{"path": path, "cwd": os.Getwd())
        sentry.CaptureException(err)
    })
}

Integrations

net/http

raven-go

mux := http.NewServeMux
http.Handle("/", raven.Recoverer(mux))

// or

func root(w http.ResponseWriter, r *http.Request) {}
http.HandleFunc("/", raven.RecoveryHandler(root))

sentry-go

sentryHandler := sentryhttp.New(sentryhttp.Options{
    Repanic: false,
    WaitForDelivery: true,
})

mux := http.NewServeMux
http.Handle("/", sentryHandler.Handle(mux))

// or

func root(w http.ResponseWriter, r *http.Request) {}
http.HandleFunc("/", sentryHandler.HandleFunc(root))