Struct Sentry 

pub struct Sentry {
    pub dsn: Option<SecretBox<ConfigSecret>>,
    pub environment: Option<Cow<'static, str>>,
    pub server_name: Option<Cow<'static, str>>,
    pub sample_rate: f32,
    pub traces_sample_rate: f32,
    pub inherit_sampling_decision: bool,
    pub debug: bool,
}

Sentry error tracking and performance monitoring configuration.

Configures integration with Sentry for error tracking, performance monitoring, and distributed tracing. Sentry is disabled by default and only enabled when a DSN is provided.

Used in: Config::sentry

Fields

dsn: Option<SecretBox<ConfigSecret>>

Sentry DSN (Data Source Name).

When set, enables Sentry error tracking and performance monitoring. When None, Sentry integration is completely disabled.

Default

None (Sentry disabled)

Environment Variable

OS__SENTRY__DSN

environment: Option<Cow<'static, str>>

Environment name for this deployment.

Used to distinguish events from different environments (e.g., “production”, “staging”, “development”). This appears in the Sentry UI and can be used for filtering.

Default

None

Environment Variable

OS__SENTRY__ENVIRONMENT

server_name: Option<Cow<'static, str>>

Server name or identifier.

Used to identify which server instance sent an event. Useful in multi-server deployments for tracking which instance encountered an error. Set to the hostname or pod name of the server.

Default

None

Environment Variable

OS__SENTRY__SERVER_NAME

sample_rate: f32

Error event sampling rate.

Controls what percentage of error events are sent to Sentry. A value of 1.0 sends all errors, while 0.5 sends 50% of errors, and 0.0 sends no errors.

Default

1.0 (send all errors)

Environment Variable

OS__SENTRY__SAMPLE_RATE

traces_sample_rate: f32

Performance trace sampling rate.

Controls what percentage of transactions (traces) are sent to Sentry for performance monitoring. A value of 1.0 sends all traces, while 0.01 sends 1% of traces.

Important: Performance traces can generate significant data volume in high-traffic systems. Start with a low rate (0.01-0.1) and adjust based on traffic and Sentry quota.

Default

0.01 (send 1% of traces)

Environment Variable

OS__SENTRY__TRACES_SAMPLE_RATE

inherit_sampling_decision: bool

Whether to inherit sampling decisions from incoming traces.

When true (default), if an incoming request contains a distributed tracing header with a sampling decision (e.g., from an upstream service), that decision is honored. When false, the local traces_sample_rate is always used instead.

When this is enabled, the calling service effectively controls the sampling decision for the entire trace. Set this to false if you want to have independent sampling control at the objectstore level.

Default

true

Environment Variable

OS__SENTRY__INHERIT_SAMPLING_DECISION

debug: bool

Enable Sentry SDK debug mode.

When enabled, the Sentry SDK will output debug information to stderr, which can be useful for troubleshooting Sentry integration issues. It is discouraged to enable this in production as it generates verbose logging.

Default

false

Environment Variable

OS__SENTRY__DEBUG

Implementations

impl Sentry

pub fn is_enabled(&self) -> bool

Returns whether Sentry integration is enabled.

Sentry is considered enabled if a DSN is configured.

Trait Implementations

impl Clone for Sentry

fn clone(&self) -> Sentry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Sentry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Sentry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Sentry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Sentry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.