Struct Sentry 

pub struct Sentry;

Sends reports to Sentry or a Sentry-compatible service, as envelopes (the Sentry ingestion protocol).

Reads the DSN from the SENTRY_DSN secret (ocre secrets push SENTRY_DSN --file .prod.vars); without it, sends nothing. The optional SENTRY_RELEASE variable sets the release. Each report becomes one event: the error as the exception (type Report::class, value Report::message, mechanism Report::source and handled), the severity as level, the environment, request_id as a tag and the context (filtered like logs) as extra data. One subrequest per report.

Examples

use ocre::errors::{Options, Reporter, Sentry, Subscriber};

let reporter = Reporter::default();
reporter.report(&"boom", Options::new());
let report = &reporter.take()[0];
let dsn = |name: &str| (name == "SENTRY_DSN").then(|| "https://abc@o1.ingest.sentry.io/42".to_owned());
let delivery = Sentry.deliver(report, &dsn).unwrap();
assert_eq!(delivery.url, "https://o1.ingest.sentry.io/api/42/envelope/");
assert!(Sentry.deliver(report, &|_| None).is_none());

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 Copy for Sentry

impl Debug for Sentry

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

Formats the value using the given formatter.

impl Subscriber for Sentry

fn name(&self) -> &'static str

A short name, for Options::except and failure logs: sentry.

fn deliver( &self, report: &Report, vars: &dyn Fn(&str) -> Option<String>, ) -> Option<Delivery>

The request to send for report, if any.