|
5 | 5 | <br /> |
6 | 6 | </p> |
7 | 7 |
|
8 | | -# Sentry Rust |
| 8 | +# Sentry SDK for Rust |
9 | 9 |
|
10 | 10 | [](https://travis-ci.com/getsentry/sentry-rust) |
11 | | -[](https://crates.io/crates/sentry) |
12 | | - |
13 | | -This workspace contains various crates that provide support for logging events |
14 | | -and errors / panics to the [Sentry](https://sentry.io/) error logging service. |
15 | | - |
16 | | -- [sentry](./sentry) The main `sentry` crate aimed at application users that |
17 | | - want to log events to sentry. |
18 | | -- [sentry-actix](./sentry-actix) An integration for the `actix-web (0.7)` |
19 | | - framework. |
20 | | -- [sentry-core](./sentry-core) The core of `sentry`, which can be used to |
21 | | - instrument code, and to write integrations that generate events or hook into |
22 | | - event processing. |
23 | | -- [sentry-types](./sentry-types) Contains types for the Sentry v7 protocol as |
24 | | - well as other common types. |
25 | | - |
26 | | -**Note**: Until the _1.0_ release, the crates in this repository are considered work in |
27 | | -progress and do not follow semver semantics. Between minor releases, we might |
28 | | -occasionally introduce breaking changes while we are exploring the best API and |
29 | | -adding new features. |
| 11 | + |
| 12 | +This workspace contains various crates that provide support for logging events and errors / panics to the |
| 13 | +[Sentry](https://sentry.io/) error logging service. |
| 14 | + |
| 15 | +- [sentry](./sentry) [](https://crates.io/crates/sentry) |
| 16 | + [](https://docs.rs/sentry) |
| 17 | + |
| 18 | + The main `sentry` crate aimed at application users that want to log events to sentry. |
| 19 | + |
| 20 | +- [sentry-actix](./sentry-actix) |
| 21 | + [](https://crates.io/crates/sentry-actix) |
| 22 | + [](https://docs.rs/sentry-actix) |
| 23 | + |
| 24 | + An integration for the `actix-web (0.7)` framework. |
| 25 | + |
| 26 | +- [sentry-anyhow](./sentry-anyhow) |
| 27 | + [](https://crates.io/crates/sentry-anyhow) |
| 28 | + [](https://docs.rs/sentry-anyhow) |
| 29 | + |
| 30 | + An integration for `anyhow` errors. |
| 31 | + |
| 32 | +- [sentry-backtrace](./sentry-backtrace) |
| 33 | + [](https://crates.io/crates/sentry-backtrace) |
| 34 | + [](https://docs.rs/sentry-backtrace) |
| 35 | + |
| 36 | + A utility crate that creates and processes backtraces. |
| 37 | + |
| 38 | +- [sentry-contexts](./sentry-contexts) |
| 39 | + [](https://crates.io/crates/sentry-contexts) |
| 40 | + [](https://docs.rs/sentry-contexts) |
| 41 | + |
| 42 | + An integration that provides `os`, `device` and `rust` contexts. |
| 43 | + |
| 44 | +- [sentry-core](./sentry-core) |
| 45 | + [](https://crates.io/crates/sentry-core) |
| 46 | + [](https://docs.rs/sentry-core) |
| 47 | + |
| 48 | + The core of `sentry`, which can be used to instrument code, and to write integrations that generate events or hook |
| 49 | + into event processing. |
| 50 | + |
| 51 | +- [sentry-debug-images](./sentry-debug-images) |
| 52 | + [](https://crates.io/crates/sentry-debug-images) |
| 53 | + [](https://docs.rs/sentry-debug-images) |
| 54 | + |
| 55 | + An integration that adds a list of loaded libraries to events. |
| 56 | + |
| 57 | +- [sentry-error-chain](./sentry-error-chain) |
| 58 | + [](https://crates.io/crates/sentry-error-chain) |
| 59 | + [](https://docs.rs/sentry-error-chain) |
| 60 | + |
| 61 | + An integration for the `error-chain` crate. This is _deprecated_ and may be completely removed in the future. |
| 62 | + |
| 63 | +- [sentry-failure](./sentry-failure) |
| 64 | + [](https://crates.io/crates/sentry-failure) |
| 65 | + [](https://docs.rs/sentry-failure) |
| 66 | + |
| 67 | + An integration for the `failure` crate. |
| 68 | + |
| 69 | +- [sentry-log](./sentry-log) |
| 70 | + [](https://crates.io/crates/sentry-log) |
| 71 | + [](https://docs.rs/sentry-log) |
| 72 | + |
| 73 | + An integration for the `log` and `env_logger` crate. |
| 74 | + |
| 75 | +- [sentry-panic](./sentry-panic) |
| 76 | + [](https://crates.io/crates/sentry-panic) |
| 77 | + [](https://docs.rs/sentry-panic) |
| 78 | + |
| 79 | + An integration for capturing and logging panics. |
| 80 | + |
| 81 | +- [sentry-slog](./sentry-slog) |
| 82 | + [](https://crates.io/crates/sentry-slog) |
| 83 | + [](https://docs.rs/sentry-slog) |
| 84 | + |
| 85 | + An integration for the `slog` crate. |
| 86 | + |
| 87 | +- [sentry-types](./sentry-types) |
| 88 | + [](https://crates.io/crates/sentry-types) |
| 89 | + [](https://docs.rs/sentry-types) |
| 90 | + |
| 91 | + Contains types for the Sentry v7 protocol as well as other common types. |
| 92 | + |
| 93 | +**Note**: Until the _1.0_ release, the crates in this repository are considered work in progress and do not follow |
| 94 | +semver semantics. Between minor releases, we might occasionally introduce breaking changes while we are exploring the |
| 95 | +best API and adding new features. |
30 | 96 |
|
31 | 97 | ## Requirements |
32 | 98 |
|
33 | | -We currently only verify this crate against a recent version of Sentry hosted on |
34 | | -[sentry.io](https://sentry.io/) but it should work with on-prem Sentry versions |
35 | | -8.20 and later. |
| 99 | +We currently only verify this crate against a recent version of Sentry hosted on [sentry.io](https://sentry.io/) but it |
| 100 | +should work with on-prem Sentry versions 8.20 and later. |
36 | 101 |
|
37 | 102 | Additionally, the lowest Rust version we target is _1.40.0_. |
38 | 103 |
|
39 | 104 | ## Resources |
40 | 105 |
|
41 | | -- [crates.io](https://crates.io/crates/sentry) |
42 | | -- [Documentation](https://getsentry.github.io/sentry-rust) |
43 | | -- [Bug Tracker](https://github.com/getsentry/sentry-rust/issues) |
44 | 106 | - [Discord](https://discord.gg/ez5KZN7) server for project discussions. |
45 | 107 | - Follow [@getsentry](https://twitter.com/getsentry) on Twitter for updates |
0 commit comments