ckb_sentry_core/
error.rs

1use std::error::Error;
2
3use crate::protocol::{Event, Exception, Level};
4use crate::types::Uuid;
5use crate::Hub;
6
7impl Hub {
8    /// Capture any `std::error::Error`.
9    ///
10    /// See the global [`capture_error`](fn.capture_error.html)
11    /// for more documentation.
12    #[allow(unused)]
13    pub fn capture_error<E: Error + ?Sized>(&self, error: &E) -> Uuid {
14        with_client_impl! {{
15            self.inner.with(|stack| {
16                let top = stack.top();
17                if top.client.is_some() {
18                    let event = event_from_error(error);
19                    self.capture_event(event)
20                } else {
21                    Uuid::nil()
22                }
23            })
24        }}
25    }
26}
27
28/// Captures a `std::error::Error`.
29///
30/// Creates an event from the given error and sends it to the current hub.
31/// A chain of errors will be resolved as well, and sorted oldest to newest, as
32/// described in the [sentry event payloads].
33///
34/// # Examples
35///
36/// ```
37/// let err = "NaN".parse::<usize>().unwrap_err();
38///
39/// # let events = sentry::test::with_captured_events(|| {
40/// sentry::capture_error(&err);
41/// # });
42/// # let captured_event = events.into_iter().next().unwrap();
43///
44/// assert_eq!(captured_event.exception.len(), 1);
45/// assert_eq!(&captured_event.exception[0].ty, "ParseIntError");
46/// ```
47///
48/// [sentry event payloads]: https://develop.sentry.dev/sdk/event-payloads/exception/
49#[allow(unused_variables)]
50pub fn capture_error<E: Error + ?Sized>(error: &E) -> Uuid {
51    Hub::with_active(|hub| hub.capture_error(error))
52}
53
54/// Create a sentry `Event` from a `std::error::Error`.
55///
56/// A chain of errors will be resolved as well, and sorted oldest to newest, as
57/// described in the [sentry event payloads].
58///
59/// # Examples
60///
61/// ```
62/// use thiserror::Error;
63///
64/// #[derive(Debug, Error)]
65/// #[error("inner")]
66/// struct InnerError;
67///
68/// #[derive(Debug, Error)]
69/// #[error("outer")]
70/// struct OuterError(#[from] InnerError);
71///
72/// let event = sentry::event_from_error(&OuterError(InnerError));
73/// assert_eq!(event.level, sentry::protocol::Level::Error);
74/// assert_eq!(event.exception.len(), 2);
75/// assert_eq!(&event.exception[0].ty, "InnerError");
76/// assert_eq!(event.exception[0].value, Some("inner".into()));
77/// assert_eq!(&event.exception[1].ty, "OuterError");
78/// assert_eq!(event.exception[1].value, Some("outer".into()));
79/// ```
80///
81/// [sentry event payloads]: https://develop.sentry.dev/sdk/event-payloads/exception/
82pub fn event_from_error<E: Error + ?Sized>(err: &E) -> Event<'static> {
83    let mut exceptions = vec![exception_from_error(err)];
84
85    let mut source = err.source();
86    while let Some(err) = source {
87        exceptions.push(exception_from_error(err));
88        source = err.source();
89    }
90
91    exceptions.reverse();
92    Event {
93        exception: exceptions.into(),
94        level: Level::Error,
95        ..Default::default()
96    }
97}
98
99fn exception_from_error<E: Error + ?Sized>(err: &E) -> Exception {
100    let dbg = format!("{:?}", err);
101    Exception {
102        ty: parse_type_from_debug(&dbg).to_owned(),
103        value: Some(err.to_string()),
104        ..Default::default()
105    }
106}
107
108/// Parse the types name from `Debug` output.
109///
110/// # Examples
111///
112/// ```
113/// use sentry::parse_type_from_debug;
114///
115/// let err = format!("{:?}", "NaN".parse::<usize>().unwrap_err());
116/// assert_eq!(parse_type_from_debug(&err), "ParseIntError");
117/// ```
118pub fn parse_type_from_debug(d: &str) -> &str {
119    d.split(&[' ', '(', '{', '\r', '\n'][..])
120        .next()
121        .unwrap()
122        .trim()
123}
124
125#[test]
126fn test_parse_type_from_debug() {
127    use parse_type_from_debug as parse;
128    #[derive(Debug)]
129    struct MyStruct;
130    let err = format!("{:?}", MyStruct);
131    assert_eq!(parse(&err), "MyStruct");
132
133    let err = format!("{:?}", "NaN".parse::<usize>().unwrap_err());
134    assert_eq!(parse(&err), "ParseIntError");
135
136    let err = format!(
137        "{:?}",
138        sentry_types::ParseDsnError::from(sentry_types::ParseProjectIdError::EmptyValue)
139    );
140    assert_eq!(parse(&err), "InvalidProjectId");
141
142    // `anyhow` is using extended debug formatting
143    let err = format!(
144        "{:#?}",
145        anyhow::Error::from("NaN".parse::<usize>().unwrap_err())
146    );
147    assert_eq!(parse(&err), "ParseIntError");
148
149    // `failure` is using normal debug formatting
150    let err = format!(
151        "{:?}",
152        failure::Error::from("NaN".parse::<usize>().unwrap_err())
153    );
154    assert_eq!(parse(&err), "ParseIntError");
155}
ckb_sentry_core/error.rs

ckb_sentry_core/
error.rs
