4 releases (2 breaking)

0.3.1 Oct 19, 2024
0.3.0 Apr 12, 2024
0.2.0 Jul 1, 2023
0.1.0 Jun 21, 2022

#368 in Debugging

Download history 12/week @ 2024-08-21 7/week @ 2024-08-28 9/week @ 2024-09-04 23/week @ 2024-09-11 178/week @ 2024-09-18 540/week @ 2024-09-25 473/week @ 2024-10-02 500/week @ 2024-10-09 697/week @ 2024-10-16 663/week @ 2024-10-23 442/week @ 2024-10-30 546/week @ 2024-11-06 435/week @ 2024-11-13 403/week @ 2024-11-20 431/week @ 2024-11-27 207/week @ 2024-12-04

1,577 downloads per month

MIT/Apache

275KB
148 lines

sentry-tauri

A Sentry plugin for Tauri v1.

For the Tauri v2 plugin see tauri-plugin-sentry

It's perfectly reasonable to use Sentry's Rust and browser SDKs separately in a Tauri app. However, this plugin passes browser breadcrumbs and events through the Rust backend which has a number of advantages:

  • Browser events are enriched with Rust, OS and device context
    • Events from both Rust and browser will have the same context for filtering
  • Breadcrumbs are merged from both the Rust and browser SDKs
    • See what was happening in the Rust backend and the browser frontend at the time of the event

Installation

This example also shows usage of sentry_rust_minidump which allows you to capture minidumps for native crashes from a separate crash reporting process.

Add the required dependencies in Cargo.toml:

[dependencies]
sentry-tauri = "0.3"

sentry and sentry-rust-minidump are re-exported by sentry-tauri so you don't need to add them as dependencies.

fn main() {
    let client = sentry_tauri::sentry::init((
        "__YOUR_DSN__",
        sentry_tauri::sentry::ClientOptions {
            release: sentry_tauri::sentry::release_name!(),
            ..Default::default()
        },
    ));

    // Everything before here runs in both app and crash reporter processes
    let _guard = sentry_tauri::minidump::init(&client);
    // Everything after here runs in only the app process

    tauri::Builder::default()
        .plugin(sentry_tauri::plugin())
        .run(tauri::generate_context!())
        .expect("error while running tauri app");
}

The Plugin

  • Injects and initialises @sentry/browser in every web-view
  • Includes beforeSend and beforeBreadcrumb hooks that intercept events and breadcrumbs and passes them to the Rust SDK via the Tauri invoke API
  • Tauri + serde + existing Sentry Rust types = Deserialisation mostly Just Works™️

Example App

Clone this repository and install dependencies:

> yarn install

In examples/basic-app/src-tauri/src/main.rs replace the DSN with your DSN

Run in development mode:

> yarn example

Dependencies

~26–69MB
~1M SLoC