Skip to content

Simplifies integration between the Rocket web framework and Sentry application monitoring system.

License

Notifications You must be signed in to change notification settings

ittorchbearer/rocket-sentry

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rocket Sentry

Crates.io version Documentation Tests status

rocket-sentry is a simple add-on for the Rocket web framework to simplify integration with the Sentry application monitoring system.

Or maybe...

"The Rocket Sentry is a static rocket-firing gun platform that is based on a Personality Construct and used in the Aperture Science Enrichment Center."

-- Half-Life wiki

Features

Currently rocket-sentry is very basic, it only enables the Rust panic handler. There is no integration with the Rocket request lifecycle. Pull requests welcome!

rocket-sentry can be configured via Rocket.toml (sentry_dsn=) or environment variable ROCKET_SENTRY_DSN.

Usage

To use this, add the dependency to your Cargo.toml, and add the fairing to your code:

use rocket_sentry::RocketSentry;

#[launch]
fn rocket() -> _ {
    rocket::build()
        .attach(RocketSentry::fairing())
        // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^   add this line
}

Then, the Sentry integration can be enabled by adding a sentry_dsn= value to the Rocket.toml file, for example:

[debug]
sentry_dsn = ""  # Disabled
[release]
sentry_dsn = "https://[email protected]/1111111"

Testing

The functionality can be tested with the examples/panic.rs example. Just change the Rocket.toml file and run it...

cargo run --example panic

Then try accessing this URL: http://localhost:8012/panic?msg=Is+it+time+to+panic+yet?

Release history

0.11.0 (2022-05-22)
  • Update Rust crate sentry to 0.26.0 (#42)
  • Update Rust crate rocket to 0.5.0-rc.2 (#39)
  • Update to use Rust 2021 edition (#41)
  • Fixed CI (#40)
  • Patch version updates
0.10.0 (2022-03-26)
  • Update Rust crate sentry to 0.25.0 (#31) & patch version updates
0.9.0 (2022-01-22)
  • Update Rust crate sentry to 0.24.1 (#28) & patch version updates
0.8.0 (2021-11-22)
  • Breaking change: Update to Rocket version 0.5-rc
    • To continue using Rocket 0.4.x, stay with rocket-sentry 0.7.0
    • Now using figment and serde for configuration (as required by Rocket)
    • The fairing no longer needs to have Response kind
    • RocketSentry now uses fairing kind Singleton
0.7.0 (2021-07-13)
  • Update sentry requirement from 0.22 to 0.23 (#20)
0.6.0 (2021-01-26)
  • Update sentry requirement from 0.20 to 0.22 (#16)
0.5.0 (2020-09-15)
  • Update sentry requirement from 0.19 to 0.20 (#13)
0.4.0 (2020-08-16)
  • Use log crate instead of println (#11). Thanks to Afonso Bordado, @afonso360
0.3.0 (2020-07-22)
  • Update sentry requirement from 0.18.0 to 0.19.0 (#9)
    • Sentry now automatically installs panic handler, dropped from rocket-sentry.
0.2.0 (2020-04-04)
  • Update sentry requirement from 0.12.0 to 0.18.0 (#1)
  • Add CI builds and basic test case (#3, #4)
  • Add documentation for Rust doc (#5)
0.1.0 (2019-11-25)
  • Initial release

About

Simplifies integration between the Rocket web framework and Sentry application monitoring system.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%