The official command line interface for interacting with Airbrake.
Installation and Authentication
brew install airbrake/airbrake-cli/airbrake
See the Airbrake CLI Repo for further installation and authentication instructions.
Alternative to the
config commands, you may specify the
--user-key flag to the Airbrake CLI. The following are global flags for the
Flags: --config string config file (default is $HOME/.airbrake.yaml) --project-key string Project key used to access the API --user-key string User key used to access the API --user-id string User ID used to access the API
login command requires username and password and does not support two-factor authentication. For alternative authentication methods (eg: in cases where GitHub logins, SSO, or two-factor authentication are used), please use the
config command or global flags.
Log in with the Airbrake CLI by issuing the following command:
login command will prompt you for your email, password, and an optional subdomain (account subdomains are used to differentiate if you have multiple Airbrake accounts using the same email address).
Enter your email: firstname.lastname@example.org Enter your password: Enter your subdomain (optional): Done! The Airbrake CLI is configured for email@example.com
login command will generate a file in
$HOME/.airbrake.yaml with contents like:
project-key: "" user-key: "" user-token: YOUR_USER_TOKEN
If your account requires GitHub or SSO logins, or you have you two-factor authentication enabled, you cannot authenticate with the
login command. To authenticate in this situation, you can set credentials using the
airbrake config set command. To set your user key (which can be retreived from your profile settings page) with the
config set command, invoke:
airbrake config set user-key YOUR_USER_KEY_HERE
To check the values the Airbrake CLI is using, invoke:
airbrake config show
# Use the --project-id flag if you already have an Airbrake project in # your account you want to use airbrake install --project-id 12345 # Or have the install command create a new Airbrake project: airbrake install --create-project=DESIRED_PROJECT_NAME
Projects List Command
This short example will show you how to send a test error notice to an Airbrake project with some basic commands.
Before we send the test error notice, we need to get the
id of the project we want to send the notice to. To do this, invoke:
airbrake projects list
We’ll be using the
id field from the
project list output in the next command.
Notices Create Command
Quickly create an error notice using the
notices create command. Use the project ID you found when you listed your projects above.
airbrake notices create --project-id YOUR_PROJECT_ID \ --type "Sample Error" \ --message "My first error from the CLI"
This will send an error notice to the project you specified and provide you a direct link.
Source Maps Create Command
If your project uses minified code, you can upload your source maps easily to Airbrake using the
sourcemaps create command:
airbrake sourcemaps create --project-id YOUR_PROJECT_ID \ --from-file '/path/to/your/file/app.min.js.map' --name 'unique-name' --pattern '%app.min.js'
This assumes that there is a source map file at the location specified. The
pattern value tells Airbrake what minified files to match the source map to. In
%app.min.js tells Airbrake to match the source map to all files
that end with
app.min.js. For more info about pattern options, visit our
source maps doc.
Patterns are optional and are generated from the file value if not specified.
This section is intended as a guide to deploying the Airbrake CLI to capture output of entire commands, and send it to airbrake.io as a notification.
Note that this subcommand is available in version 1.2.5 and above.
To capture output of a regular unix shell (such as bash/csh/zsh/sh) command, run
airbrake capture as so:
airbrake capture --project-key <KEY> --project-id <ID> -- echo my wish is your command
Alternatively, you can set the env vars:
export AB_PROJECT_KEY=<KEY> export AB_PROJECT_ID=<ID> airbrake capture -- echo my command is your wish
Your KEY and ID can be found on the right hand side of your airbrake project setting’s page in your airbrake.io account. You will need these for all forms of the airbrake capture command.
It may additionally be useful to export these variables in your
.bash_profile (or equivalent) shell config/aliases file.
Other Capture use cases
For more OS-level cases, see the OS/Shell platform doc
For more use DevOps-focused cases and details for how to implement them, see Shell Capture for IT/DevOps Use
For information on all the available commands like deploys and more, invoke:
For questions, suggestions, or issues, please visit our official GitHub repository.