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

#387 in Debugging

Download history 28/week @ 2024-07-29 22/week @ 2024-08-05 12/week @ 2024-08-12 14/week @ 2024-08-19 7/week @ 2024-08-26 8/week @ 2024-09-02 14/week @ 2024-09-09 29/week @ 2024-09-16 470/week @ 2024-09-23 536/week @ 2024-09-30 508/week @ 2024-10-07 616/week @ 2024-10-14 719/week @ 2024-10-21 432/week @ 2024-10-28 595/week @ 2024-11-04 418/week @ 2024-11-11

2,227 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–67MB
~1M SLoC