For Linux apps that use native stacktraces from C or C++ code consist of a list of addresses and numeric offsets. BugSnag requires a mapping file to be uploaded to match a given address with a file name and method
For installation instructions for the BugSnag CLI, please see our Installation guide.
The linux command attempts to upload C/C++ symbol files generated during a release build and uploads it to the Linux symbol API.
Unless a symbol file has been passed to the command, it recursively searches the given directory for .so, .so.debug and .debug symbol files to upload.
The simplest way to run the command is from the root directory of your project:
$ bugsnag-cli upload linux \
--api-key=YOUR_API_KEY \
--version-name=1.2.3
--api-key)The BugSnag API key for the application.
You can find your API key in Project Settings from your BugSnag dashboard.
--application-id)A unique application ID, usually the package name, of the application.
--dry-run)Performs a dry-run of the command without sending any information to BugSnag.
--log-level)Sets the level of logging to debug, info, warn or fatal.
Default: info.
--overwrite)Whether to ignore and overwrite existing uploads with same identifier, rather than failing if a matching file exists.
--port)The port number for the BugSnag upload server.
Default: 443.
--project-root)The path to strip from the beginning of source file names referenced in stacktraces on the BugSnag dashboard.
Default: the root directory if the command has detected one, otherwise it’s empty.
--retries)The number of retry attempts before failing an upload request.
Default: 0.
--timeout)The number of seconds to wait before failing an upload request.
Default: 300.
--upload-api-root-url)The upload server hostname, optionally containing port number.
For use in BugSnag On-premise configurations. The command will append the appropriate path to access the correct upload endpoint.
--verbose)Sets the level of the logging to its highest.
This is the equivalent of setting the log level to debug.
--version-name)The version of the application.