5.4.2

Bug Fixes

• Fix sentry_logger when SDK is closed from another thread #1860
  • Fixes #1858

5.4.1

Bug Fixes

• Fix missing spec.files in sentry-ruby.gemspec #1857
  • Fixes #1856

5.4.0

Features

• Expose :values in ExceptionInterface, so that it can be accessed in before_send under event.exception.values #1843

• Add top level Sentry.close API #1844

  • Cleans up SDK state and sets it to uninitialized
  • No-ops all SDK APIs and also disables the transport layer, so nothing will be sent to Sentry after closing the SDK

• Handle exception with large stacktrace without dropping entire item #1807

• Capture Rails runner's exceptions before exiting #1820

• Add Sentry.with_exception_captured helper #1814

  Usage:

  Sentry.with_exception_captured do
   1/1 #=> 1 will be returned
  end
  
  Sentry.with_exception_captured do
   1/0 #=> ZeroDivisionError will be reported and re-raised
  end

• Prepare for Rails 7.1's error reporter API change #1834

• Set sentry.error_event_id in request env if the middleware captures errors #1849

  If the SDK's Rack middleware captures an error, the reported event's id will be stored in the request env. For example:

  env["sentry.error_event_id"] #=> "507bd4c1a07e4355bb70bcd7afe8ab17"

  Users can display this information on the error page via a middleware as proposed in #1846

Bug Fixes

• Respect report_rescued_exceptions config #1847
  • Fixes #1840
• Rescue event's to JSON conversion error #1853
• Rescue ThreadError in SessionFlusher and stop creating threads if flusher is killed #1851
  • Fixes #1848

Refactoring

• Move envelope item processing/trimming logic to the Item class #1824
• Replace sentry-ruby-core with sentry-ruby as integration dependency #1825

Test Helpers

The SDK now provides a set of test helpers to help users setup and teardown Sentry related tests.

To get started:

require "sentry/test_helper"

# in minitest
class MyTest < Minitest::Test
  include Sentry::TestHelper
  # ...
end

# in RSpec
RSpec.configure do |config|
  config.include Sentry::TestHelper
  # ...
end

It's still an early attempt so please give us feedback in #1680.

5.3.1

Bug Fixes

• Don't require a DB connection, but release one if it is acquired #1812
  • Fixes #1808
• Sentry.with_child_span should check SDK's initialization state #1819
  • Fixes #1818

Miscellaneous

• Warn users about config.async's deprecation #1803

5.3.0

Features

• Add Sentry.with_child_span for easier span recording #1783

operation_result = Sentry.with_child_span(op: "my op") do |child_span|
  my_operation
end

# the "my op" span will be attached to the result of Sentry.get_current_scope.get_span
# which could be either the top-level transaction, or a span set by the user or other integrations

Bug Fixes

• Set last_event_id only for error events #1767
  • Fixes #1766
• Add config.rails.register_error_subscriber to control error reporter integration #1771
  • Fixes #1731, #1754, and #1765
  • Discussion thread and explanation on the decision
• Check if ActiveRecord connection exists before calling AR connection pool #1769
  • Fixes #1745
• Fix sentry-rails's tracing spans not nesting issue - #1784
  • Fixes #1723
• Update config.transport.proxy to allow String and URI values as previously supported by sentry-ruby versions <= 4.8 using Faraday
  • Fixes #1782
• Register SentryContextClientMiddleware on sidekiq workers #1774
• Add request env to sampling context when using sentry-rails #1792
  • Fixes #1791
• Fix net-http tracing's span nesting issue #1796

Refactoring

• Correct inaccurate event model relationships #1777

Miscellaneous

• Log message when shutting down/killing SDK managed components #1779

5.2.1

Bug Fixes

• Also check stringified breadcrumbs key when reducing payload size #1758
  • Fixes #1757
• Ignore internal Sidekiq::JobRetry::Skip exception #1763
  • Fixes #1731

Miscellaneous

• Warn user if any integration is required after SDK initialization #1759

5.2.0

Features

• Log Redis command arguments when sending PII is enabled #1726

• Add request env to sampling context #1749

  Example

  Sentry.init do |config|
    config.traces_sampler = lambda do |sampling_context|
      env = sampling_context[:env]
  
      if env["REQUEST_METHOD"] == "GET"
        0.01
      else
        0.1
      end
    end
  end

• Check envelope size before sending it #1747

  The SDK will now check if the envelope's event items are oversized before sending the envelope. It goes like this:

  1. If an event is oversized (200kb), the SDK will remove its breadcrumbs (which in our experience is the most common cause).
  2. If the event size now falls within the limit, it'll be sent.
  3. Otherwise, the event will be thrown away. The SDK will also log a debug message about the event's attributes size (in bytes) breakdown. For example,

  {event_id: 34, level: 7, timestamp: 22, environment: 13, server_name: 14, modules: 935, message: 5, user: 2, tags: 2, contexts: 820791, extra: 2, fingerprint: 2, platform: 6, sdk: 40, threads: 51690}
  

  This will help users report size-related issues in the future.

• Automatic session tracking #1715

  Example:

  

  The SDK now supports automatic session tracking / release health by default in Rack based applications.
  Aggregate statistics on successful / errored requests are collected and sent to the server every minute.
  To use this feature, make sure the SDK can detect your app's release. Or you have set it with:

  Sentry.init do |config|
    config.release = 'release-foo-v1'
  end

  To disable this feature, set config.auto_session_tracking to false.

Bug Fixes

• Require set library #1753
  • Fixes #1752

5.1.1

Bug Fixes

• Allow overwriting of context values #1724
  • Fixes #1722
• Avoid duplicated capturing on the same exception object #1738
  • Fixes #1731

Refactoring

• Encapsulate extension helpers #1725
• Move rate limiting logic to each item in envelope #1742

5.1.0

Features

• Support for Redis #1697

  New breadcrumb logger: redis_logger

  When you opt in to the new redis_logger breadcrumbs logger:

  config.breadcrumbs_logger = [:redis_logger]

  The SDK now records a new db.redis.command breadcrumb whenever the Redis client is called. Attributes sent are
  commands, an array of each Redis command called with the attributes command and key, as well as server, which is
  the Redis server hostname, port and db number.

  Redis command spans

  Calls to Redis are also wrapped in a span called db.redis.command and if tracing is enabled will be reported to
  Sentry. The span description will be the command and key. e.g. "SET mykey". For transactions this will be in
  the format MULTI, SET mykey, INCR counter, EXEC.

• Sync activerecord, actionview and net-http span names #1681

• Support serializing ActiveRecord job arguments in global id form #1688

• Register Sentry's ErrorSubscriber for Rails 7.0+ apps #1705

  Users can now use the unified interfaces: Rails.error.handle or Rails.error.record to capture exceptions. See ActiveSupport::ErrorReporter for more information about this feature.

Bug Fixes

• Avoid causing NoMethodError for Sentry.* calls when the SDK is not inited #1713
  • Fixes #1706
• Transaction#finish should ignore the parent's sampling decision #1716
  • Fixes #1712
• Skip authorization header when send_default_pii is false #1717
  • Fixes #1714

5.0.2

• Respect port info provided in user's DSN #1702
  • Fixes #1699
• Capture transaction tags #1701
• Fix report_after_job_retries's decision logic #1704
  • Fixes #1698