Get crash signature from Firefox crash ping
Project description
fx-crash-sig
Symbolicates crash pings and generates signatures.
Take crash ping stack traces and:
- Use Mozilla Symbolication Service symbolication to symbolicate crash ping stack traces
- Use socorro-siggen library to generate a crash signature
Project details:
- Code: https://github.com/mozilla/fx-crash-sig
- Issues: https://github.com/mozilla/fx-crash-sig/issues
- License: MPL v2
- Documentation: This README
Install (from PyPI)
pip install fx-crash-sig
Usage
import json
from fx_crash_sig.crash_processor import CrashProcessor
with open("crashping.json") as fp:
crash_ping = json.load(fp)
crash_processor = CrashProcessor()
signature_result = crash_processor.get_signature(crash_ping)
print(signature_result.signature)
Command line (using sample.json):
cat sample.json | fx-crash-sig
Minimal crash ping structure
The crash ping is documented here:
https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/data/crash-ping.html
These are the parts of the crash ping we use:
- normalized_os (optional)
- payload:
- metadata:
- async_shutdown_timeout (optional)
- ipc_channel_error (optional)
- oom_allocation_size (optional)
- moz_crash_reason (optional)
- stack_traces:
- crash_info:
- crashing_thread
- type
- modules[]
- debug_file
- debug_id
- filename
- base_addr
- threads[]
- frames[]
- ip
- module_index
- trust
For development
Build:
make build
Lint:
make lint
make reformat
Test:
make test
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
fx-crash-sig-1.0.1.tar.gz
(35.6 kB
view hashes)
Built Distribution
Close
Hashes for fx_crash_sig-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b58ec8765c30bf239fc104b192ec4b6e6cba72bbe83f4df7d409c86405862512 |
|
MD5 | c48a4cf54c6e857c166e551a6e110234 |
|
BLAKE2b-256 | 59074ed319be21b87618942b395cb1bfbeb3206599578582b635417da705a08a |