{"id":13809433,"url":"https://github.com/getsentry/symbolicator","last_synced_at":"2026-02-17T09:06:29.611Z","repository":{"id":37484187,"uuid":"172705585","full_name":"getsentry/symbolicator","owner":"getsentry","description":"Native Symbolication as a Service","archived":false,"fork":false,"pushed_at":"2025-05-12T10:39:44.000Z","size":14534,"stargazers_count":387,"open_issues_count":13,"forks_count":61,"subscribers_count":51,"default_branch":"master","last_synced_at":"2025-05-15T16:05:32.808Z","etag":null,"topics":["tag-production"],"latest_commit_sha":null,"homepage":"https://getsentry.github.io/symbolicator/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getsentry.png","metadata":{"funding":{"custom":["https://sentry.io/pricing/","https://sentry.io/"]},"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-02-26T12:16:43.000Z","updated_at":"2025-05-13T15:08:14.000Z","dependencies_parsed_at":"2023-10-23T04:21:33.629Z","dependency_job_id":"3366e8a1-0541-4991-9528-fc0c68b3d41c","html_url":"https://github.com/getsentry/symbolicator","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsymbolicator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsymbolicator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsymbolicator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsentry%2Fsymbolicator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getsentry","download_url":"https://codeload.github.com/getsentry/symbolicator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485063,"owners_count":22078767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["tag-production"],"created_at":"2024-08-04T02:00:25.927Z","updated_at":"2026-02-17T09:06:29.554Z","avatar_url":"https://github.com/getsentry.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"artwork/logo.png\" width=\"520\"\u003e\n    \u003cbr /\u003e\n\u003c/p\u003e\n\nA symbolication service for native stacktraces and [minidumps] with [symbol\nserver] support. It's a flexible frontend for parts of the [symbolic] library.\n\n[Documentation]\n\n## Contained Binaries\n\nThis repository contains several binary crates that can be run with `cargo run -p \u003cPACKAGE\u003e`:\n\n- `symbolicator`: Runs a symbolicator server. Calling `cargo run` without a package will run this binary.\n- `symsorter`: Sorts debug files into a structure usable by `symbolicator`.\n- `wasm-split`: Adds build IDs to wasm files.\n- `symbolicli`: Performs symbolication on the CLI. See [the readme](./crates/symbolicli/README.md).\n\n## Compiling\n\nSymbolicator is written in [Rust] and requires the latest stable Rust\ncompiler.\n\nTo compile, run:\n\n```sh\ncargo build --release\n```\n\nThe resulting binaries ends up in `target/release/` along with debug\ninformation files. On Linux, debug information is part of the executable and\nmight need to be stripped using `objcopy`.\n\n## Usage with Sentry\n\nThe following requires a recent git version of Sentry.\n\nWhile Symbolicator aims to not be tied to Sentry's usecases, [Sentry] has a hard\ndependency on Symbolicator to process native stacktraces. To get it running for\nlocal development:\n\n- In your `~/.sentry/sentry.conf.py`:\n\n  ```python\n  # Allow Symbolicator's request IP to fetch debug files from Sentry.\n  INTERNAL_SYSTEM_IPS = [\"127.0.0.1\"]\n  ```\n\n- In your `~/.sentry/config.yml`:\n\n  ```yaml\n  symbolicator.enabled: true\n  ```\n\nThen run `sentry devservices up` to download and start Symbolicator.\n\n## Development\n\nTo build Symbolicator, we require the **latest stable Rust**.\n\nWe use VSCode for development. This repository contains settings files\nconfiguring code style, linters, and useful features. When opening the project\nfor the first time, make sure to _install the Recommended Extensions_, as they\nwill allow editor assist during coding.\n\nThe root of the repository contains a `Makefile` with useful commands for\ndevelopment:\n\n- `make check`: Runs code formatting checks and linters. This is useful before\n  opening a pull request.\n- `make test`: Runs unit tests, integration tests and Python package tests (see\n  below for more information).\n- `make all`: Runs all checks and tests. This runs most of the tasks that are\n  also performed in CI.\n- `make clean`: Removes all build artifacts, the virtualenv and cached files.\n\n### Building and Running\n\nThe easiest way to rebuild and run Symbolicator is using `cargo`. Depending on\nthe configuration, you may need to have a local instance of Sentry running.\n\n```bash\n# Rebuild and run with all features\ncargo run -- run\n```\n\nFor quickly verifying that Symbolicator compiles after making some changes, you\ncan also use `cargo check`:\n\n```bash\ncargo check\n```\n\n### Local configuration\n\nBy default, Symbolicator listens on port `3021`. To override this and other\nconfiguration values, create a file `local.yml` in the project root folder. It\nis excluded from version control by default. Then, start Symbolicator and point\nto the configuration file:\n\n```bash\ncargo run -- run --config local.yml\n```\n\n### Tests\n\nThe test suite comprises unit tests, and integration tests, both of which\nare implemented as part of the Rust crates and can be run via:\n\n```bash\n# Tests for default features\nmake test\n```\n\n**Note**: On macOS, the default file descriptor limit of `256` is too low and\ncauses test failures. Before running tests, consider to increase is to a higher\nvalue:\n\n```bash\nulimit -n 4096\n```\n\n### Linting\n\nWe use `rustfmt` and `clippy` from the latest stable channel for code formatting\nand linting. To make sure that these tools are set up correctly and running with\nthe right configuration, use the following make targets:\n\n```bash\n# Format the entire codebase\nmake format\n\n# Run clippy on the entire codebase\nmake lint\n```\n\n[documentation]: https://getsentry.github.io/symbolicator/\n[sentry]: https://github.com/getsentry/sentry\n[minidumps]: https://docs.sentry.io/platforms/minidump/\n[symbol server]: https://en.wikipedia.org/wiki/Microsoft_Symbol_Server\n[symbolic]: https://github.com/getsentry/symbolic\n[rust]: https://www.rust-lang.org/\n","funding_links":["https://sentry.io/pricing/","https://sentry.io/"],"categories":["Tracing and Debugging","Rust"],"sub_categories":["Databases"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsentry%2Fsymbolicator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetsentry%2Fsymbolicator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsentry%2Fsymbolicator/lists"}