Skip to main content

Crash Symbolication - API Documentation

Enterprise Only
This feature is available exclusively in Countly Enterprise.

Overview

Crash Symbolication manages debug symbol files and symbolication workflows so crash stack traces can be transformed into readable output.

EndpointPurpose
List SymbolsList uploaded symbol documents
Add SymbolUpload symbol/mapping files (dashboard auth)
Upload Symbol (SDK)Upload symbol/mapping files with app_key
Edit SymbolUpdate metadata or replace files
Remove SymbolDelete symbol metadata and files
DownloadDownload uploaded symbol file
Get ReportFetch crash report data by ID
Run SymbolicationStart symbolication for a crash group
CallbackReceive symbolication result from server
List JobsList symbolication jobs/logs
Test Server ConnectionTest symbolication server reachability
Test API KeyTest symbolication server API key
Test Return ConnectionTest callback reachability from the symbolication server
Test EndpointsTest symbolication server add/check/get/ack endpoints

Database Collections / Storage

CollectionPurpose
countly.app_crashsymbols{appId}Symbol metadata per app
countly.symbolication_jobsSymbolication job lifecycle records
countly.app_crashgroups{appId}Crash group data updated after symbolication
countly.appsApp lookup for upload_symbol via app_key
countly_fs.crash_symbolsStored 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 server
  • custom_domain: Public Countly domain used for callback URLs
  • symbolication_test: UI helper flag for connection testing
  • max_symbol_file: Maximum number of JavaScript symbol files per upload (default: 10)

Workflows

Upload and manage symbols

  1. Upload symbol files with Add Symbol or Upload Symbol (SDK).
  2. Review files with List Symbols.
  3. Update or replace files with Edit Symbol.

Symbolicate a crash

  1. Fetch crash details with Get Report.
  2. Trigger symbolication with Run Symbolication.
  3. Track progress in List Jobs.
  4. 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.

Ⓔ Enterprise

This feature is part of Countly Enterprise.

Get Access:

Already a Customer? Use support portal if you have any questions


Last Updated

2026-02-16