7e385fc126
Official Sentry SDK for Go
sentry-go provides a Sentry client implementation for the Go programming
language. This is the next line of the Go SDK for Sentry,
intended to replace the raven-go package.
Looking for the old
raven-goSDK 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
Or, if you are already using Go Modules, you may specify a version number as well:
$ 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:
We also provide a complete API reference.
For more detailed information about how to get the most out of sentry-go,
checkout the official documentation:
Resources
License
Licensed under
The 2-Clause BSD License, see
LICENSE.
Community
Join Sentry's #go channel on Discord to get
involved and help us improve the SDK!