2018-05-22 23:15:08 +02:00
|
|
|
---
|
|
|
|
|
title: Sentry
|
|
|
|
|
menu: docs_patterns
|
|
|
|
|
weight: 1020
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Sentry Crash Reporting
|
|
|
|
|
|
2019-07-02 21:14:21 +02:00
|
|
|
{{% alert %}}
|
|
|
|
|
NOTE: Sentry currently does not work with `actix-web` 1.0. Please checkout this
|
|
|
|
|
[issue](https://github.com/getsentry/sentry-rust/issues/143) for more details.
|
|
|
|
|
{{% /alert %}}
|
|
|
|
|
|
2019-06-25 05:36:32 +02:00
|
|
|
[Sentry][sentrysite] is a crash reporting system that supports the failure crate which
|
|
|
|
|
is the base of the actix error reporting. With a middleware it's possible to
|
|
|
|
|
automatically report server errors to Sentry.
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
|
|
|
# Middleware
|
|
|
|
|
|
|
|
|
|
This middleware captures any error in the server error range (500 - 599)
|
|
|
|
|
and sends the attached error to sentry with its stacktrace.
|
|
|
|
|
|
2019-06-25 05:36:32 +02:00
|
|
|
To use the middleware the [sentry crate][sentrycrate] needs to be initialized and configured
|
|
|
|
|
and the [sentry-actix middleware][sentrymiddleware] needs to be added. Additionally it
|
|
|
|
|
makes sense to also register the panic handler to be informed about hard panics.
|
2018-05-22 23:15:08 +02:00
|
|
|
|
2019-06-18 08:42:43 +02:00
|
|
|
{{< include-example example="sentry" file="main.rs" section="middleware" >}}
|
2018-06-19 19:50:00 +02:00
|
|
|
|
|
|
|
|
# Reusing the Hub
|
|
|
|
|
|
|
|
|
|
If you use this integration the default sentry hub (`Hub::current()`) is typically the wrong one.
|
|
|
|
|
To get the request specific one you need to use the `ActixWebHubExt` trait:
|
|
|
|
|
|
2019-06-18 08:42:43 +02:00
|
|
|
{{< include-example example="sentry" file="main.rs" section="hub" >}}
|
2018-06-19 19:50:00 +02:00
|
|
|
|
|
|
|
|
The hub can also be made current for the duration of a call. Then `Hub::current()` works correctly
|
|
|
|
|
until the end of the `run` block.
|
|
|
|
|
|
2019-06-18 08:42:43 +02:00
|
|
|
{{< include-example example="sentry" file="main.rs" section="hub2" >}}
|
2019-06-25 05:36:32 +02:00
|
|
|
|
|
|
|
|
[sentrysite]: https://sentry.io/
|
|
|
|
|
[sentrycrate]: https://crates.io/crates/sentry
|
|
|
|
|
[sentrymiddleware]: https://crates.io/crates/sentry-actix
|
