kstenerud/KSCrash
KSCrash
KSCrash is a C++ crash reporting library and remote reporting framework designed to capture application crashes and signals. It functions as an async-safe crash reporter that traps exceptions and deadlocks to ensure reports are generated during critical failures.
The system includes a memory diagnostics tool for tracking memory pressure and identifying zombie objects to diagnose memory-related terminations. It also features a symbol demangling tool that converts mangled C++ and Swift function names into human-readable strings for stack trace analysis.
The project provides comprehensive monitoring and observability through application crash capture, main thread deadlock detection, and system signal monitoring. Captured data is processed through a pipeline that generates structured JSON reports, which are then routed and transmitted to remote servers via a sink-based delivery system. Local storage management is used to persist reports and application metadata on the device until delivery is confirmed.
Features
- Crash Reporters - Captures and transmits application crashes and stack traces from mobile devices to remote servers for analysis.
- Main Thread Responsiveness Monitoring - Monitors the primary execution thread's responsiveness and triggers a report if a deadlock is detected.
- Symbol Demanglers - Includes a tool to convert mangled C++ and Swift function names into human-readable strings for stack trace analysis.
- System Signal Handling - Provides async-safe mechanisms to intercept operating system signals and record crashes without triggering secondary failures.
- Application Stability Monitoring - Monitors main thread deadlocks and system signals to diagnose why an application becomes unresponsive or terminates.
- Application Crash Logging - Traps exceptions, system signals, and main thread deadlocks to record software failure data for stability troubleshooting.
- Zombie Object Tracking - Records deallocated object addresses to detect dangling pointers and memory corruption during runtime.
- Memory Corruption Debugging - Identifies memory corruption and zombie objects in C++ applications to resolve unstable behavior.
- Memory Region Introspection - Extracts contents of memory regions referenced by the stack or registers to provide deep context in crash reports.
- Memory Safety Diagnostics - Tracks memory pressure and identifies zombie objects to diagnose memory-related application terminations.
- Zombie Object Tracking - Records addresses of deallocated objects to identify dangling pointers and memory corruption.
- POSIX Signal Monitoring - Detects when the application receives specific system termination signals such as SIGTERM to generate a report.
- Exception Traceback Capture - Captures and logs full stack traces automatically when specific exceptions occur during application runtime.
- Remote Error Handling Utilities - Implements utilities for routing error reports to backends while managing local storage on the device.
- Crash Log Symbolication - Translates memory addresses and mangled symbols into human-readable function names for easier crash debugging.
- Crash History Managers - Provides a dedicated store to retrieve, identify, and delete stored crash reports.
- JSON Report Generation - Writes application crash data into a structured JSON format for easier analysis and remote distribution.
- Local Report Persistence - Persists captured crash reports and application metadata to the local device filesystem to survive restarts.
- Report Delivery Routing - Implements a delivery pipeline for routing crash reports to remote backends via various transmission channels.
- Crash Report Filters - Provides a low-level interface to inspect, modify, or omit crash data before reports are stored or transmitted.
- Manual Crash Event Recording - Allows developers to manually record custom crash events and stack traces, including those from embedded scripting languages.
- Report Routing Sinks - Directs captured crash reports to custom destinations using a flexible, sink-based delivery system.
- System Memory Monitors - Tracks memory footprint and pressure to diagnose out-of-memory conditions and memory-related terminations.
- Testing & Debugging - Crash reporting and analysis tool.
- Debugging and Inspection - Comprehensive crash reporting library for iOS.
- أدوات التطوير - Capture and report application crashes with server configuration.
