Skip to content

Latest commit

 

History

History
53 lines (40 loc) · 2.42 KB

README.md

File metadata and controls

53 lines (40 loc) · 2.42 KB

symbolicli is a cli utility that lets you symbolicate native and JavaScript events and minidumps locally.

By default, symbolicli will target https://sentry.io/. If you are hosting your own Sentry instance, you can override this with the --url option or the url config setting.

Basic Usage

symbolicli -o <ORG> -p <PROJECT> --auth-token <TOKEN> <EVENT>
  • <ORG> and <PROJECT> are the organization and project to which the event belongs;
  • <TOKEN> is a Sentry authentication token that has access to the project;
  • <EVENT> is either a local file (minidump or event JSON) or the ID of an event from the Sentry instance.

Alternatively, you can run symbolicli in offline mode:

symbolicli --offline <EVENT>

In offline mode symbolicli will not attempt to access a Sentry server, which means you can only process local events.

NB: JavaScript symbolication is not supported in offline mode.

Configuration

symbolicli can be configured via the ~/.symboliclirc config file, written in the TOML format. You can also place a .symboliclirc or symbolicli.toml file in a project directory to override global settings.

The available options are:

  • cache_dir: A directory where downloaded debug files will be cached.
  • url: The base URL of the sentry instance. Defaults to https://sentry.io/.
  • auth_token: A Sentry authentication token. This can be overridden with the SENTRY_AUTH_TOKEN environment variable or the --auth-token command line option.
  • org: The default organization for which to process events. This can be overridden with the --org command line option.
  • project: The default project for which to process events. This can be overridden with the --project command line option.
  • sources: A list of debug file sources that will be queried in addition to the project's uploaded files. See Sources documentation.

See symboliclirc.example for an exapmle .symboliclirc file.

Logging

You can control the level of logging output by passing the desired log level to the --log-level option. Available levels are off, error, warn, info, debug, trace. The default is info.

Local Symbols

The --symbols option allows you to supply a local directory containing debug files to use in addition to the configured sources. The directory must be sorted according to the unified layout. The easiest way to accomplish that is using symsorter.