Rust SDK

Use the Rust SDK when you want native error capture from a Rust service without wiring an OpenTelemetry exporter first.

Install

cargo add squasher

Initialize

main.rs

use std::time::Duration;

fn main() {
    squasher::init(squasher::Config {
        api_key: std::env::var("SQUASHER_API_KEY").unwrap_or_default(),
        project_id: std::env::var("SQUASHER_PROJECT_ID").unwrap_or_default(),
        environment: std::env::var("SQUASHER_ENV").ok(),
        release: std::env::var("GIT_SHA").ok(),
        sampling: squasher::SamplingConfig {
            success_rate: 0.1,
            ..Default::default()
        },
        ..Default::default()
    });

    squasher::install_panic_hook();

    squasher::capture_message("service started", squasher::Level::Info);
    squasher::flush(Duration::from_secs(5));
}

Empty api_key or project_id values put the SDK in disabled mode, so local development can keep the same initialization path without sending events. The SDK batches buffered events and automatically splits multi-event request bodies at 1 MB. An individual event larger than that remains a single request rather than being silently dropped. Sampling is deterministic and outcome-aware. Errors and slow operations stay at full fidelity by default. Rate-based decisions with the same trace and outcome class are identical; a user or release allowlist can override the rate. Separate outcome rates can keep a failure after routine work from the same trace was dropped. Use Collector tail sampling when every span in a trace must receive one decision. If a sampled operation has measurements, the SDK still sends the measurements.

Capture errors

use std::time::Duration;

fn read_config() {
    if let Err(error) = std::fs::read_to_string("missing.toml") {
        squasher::capture_error(&error, None);
        squasher::flush(Duration::from_secs(5));
    }
}

Add context

use std::collections::HashMap;

squasher::set_tag("service", "checkout");
squasher::set_tags(HashMap::from([
    ("environment".to_string(), "production".to_string()),
]));

squasher::set_user(Some(squasher::User {
    id: Some("user_123".to_string()),
    email: None,
    username: None,
    ip_address: None,
}));

Trace identifiers

The SDK can mint Squasher-compatible trace and span ids for custom telemetry:

let trace_id = squasher::create_trace_id();
let span_id = squasher::create_span_id();

Agent handoff

Install the Squasher Rust SDK. Initialize once from SQUASHER_API_KEY and SQUASHER_PROJECT_ID, install the panic hook, add safe tags/user context, flush before process exit, and verify with one captured message or error.

Get Started

SDKs

Integrations

Migrations

Cloud Log Drains

Features

API Reference

Install

Initialize

Capture errors

Add context

Trace identifiers

Agent handoff

​Install

​Initialize

​Capture errors

​Add context

​Trace identifiers

​Agent handoff

​Related docs

Install

Initialize

Capture errors

Add context

Trace identifiers

Agent handoff

Related docs