v0.24.1: 0.24.1

Compare Source

The Sentry SDK team is happy to announce the immediate availability of Sentry Go SDK v0.24.1.

Bug fixes

• Prevent a panic in sentryotel.flushSpanProcessor() ((#​711))
• Prevent a panic when setting the SDK identifier (#​715)

v0.24.0: 0.24.0

Compare Source

The Sentry SDK team is happy to announce the immediate availability of Sentry Go SDK v0.24.0.

Deprecations

• sentry.Version to be removed in 0.25.0. Use sentry.SDKVersion instead.
• sentry.SDKIdentifier to be removed in 0.25.0. Use Client.GetSDKIdentifier() instead.
• dsn.RequestHeaders() to be removed after 0.25.0, but no earlier than December 1, 2023. Requests to the /envelope endpoint are authenticated using the DSN in the envelope header.

Features

• Run a single instance of the profiler instead of multiple ones for each Go routine (#​655)
• Use the route path as the transaction names when using the Gin integration (#​675)
• Set the SDK name accordingly when a framework integration is used (#​694)
• Read release information (VCS revision) from debug.ReadBuildInfo (#​704)

Bug fixes

• [otel] Fix incorrect usage of attributes.Value.AsString (#​684)
• Fix trace function name parsing in profiler on go1.21+ (#​695)

Misc

• Test against Go 1.21 (#​695)
• Make tests more robust (#​698, #​699, #​700, #​702)

v0.23.0: 0.23.0

Compare Source

The Sentry SDK team is happy to announce the immediate availability of Sentry Go SDK v0.23.0.

Features

• Initial support for Cron Monitoring (#​661)

  This is how the basic usage of the feature looks like:

  // 🟡 Notify Sentry your job is running:
  checkinId := sentry.CaptureCheckIn(
    &sentry.CheckIn{
      MonitorSlug: "<monitor-slug>",
      Status:      sentry.CheckInStatusInProgress,
    },
    nil,
  )
  
  // Execute your scheduled task here...
  
  // 🟢 Notify Sentry your job has completed successfully:
  sentry.CaptureCheckIn(
    &sentry.CheckIn{
      ID:          *checkinId,
      MonitorSlug: "<monitor-slug>",
      Status:      sentry.CheckInStatusOK,
    },
    nil,
  )

  A full example of using Crons Monitoring is available here.

  More documentation on configuring and using Crons can be found here.

• Add support for Event Attachments (#​670)

  It's now possible to add file/binary payloads to Sentry events:

  sentry.ConfigureScope(func(scope *sentry.Scope) {
    scope.AddAttachment(&Attachment{
      Filename:    "report.html",
      ContentType: "text/html",
      Payload:     []byte("<h1>Look, HTML</h1>"),
    })
  })

  The attachment will then be accessible on the Issue Details page.

• Add sampling decision to trace envelope header (#​666)

• Expose SpanFromContext function (#​672)

Bug fixes

• Make Span.Finish a no-op when the span is already finished (#​660)

v0.22.0: 0.22.0

Compare Source

The Sentry SDK team is happy to announce the immediate availability of Sentry Go SDK v0.22.0.

This release contains initial profiling support, as well as a few bug fixes and improvements.

Features

• Initial (alpha) support for profiling (#​626)

  Profiling is disabled by default. To enable it, configure both TracesSampleRate and ProfilesSampleRate when initializing the SDK:

  err := sentry.Init(sentry.ClientOptions{
    Dsn: "__DSN__",
    EnableTracing: true,
    TracesSampleRate: 1.0,
    // The sampling rate for profiling is relative to TracesSampleRate. In this case, we'll capture profiles for 100% of transactions.
    ProfilesSampleRate: 1.0,
  })

  More documentation on profiling and current limitations can be found here.

• Add transactions/tracing support go the Gin integration (#​644)

Bug fixes

• Always set a valid source on transactions (#​637)
• Clone scope.Context in more places to avoid panics on concurrent reads and writes (#​638)
  • Fixes #​570
• Fix frames recognized as not being in-app still showing as in-app (#​647)

v0.21.0: 0.21.0

Compare Source

The Sentry SDK team is happy to announce the immediate availability of Sentry Go SDK v0.21.0.

Note: this release includes one breaking change and some deprecations, which are listed below.

Breaking Changes

This change does not apply if you use https://sentry.io

• Remove support for the /store endpoint (#​631)
  • This change requires a self-hosted version of Sentry 20.6.0 or higher. If you are using a version of self-hosted Sentry (aka on-premise) older than 20.6.0, then you will need to upgrade your instance.

Features

• Rename four span option functions (#​611, #​624)
  • TransctionSource -> WithTransactionSource
  • SpanSampled -> WithSpanSampled
  • OpName -> WithOpName
  • TransactionName -> WithTransactionName
  • Old functions TransctionSource, SpanSampled, OpName, and TransactionName are still available but are now deprecated and will be removed in a future release.
• Make client.EventFromMessage and client.EventFromException methods public (#​607)
• Add client.SetException method (#​607)
  • This allows to set or add errors to an existing Event.

Bug Fixes

• Protect from panics while doing concurrent reads/writes to Span data fields (#​609)
• [otel] Improve detection of Sentry-related spans (#​632, #​636)
  • Fixes cases when HTTP spans containing requests to Sentry were captured by Sentry (#​627)

Misc

• Drop testing in (legacy) GOPATH mode (#​618)
• Remove outdated documentation from https://pkg.go.dev/github.com/getsentry/sentry-go (#​623)