wagoe.observability.errors.shell.adapters.sentry — com.wagoe/wagoe-observability 1.1.0-rc-1

Sentry error reporting adapter implementation.

This adapter integrates with Sentry (https://sentry.io) for production error tracking and monitoring. It implements all error reporting protocols to provide comprehensive exception tracking, context management, and alerting capabilities.

Features:

• Exception capture with stack traces
• Message-level reporting (debug, info, warning, error, fatal)
• Context management (user, tags, extra data, breadcrumbs)
• Environment and release tracking
• Sampling and filtering: :sample-rate, :filtering, rules via IErrorFilter
• Runtime environment, release, sample rate and on/off via IErrorReportingConfig

Configuration: The adapter requires a Sentry DSN (Data Source Name) and optionally accepts:

• Environment name (dev, staging, prod)
• Release identifier
• Sample rate (0.0 to 1.0)
• Debug mode flag
• Server name

Example: (def sentry-reporter (create-sentry-error-reporter {:dsn "https://[e-mail]/project-id" :environment "production" :release "1.0.0" :sample-rate 1.0 :debug false}))

create-sentry-error-context clj

(create-sentry-error-context config)

Create a Sentry error context manager instance. :max-breadcrumbs caps the breadcrumbs kept per thread (default 100).

create-sentry-error-filter clj

(create-sentry-error-filter config)

Create a Sentry error filter instance.

create-sentry-error-reporter clj

(create-sentry-error-reporter config)

Create a Sentry error reporter instance.

Config map:

• :dsn (required) - Sentry Data Source Name
• :environment, :release, :server-name, :debug - passed to the Sentry client
• :sample-rate - fraction of events sent, 0.0 to 1.0 (default 1.0)
• :enabled - false sends nothing
• :filtering - {:min-severity, :exclude-exceptions, :exclude-messages}
• :redact - PII redaction options (wagoe.core.utils.pii-redaction)

create-sentry-error-reporting-component clj

(create-sentry-error-reporting-component config)

Create a complete Sentry error reporting component that implements all protocols.

This is the recommended way to create Sentry error reporting for use with Integrant.

create-sentry-error-reporting-components clj

(create-sentry-error-reporting-components config)

Create a map of Sentry error reporting components for Integrant system configuration.

Returns a map with keys:

• :error-reporter - IErrorReporter implementation
• :error-context - IErrorContext implementation
• :error-filter - IErrorFilter implementation
• :error-config - IErrorReportingConfig implementation

create-sentry-error-reporting-config clj

(create-sentry-error-reporting-config config)

Create a Sentry error reporting configuration manager instance.