Skip to content
Native Symbolication as a Service
Rust Python Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode docs: Improve public docs (#97) Jul 7, 2019
artwork meta: Trim logo Apr 11, 2019
bin deploy: Script for adding a Sentry release May 9, 2019
docs feat(config): Default cache_dir to /data on Docker (#110) Aug 12, 2019
scripts fix: Fix bump-version script Jul 5, 2019
src ref: Remove useless bind_hubs (#114) Aug 20, 2019
symsorter build: Bump symbolic and synchronize symsorter dependencies Aug 12, 2019
tests ref: Upgrade to Actix 1 (#106) Aug 12, 2019
.craft.yml build: Add basic craft conf Jul 5, 2019
.dockerignore fix: Version detection via git_version (#25) Apr 16, 2019
.flake8 test: Add basic test Mar 4, 2019
.freight.yml deploy: Add a healthcheck for Freight Mar 29, 2019
.gitignore doc: Add design docs (#86) Jun 26, 2019
.travis.yml docs: Improve public docs (#97) Jul 7, 2019
CHANGELOG.md build: Add basic craft conf Jul 5, 2019
Cargo.lock build: Update to actix-http stable Aug 14, 2019
Cargo.toml build: Update to actix-http stable Aug 14, 2019
Dockerfile ref(docker): Various improvements on Docker image (#111) Aug 14, 2019
LICENSE ref: Touch files when reading, add license Mar 8, 2019
Makefile build: Switch to bash in make Jul 10, 2019
README.md docs: Improve public docs (#97) Jul 7, 2019
build.rs fix: Avoid panics and improve error handling (#109) Aug 13, 2019
cloudbuild.yaml build: Use 8 core machine on Cloud Build Aug 19, 2019
docker-entrypoint.sh ref(docker): Various improvements on Docker image (#111) Aug 14, 2019
mkdocs.yml fix: Move icon to other location Jul 10, 2019
pytest.ini feat: Finish macho, elf and breakpad paths for symstore Mar 8, 2019

README.md


A symbolication service for native stacktraces and minidumps with symbol server support. It's a flexible frontend for parts of the symbolic library.

Documentation

Compiling

Symbolicator is currently not distributed as binary which means you need to compile it yourself. It's written in Rust and thus requires a recent rust installation. We generally track latest stable.

To compile run this:

cargo build --release

The resulting binary ends up in target/release/symbolicator.

Usage with Sentry

The following requires a recent git version of Sentry.

While Symbolicator aims to not be tied to Sentry's usecases, Sentry has a hard dependency on Symbolicator to process native stacktraces. To get it running for local development:

  • In your ~/.sentry/sentry.conf.py:

    # Whitelist Symbolicator's request IP to fetch debug symbols from Sentry.
    INTERNAL_SYSTEM_IPS = ["127.0.0.1"]
  • In your ~/.sentry/config.yml:

    symbolicator.enabled: true

Then run sentry devservices up to download and start Symbolicator.

You can’t perform that action at this time.