2023-04-22 08:37:23 +00:00
|
|
|
|
<p align="center">
|
2024-06-15 13:58:47 +00:00
|
|
|
|
<a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
|
|
|
|
|
|
<picture>
|
|
|
|
|
|
<source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-white.png" media="(prefers-color-scheme: dark)" />
|
|
|
|
|
|
<source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" />
|
|
|
|
|
|
<img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" alt="Sentry" width="280">
|
|
|
|
|
|
</picture>
|
2023-04-22 08:37:23 +00:00
|
|
|
|
</a>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
# Official Sentry SDK for Go
|
|
|
|
|
|
|
|
|
|
|
|
[](https://github.com/getsentry/sentry-go/actions?query=workflow%3Ago-workflow)
|
|
|
|
|
|
[](https://goreportcard.com/report/github.com/getsentry/sentry-go)
|
|
|
|
|
|
[](https://discord.gg/Ww9hbqr)
|
|
|
|
|
|
[](https://pkg.go.dev/github.com/getsentry/sentry-go)
|
|
|
|
|
|
|
|
|
|
|
|
`sentry-go` provides a Sentry client implementation for the Go programming
|
2024-06-15 13:58:47 +00:00
|
|
|
|
language. This is the next generation of the Go SDK for [Sentry](https://sentry.io/),
|
2023-04-22 08:37:23 +00:00
|
|
|
|
intended to replace the `raven-go` package.
|
|
|
|
|
|
|
|
|
|
|
|
> Looking for the old `raven-go` SDK documentation? See the Legacy client section [here](https://docs.sentry.io/clients/go/).
|
2024-06-15 13:58:47 +00:00
|
|
|
|
> If you want to start using `sentry-go` instead, check out the [migration guide](https://docs.sentry.io/platforms/go/migration/).
|
2023-04-22 08:37:23 +00:00
|
|
|
|
|
|
|
|
|
|
## 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
|
2024-06-15 13:58:47 +00:00
|
|
|
|
[`GitHub workflow`](.github/workflows/test.yml).
|
2023-04-22 08:37:23 +00:00
|
|
|
|
|
|
|
|
|
|
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`:
|
|
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
|
$ go get github.com/getsentry/sentry-go@latest
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2024-06-15 13:58:47 +00:00
|
|
|
|
Check out the [list of released versions](https://github.com/getsentry/sentry-go/releases).
|
2023-04-22 08:37:23 +00:00
|
|
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
|
|
To use `sentry-go`, you’ll need to import the `sentry-go` package and initialize
|
|
|
|
|
|
it with your DSN and other [options](https://pkg.go.dev/github.com/getsentry/sentry-go#ClientOptions).
|
|
|
|
|
|
|
|
|
|
|
|
If not specified in the SDK initialization, the
|
|
|
|
|
|
[DSN](https://docs.sentry.io/product/sentry-basics/dsn-explainer/),
|
|
|
|
|
|
[Release](https://docs.sentry.io/product/releases/) and
|
|
|
|
|
|
[Environment](https://docs.sentry.io/product/sentry-basics/environments/)
|
|
|
|
|
|
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](https://docs.sentry.io/platforms/go/configuration/).
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
|
|
The SDK supports reporting errors and tracking application performance.
|
|
|
|
|
|
|
2024-06-15 13:58:47 +00:00
|
|
|
|
To get started, have a look at one of our [examples](_examples/):
|
|
|
|
|
|
- [Basic error instrumentation](_examples/basic/main.go)
|
|
|
|
|
|
- [Error and tracing for HTTP servers](_examples/http/main.go)
|
2023-04-22 08:37:23 +00:00
|
|
|
|
|
|
|
|
|
|
We also provide a [complete API reference](https://pkg.go.dev/github.com/getsentry/sentry-go).
|
|
|
|
|
|
|
|
|
|
|
|
For more detailed information about how to get the most out of `sentry-go`,
|
|
|
|
|
|
checkout the official documentation:
|
|
|
|
|
|
|
|
|
|
|
|
- [Sentry Go SDK documentation](https://docs.sentry.io/platforms/go/)
|
|
|
|
|
|
- Guides:
|
|
|
|
|
|
- [net/http](https://docs.sentry.io/platforms/go/guides/http/)
|
|
|
|
|
|
- [echo](https://docs.sentry.io/platforms/go/guides/echo/)
|
|
|
|
|
|
- [fasthttp](https://docs.sentry.io/platforms/go/guides/fasthttp/)
|
|
|
|
|
|
- [gin](https://docs.sentry.io/platforms/go/guides/gin/)
|
|
|
|
|
|
- [iris](https://docs.sentry.io/platforms/go/guides/iris/)
|
|
|
|
|
|
- [martini](https://docs.sentry.io/platforms/go/guides/martini/)
|
|
|
|
|
|
- [negroni](https://docs.sentry.io/platforms/go/guides/negroni/)
|
|
|
|
|
|
|
|
|
|
|
|
## Resources
|
|
|
|
|
|
|
|
|
|
|
|
- [Bug Tracker](https://github.com/getsentry/sentry-go/issues)
|
|
|
|
|
|
- [GitHub Project](https://github.com/getsentry/sentry-go)
|
|
|
|
|
|
- [](https://pkg.go.dev/github.com/getsentry/sentry-go)
|
|
|
|
|
|
- [](https://docs.sentry.io/platforms/go/)
|
2024-06-15 13:58:47 +00:00
|
|
|
|
- [](https://github.com/getsentry/sentry-go/discussions)
|
2023-04-22 08:37:23 +00:00
|
|
|
|
- [](https://discord.gg/Ww9hbqr)
|
|
|
|
|
|
- [](http://stackoverflow.com/questions/tagged/sentry)
|
|
|
|
|
|
- [](https://twitter.com/intent/follow?screen_name=getsentry)
|
|
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
|
|
Licensed under
|
2024-06-15 13:58:47 +00:00
|
|
|
|
[The MIT License](https://opensource.org/licenses/mit/), see
|
2023-04-22 08:37:23 +00:00
|
|
|
|
[`LICENSE`](LICENSE).
|
|
|
|
|
|
|
|
|
|
|
|
## Community
|
|
|
|
|
|
|
|
|
|
|
|
Join Sentry's [`#go` channel on Discord](https://discord.gg/Ww9hbqr) to get
|
|
|
|
|
|
involved and help us improve the SDK!
|
