libdd-crashtracker 2.0.0

Detects program crashes and reports them to datadog backend.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# libdd-crashtracker

Crash detection and reporting library for Datadog APM.

## Overview

`libdd-crashtracker` detects program crashes and generates detailed crash reports with stack traces, metadata, and system information, then sends them to the Datadog backend.

## Features

- **Crash Detection**: Catches segfaults, uncaught exceptions, and abnormal terminations
- **Stack Traces**: Captures stack traces with symbol resolution
- **Signal Handling**: Handles Unix signals (SIGSEGV, SIGABRT, SIGBUS, etc.)
- **Windows Support**: SEH (Structured Exception Handling) on Windows
- **Metadata Collection**: Gathers crash context, environment, and tags
- **Async Reporting**: Non-blocking crash report transmission
- **Symbolication**: Symbol resolution using blazesym
- **Telemetry Integration**: Reports crashes via Datadog telemetry
- **Receiver Binary**: Standalone crash receiver process

## Architecture

The crashtracker uses a two-process architecture:
1. **Collector** (in-process): Detects crashes and collects information
2. **Receiver** (separate process): Processes crash data and sends reports

This ensures crash reports are sent even if the main process is corrupted.

## Features Flags

- `collector` (default): Enable in-process crash collection
- `receiver` (default): Enable crash receiver functionality  
- `collector_windows` (default): Windows crash collection
- `benchmarking`: Enable benchmark functionality

## Example Usage

```rust
use libdd_crashtracker;

// Initialize crash tracker
// let config = CrashTrackerConfig::new(...);
// crashtracker::init(config)?;

// Your application runs...
// Crashes are automatically detected and reported
```

## Platform Support

- **Linux**: Signal-based crash detection with blazesym symbolication
- **macOS**: Signal-based crash detection
- **Windows**: SEH-based crash detection

## Receiver Binary

The crate includes a `crashtracker-receiver` binary that runs as a separate process to ensure crash reports are sent even when the main process crashes.