Module: Sentry
- Extended by:
- Forwardable
- Defined in:
- lib/sentry/dsn.rb,
lib/sentry/hub.rb,
lib/sentry-ruby.rb,
lib/sentry/puma.rb,
lib/sentry/rake.rb,
lib/sentry/span.rb,
lib/sentry/event.rb,
lib/sentry/redis.rb,
lib/sentry/scope.rb,
lib/sentry/client.rb,
lib/sentry/logger.rb,
lib/sentry/baggage.rb,
lib/sentry/metrics.rb,
lib/sentry/session.rb,
lib/sentry/version.rb,
lib/sentry/envelope.rb,
lib/sentry/net/http.rb,
lib/sentry/profiler.rb,
lib/sentry/backtrace.rb,
lib/sentry/interface.rb,
lib/sentry/linecache.rb,
lib/sentry/transport.rb,
lib/sentry/breadcrumb.rb,
lib/sentry/exceptions.rb,
lib/sentry/integrable.rb,
lib/sentry/error_event.rb,
lib/sentry/test_helper.rb,
lib/sentry/transaction.rb,
lib/sentry/configuration.rb,
lib/sentry/check_in_event.rb,
lib/sentry/metrics/metric.rb,
lib/sentry/metrics/timing.rb,
lib/sentry/session_flusher.rb,
lib/sentry/release_detector.rb,
lib/sentry/background_worker.rb,
lib/sentry/breadcrumb_buffer.rb,
lib/sentry/transaction_event.rb,
lib/sentry/cron/configuration.rb,
lib/sentry/interfaces/request.rb,
lib/sentry/interfaces/threads.rb,
lib/sentry/metrics/aggregator.rb,
lib/sentry/metrics/set_metric.rb,
lib/sentry/cron/monitor_config.rb,
lib/sentry/propagation_context.rb,
lib/sentry/backpressure_monitor.rb,
lib/sentry/interfaces/exception.rb,
lib/sentry/interfaces/mechanism.rb,
lib/sentry/metrics/gauge_metric.rb,
lib/sentry/cron/monitor_schedule.rb,
lib/sentry/interfaces/stacktrace.rb,
lib/sentry/metrics/configuration.rb,
lib/sentry/cron/monitor_check_ins.rb,
lib/sentry/metrics/counter_metric.rb,
lib/sentry/rack/capture_exceptions.rb,
lib/sentry/transport/configuration.rb,
lib/sentry/breadcrumb/sentry_logger.rb,
lib/sentry/metrics/local_aggregator.rb,
lib/sentry/threaded_periodic_worker.rb,
lib/sentry/transport/http_transport.rb,
lib/sentry/transport/dummy_transport.rb,
lib/sentry/interfaces/single_exception.rb,
lib/sentry/metrics/distribution_metric.rb,
lib/sentry/interfaces/stacktrace_builder.rb,
lib/sentry/transport/spotlight_transport.rb
Defined Under Namespace
Modules: Cron, Integrable, Metrics, Net, Puma, Rack, Rake, TestHelper Classes: BackgroundWorker, BackpressureMonitor, Backtrace, Baggage, Breadcrumb, BreadcrumbBuffer, CheckInEvent, Client, Configuration, DSN, DummyTransport, Envelope, Error, ErrorEvent, Event, ExceptionInterface, ExternalError, HTTPTransport, Hub, Interface, LineCache, Logger, Mechanism, Profiler, PropagationContext, Redis, ReleaseDetector, RequestInterface, Scope, Session, SessionFlusher, SingleExceptionInterface, Span, SpotlightTransport, StacktraceBuilder, StacktraceInterface, ThreadedPeriodicWorker, ThreadsInterface, Transaction, TransactionEvent, Transport
Constant Summary collapse
- META =
{ "name" => "sentry.ruby", "version" => Sentry::VERSION }.freeze
- CAPTURED_SIGNATURE =
:@__sentry_captured
- LOGGER_PROGNAME =
"sentry".freeze
- SENTRY_TRACE_HEADER_NAME =
"sentry-trace".freeze
- BAGGAGE_HEADER_NAME =
"baggage".freeze
- THREAD_LOCAL =
:sentry_hub
- VERSION =
"5.18.2"
Class Attribute Summary collapse
- .background_worker ⇒ BackgroundWorker
-
.backpressure_monitor ⇒ Object
readonly
Returns the value of attribute backpressure_monitor.
-
.metrics_aggregator ⇒ Object
readonly
Returns the value of attribute metrics_aggregator.
-
.session_flusher ⇒ Object
readonly
Returns the value of attribute session_flusher.
Class Method Summary collapse
-
.add_breadcrumb(breadcrumb, **options) ⇒ Breadcrumb?
Takes an instance of Sentry::Breadcrumb and stores it to the current active scope.
-
.add_global_event_processor {|event, hint| ... } ⇒ void
Add a global event processor [Proc].
-
.capture_check_in(slug, status, **options) ⇒ String?
Captures a check-in and sends it to Sentry via the currently active hub.
-
.capture_event(event) ⇒ Event?
Takes an instance of Sentry::Event and dispatches it to the currently active hub.
-
.capture_exception(exception, **options) {|scope| ... } ⇒ Event?
Takes an exception and reports it to Sentry via the currently active hub.
-
.capture_message(message, **options) {|scope| ... } ⇒ Event?
Takes a message string and reports it to Sentry via the currently active hub.
-
.clone_hub_to_current_thread ⇒ void
Clones the main thread’s active hub and stores it to the current thread.
-
.close ⇒ void
Flushes pending events and cleans up SDK state.
- .configuration ⇒ Object
-
.configure_scope {|scope| ... } ⇒ void
Takes a block and yields the current active scope.
-
.continue_trace(env, **options) ⇒ Transaction?
Continue an incoming trace from a rack env like hash.
-
.csp_report_uri ⇒ String?
Returns an uri for security policy reporting that’s generated from the given DSN (To learn more about security policy reporting: docs.sentry.io/product/security-policy-reporting/).
-
.exception_captured?(exc) ⇒ Boolean
Checks if the exception object has been captured by the SDK.
-
.get_baggage ⇒ String?
Returns the baggage header for distributed tracing.
-
.get_current_client ⇒ Client?
Returns the current active client.
-
.get_current_hub ⇒ Hub
Returns the current active hub.
-
.get_current_scope ⇒ Scope?
Returns the current active scope.
-
.get_main_hub ⇒ Hub
Returns the main thread’s active hub.
-
.get_trace_propagation_headers ⇒ Hash?
Returns the a Hash containing sentry-trace and baggage.
-
.get_trace_propagation_meta ⇒ String
Returns the a Hash containing sentry-trace and baggage.
-
.get_traceparent ⇒ String?
Returns the traceparent (sentry-trace) header for distributed tracing.
-
.init {|config| ... } ⇒ void
Initializes the SDK with given configuration.
-
.initialized? ⇒ Boolean
Returns true if the SDK is initialized.
-
.integrations ⇒ Hash{String=>Hash}
Returns a hash that contains all the integrations that have been registered to the main SDK.
-
.last_event_id ⇒ String?
Returns the id of the lastly reported Sentry::Event.
-
.register_integration(name, version) ⇒ Object
Registers the SDK integration with its name and version.
- .send_event ⇒ Object
- .set_context ⇒ Object
- .set_extras ⇒ Object
- .set_tags ⇒ Object
- .set_user ⇒ Object
-
.start_transaction(**options) ⇒ Transaction?
Takes or initializes a new Sentry::Transaction and makes a sampling decision for it.
-
.with_child_span(**attributes) {|child_span| ... } ⇒ Object
Records the block’s execution as a child of the current span.
-
.with_exception_captured(**options, &block) ⇒ Object
Takes a block and evaluates it.
-
.with_scope {|scope| ... } ⇒ void
Takes a block and yields a temporary scope.
-
.with_session_tracking(&block) ⇒ void
Wrap a given block with session tracking.
Class Attribute Details
.background_worker ⇒ BackgroundWorker
72 73 74 |
# File 'lib/sentry-ruby.rb', line 72 def background_worker @background_worker end |
.backpressure_monitor ⇒ Object (readonly)
Returns the value of attribute backpressure_monitor.
80 81 82 |
# File 'lib/sentry-ruby.rb', line 80 def backpressure_monitor @backpressure_monitor end |
.metrics_aggregator ⇒ Object (readonly)
Returns the value of attribute metrics_aggregator.
84 85 86 |
# File 'lib/sentry-ruby.rb', line 84 def metrics_aggregator @metrics_aggregator end |
.session_flusher ⇒ Object (readonly)
Returns the value of attribute session_flusher.
76 77 78 |
# File 'lib/sentry-ruby.rb', line 76 def session_flusher @session_flusher end |
Class Method Details
.add_breadcrumb(breadcrumb, **options) ⇒ Breadcrumb?
Takes an instance of Sentry::Breadcrumb and stores it to the current active scope.
304 305 306 307 |
# File 'lib/sentry-ruby.rb', line 304 def (, **) return unless initialized? get_current_hub.(, **) end |
.add_global_event_processor {|event, hint| ... } ⇒ void
This method returns an undefined value.
Add a global event processor [Proc]. These run before scope event processors.
523 524 525 |
# File 'lib/sentry-ruby.rb', line 523 def add_global_event_processor(&block) Scope.add_global_event_processor(&block) end |
.capture_check_in(slug, status, **options) ⇒ String?
Captures a check-in and sends it to Sentry via the currently active hub.
463 464 465 466 |
# File 'lib/sentry-ruby.rb', line 463 def capture_check_in(slug, status, **) return unless initialized? get_current_hub.capture_check_in(slug, status, **) end |
.capture_event(event) ⇒ Event?
Takes an instance of Sentry::Event and dispatches it to the currently active hub.
447 448 449 450 |
# File 'lib/sentry-ruby.rb', line 447 def capture_event(event) return unless initialized? get_current_hub.capture_event(event) end |
.capture_exception(exception, **options) {|scope| ... } ⇒ Event?
Takes an exception and reports it to Sentry via the currently active hub.
411 412 413 414 |
# File 'lib/sentry-ruby.rb', line 411 def capture_exception(exception, **, &block) return unless initialized? get_current_hub.capture_exception(exception, **, &block) end |
.capture_message(message, **options) {|scope| ... } ⇒ Event?
Takes a message string and reports it to Sentry via the currently active hub.
439 440 441 442 |
# File 'lib/sentry-ruby.rb', line 439 def (, **, &block) return unless initialized? get_current_hub.(, **, &block) end |
.clone_hub_to_current_thread ⇒ void
This method returns an undefined value.
Clones the main thread’s active hub and stores it to the current thread.
341 342 343 344 |
# File 'lib/sentry-ruby.rb', line 341 def clone_hub_to_current_thread return unless initialized? Thread.current.thread_variable_set(THREAD_LOCAL, get_main_hub.clone) end |
.close ⇒ void
This method returns an undefined value.
Flushes pending events and cleans up SDK state. SDK will stop sending events and all top-level APIs will be no-ops after this.
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 |
# File 'lib/sentry-ruby.rb', line 242 def close if @session_flusher @session_flusher.flush @session_flusher.kill @session_flusher = nil end if @backpressure_monitor @backpressure_monitor.kill @backpressure_monitor = nil end if @metrics_aggregator @metrics_aggregator.flush(force: true) @metrics_aggregator.kill @metrics_aggregator = nil end if client = get_current_client client.flush if client.configuration.include_local_variables exception_locals_tp.disable end end @background_worker.shutdown @main_hub = nil Thread.current.thread_variable_set(THREAD_LOCAL, nil) end |
.configuration ⇒ Object
156 157 158 159 |
# File 'lib/sentry-ruby.rb', line 156 def configuration return unless initialized? get_current_client.configuration end |
.configure_scope {|scope| ... } ⇒ void
This method returns an undefined value.
Takes a block and yields the current active scope.
357 358 359 360 |
# File 'lib/sentry-ruby.rb', line 357 def configure_scope(&block) return unless initialized? get_current_hub.configure_scope(&block) end |
.continue_trace(env, **options) ⇒ Transaction?
Continue an incoming trace from a rack env like hash.
567 568 569 570 |
# File 'lib/sentry-ruby.rb', line 567 def continue_trace(env, **) return nil unless initialized? get_current_hub.continue_trace(env, **) end |
.csp_report_uri ⇒ String?
Returns an uri for security policy reporting that’s generated from the given DSN (To learn more about security policy reporting: docs.sentry.io/product/security-policy-reporting/)
It returns nil if
-
The SDK is not initialized yet.
-
The DSN is not provided or is invalid.
289 290 291 292 |
# File 'lib/sentry-ruby.rb', line 289 def csp_report_uri return unless initialized? configuration.csp_report_uri end |
.exception_captured?(exc) ⇒ Boolean
Checks if the exception object has been captured by the SDK.
505 506 507 508 |
# File 'lib/sentry-ruby.rb', line 505 def exception_captured?(exc) return false unless initialized? !!exc.instance_variable_get(CAPTURED_SIGNATURE) end |
.get_baggage ⇒ String?
Returns the baggage header for distributed tracing. Can be either from the currently active span or the propagation context.
540 541 542 543 |
# File 'lib/sentry-ruby.rb', line 540 def get_baggage return nil unless initialized? get_current_hub.get_baggage end |
.get_current_client ⇒ Client?
Returns the current active client.
325 326 327 328 |
# File 'lib/sentry-ruby.rb', line 325 def get_current_client return unless initialized? get_current_hub.current_client end |
.get_current_hub ⇒ Hub
Returns the current active hub. If the current thread doesn’t have an active hub, it will clone the main thread’s active hub, stores it in the current thread, and then returns it.
314 315 316 317 318 319 320 321 |
# File 'lib/sentry-ruby.rb', line 314 def get_current_hub # we need to assign a hub to the current thread if it doesn't have one yet # # ideally, we should do this proactively whenever a new thread is created # but it's impossible for the SDK to keep track every new thread # so we need to use this rather passive way to make sure the app doesn't crash Thread.current.thread_variable_get(THREAD_LOCAL) || clone_hub_to_current_thread end |
.get_current_scope ⇒ Scope?
Returns the current active scope.
333 334 335 336 |
# File 'lib/sentry-ruby.rb', line 333 def get_current_scope return unless initialized? get_current_hub.current_scope end |
.get_main_hub ⇒ Hub
Returns the main thread’s active hub.
297 298 299 |
# File 'lib/sentry-ruby.rb', line 297 def get_main_hub @main_hub end |
.get_trace_propagation_headers ⇒ Hash?
Returns the a Hash containing sentry-trace and baggage. Can be either from the currently active span or the propagation context.
549 550 551 552 |
# File 'lib/sentry-ruby.rb', line 549 def get_trace_propagation_headers return nil unless initialized? get_current_hub.get_trace_propagation_headers end |
.get_trace_propagation_meta ⇒ String
Returns the a Hash containing sentry-trace and baggage. Can be either from the currently active span or the propagation context.
558 559 560 561 |
# File 'lib/sentry-ruby.rb', line 558 def return '' unless initialized? get_current_hub. end |
.get_traceparent ⇒ String?
Returns the traceparent (sentry-trace) header for distributed tracing. Can be either from the currently active span or the propagation context.
531 532 533 534 |
# File 'lib/sentry-ruby.rb', line 531 def get_traceparent return nil unless initialized? get_current_hub.get_traceparent end |
.init {|config| ... } ⇒ void
This method returns an undefined value.
Initializes the SDK with given configuration.
220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 |
# File 'lib/sentry-ruby.rb', line 220 def init(&block) config = Configuration.new yield(config) if block_given? config.detect_release apply_patches(config) client = Client.new(config) scope = Scope.new(max_breadcrumbs: config.) hub = Hub.new(client, scope) Thread.current.thread_variable_set(THREAD_LOCAL, hub) @main_hub = hub @background_worker = Sentry::BackgroundWorker.new(config) @session_flusher = config.session_tracking? ? Sentry::SessionFlusher.new(config, client) : nil @backpressure_monitor = config.enable_backpressure_handling ? Sentry::BackpressureMonitor.new(config, client) : nil @metrics_aggregator = config.metrics.enabled ? Sentry::Metrics::Aggregator.new(config, client) : nil exception_locals_tp.enable if config.include_local_variables at_exit { close } end |
.initialized? ⇒ Boolean
Returns true if the SDK is initialized.
277 278 279 |
# File 'lib/sentry-ruby.rb', line 277 def initialized? !!get_main_hub end |
.integrations ⇒ Hash{String=>Hash}
Returns a hash that contains all the integrations that have been registered to the main SDK.
120 121 122 |
# File 'lib/sentry-ruby.rb', line 120 def integrations @integrations ||= {} end |
.last_event_id ⇒ String?
Returns the id of the lastly reported Sentry::Event.
497 498 499 500 |
# File 'lib/sentry-ruby.rb', line 497 def last_event_id return unless initialized? get_current_hub.last_event_id end |
.register_integration(name, version) ⇒ Object
Registers the SDK integration with its name and version.
128 129 130 131 132 133 134 135 136 137 138 139 |
# File 'lib/sentry-ruby.rb', line 128 def register_integration(name, version) if initialized? logger.warn(LOGGER_PROGNAME) do <<~MSG Integration '#{name}' is loaded after the SDK is initialized, which can cause unexpected behavior. Please make sure all integrations are loaded before SDK initialization. MSG end end = { name: "sentry.ruby.#{name}", version: version }.freeze integrations[name.to_s] = end |
.send_event ⇒ Object
163 164 165 166 |
# File 'lib/sentry-ruby.rb', line 163 def send_event(*args) return unless initialized? get_current_client.send_event(*args) end |
.set_context ⇒ Object
209 210 211 212 |
# File 'lib/sentry-ruby.rb', line 209 def set_context(*args) return unless initialized? get_current_scope.set_context(*args) end |
.set_extras ⇒ Object
195 196 197 198 |
# File 'lib/sentry-ruby.rb', line 195 def set_extras(*args) return unless initialized? get_current_scope.set_extras(*args) end |
.set_tags ⇒ Object
188 189 190 191 |
# File 'lib/sentry-ruby.rb', line 188 def (*args) return unless initialized? get_current_scope.(*args) end |
.set_user ⇒ Object
202 203 204 205 |
# File 'lib/sentry-ruby.rb', line 202 def set_user(*args) return unless initialized? get_current_scope.set_user(*args) end |
.start_transaction(**options) ⇒ Transaction?
Takes or initializes a new Sentry::Transaction and makes a sampling decision for it.
471 472 473 474 |
# File 'lib/sentry-ruby.rb', line 471 def start_transaction(**) return unless initialized? get_current_hub.start_transaction(**) end |
.with_child_span(**attributes) {|child_span| ... } ⇒ Object
Records the block’s execution as a child of the current span. If the current scope doesn’t have a span, the block would still be executed but the yield param will be nil.
489 490 491 492 |
# File 'lib/sentry-ruby.rb', line 489 def with_child_span(**attributes, &block) return yield(nil) unless Sentry.initialized? get_current_hub.with_child_span(**attributes, &block) end |
.with_exception_captured(**options, &block) ⇒ Object
Takes a block and evaluates it. If the block raised an exception, it reports the exception to Sentry and re-raises it. If the block ran without exception, it returns the evaluation result.
428 429 430 431 432 433 |
# File 'lib/sentry-ruby.rb', line 428 def with_exception_captured(**, &block) yield rescue Exception => e capture_exception(e, **) raise end |
.with_scope {|scope| ... } ⇒ void
This method returns an undefined value.
Takes a block and yields a temporary scope. The temporary scope will inherit all the attributes from the current active scope and replace it to be the active scope inside the block.
382 383 384 385 |
# File 'lib/sentry-ruby.rb', line 382 def with_scope(&block) return yield unless initialized? get_current_hub.with_scope(&block) end |
.with_session_tracking(&block) ⇒ void
This method returns an undefined value.
Wrap a given block with session tracking. Aggregate sessions in minutely buckets will be recorded around this block and flushed every minute.
402 403 404 405 |
# File 'lib/sentry-ruby.rb', line 402 def with_session_tracking(&block) return yield unless initialized? get_current_hub.with_session_tracking(&block) end |