Official Sentry SDK for Go

sentry-go provides a Sentry client implementation for the Go programming
language. This is the next generation of the Go SDK for Sentry,
intended to replace the raven-go package.

Looking for the old raven-go SDK documentation? See the Legacy client section here.
If you want to start using sentry-go instead, check out the migration guide.

Requirements

The only requirement is a Go compiler.

We verify this package against the 3 most recent releases of Go. Those are the
supported versions. The exact versions are defined in
GitHub workflow.

In addition, we run tests against the current master branch of the Go toolchain,
though support for this configuration is best-effort.

Installation

sentry-go can be installed like any other Go library through go get:

$ go get github.com/getsentry/sentry-go@latest

Check out the list of released versions.

Configuration

To use sentry-go, you’ll need to import the sentry-go package and initialize
it with your DSN and other options.

If not specified in the SDK initialization, the
DSN,
Release and
Environment
are read from the environment variables SENTRY_DSN, SENTRY_RELEASE and
SENTRY_ENVIRONMENT, respectively.

More on this in the Configuration section of the official Sentry Go SDK documentation.

Usage

The SDK supports reporting errors and tracking application performance.

To get started, have a look at one of our examples:

• Basic error instrumentation
• Error and tracing for HTTP servers

We also provide a complete API reference.

For more detailed information about how to get the most out of sentry-go,
check out the official documentation:

• Sentry Go SDK documentation
• Guides:
  • net/http
  • echo
  • fasthttp
  • fiber
  • gin
  • iris
  • logrus
  • negroni
  • slog
  • zerolog

Resources

• Bug Tracker
• GitHub Project
• 
• 
• 
• 
• 
• 

License

Licensed under
The MIT License, see
LICENSE.

Community

Join Sentry's #go channel on Discord to get
involved and help us improve the SDK!