Crash Symbolication - API Documentation
Enterprise
This feature is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.
Overview
Crash Symbolication manages debug symbol files and symbolication workflows so crash stack traces can be transformed into readable output.
Quick Links
| Endpoint | Purpose |
|---|---|
| List Symbols | List uploaded symbol documents |
| Add Symbol | Upload symbol/mapping files (dashboard auth) |
| Upload Symbol (SDK) | Upload symbol/mapping files with app_key |
| Edit Symbol | Update metadata or replace files |
| Remove Symbol | Delete symbol metadata and files |
| Download | Download uploaded symbol file |
| Get Report | Fetch crash report data by ID |
| Run Symbolication | Start symbolication for a crash group |
| Callback | Receive symbolication result from server |
| List Jobs | List symbolication jobs/logs |
| Test Server Connection | Test symbolication server reachability |
| Test API Key | Test symbolication server API key |
| Test Return Connection | Test callback reachability from the symbolication server |
| Test Endpoints | Test symbolication server add/check/get/ack endpoints |
Database Collections / Storage
| Collection | Purpose |
|---|---|
countly.app_crashsymbols{appId} | Symbol metadata per app |
countly.symbolication_jobs | Symbolication job lifecycle records |
countly.app_crashgroups{appId} | Crash group data updated after symbolication |
countly.apps | App lookup for upload_symbol via app_key |
countly_fs.crash_symbols | Stored symbol files (*.cly_symbol paths) |
Configuration & Settings
Crash Symbolication uses crashes config scope values:
symbolication_server: External symbolication server URL (default:https://symbolication.count.ly)symbolication_key: API key for symbolication servercustom_domain: Public Countly domain used for callback URLssymbolication_test: UI helper flag for connection testingmax_symbol_file: Maximum number of JavaScript symbol files per upload (default:10)
Workflows
Upload and manage symbols
- Upload symbol files with Add Symbol or Upload Symbol (SDK).
- Review files with List Symbols.
- Update or replace files with Edit Symbol.
Symbolicate a crash
- Fetch crash details with Get Report.
- Trigger symbolication with Run Symbolication.
- Track progress in List Jobs.
- For remote-server flow, process callback in Callback.
Notes
- JavaScript stack traces are deobfuscated locally using source maps.
- Native and other non-JS symbolication may use local minidump tooling or external symbolication server flow, depending on crash type.