Skip to content

airbrake/airbrake-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 

Repository files navigation

Airbrake CLI

The official command-line tool to interact with Airbrake.io.

Contents

Installation

Homebrew (MacOS)

brew install airbrake/airbrake-cli/airbrake
airbrake --version

Manual install on MacOS

To install the Airbrake CLI manually on MacOS, find and download the latest .tar.gz file for the appropriate Mac architecture from https://github.com/airbrake/airbrake-cli/releases. Extract the CLI binary from the archive and install it to /usr/local/bin with this command:

tar xvzf airbrake*.tar.gz -C /usr/local/bin
airbrake --version

If desired, change the directory in the command above to extract the file to another location, e.g. somewhere on your $PATH.

Linux

To install the Airbrake CLI on Linux, find and download the latest .tar.gz file for Linux from https://github.com/airbrake/airbrake-cli/releases. Extract the CLI binary from the archive and install it to /usr/local/bin with this command:

tar xvzf airbrake*.tar.gz -C /usr/local/bin
airbrake --version

If desired, change the directory in the command above to extract the file to another location, e.g. somewhere on your $PATH.

Authentication

Login command

Note: the 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:

airbrake login

The 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: [email protected]
Enter your password:
Enter your subdomain (optional):
Done! The Airbrake CLI is configured for [email protected]

Completing the login command will generate a file in $HOME/.airbrake.yaml with contents like:

project-key: ""
user-key: ""
user-token: YOUR_USER_TOKEN

Config command

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

Global flags

Alternative to the login and config commands, you may specify the --user-key flag to the Airbrake CLI. The following are global flags for the airbrake command:

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

Commands

Install command

The Airbrake CLI offers an installation command which supports Ruby, Rails, Go, C#, Java, JavaScript, PHP, Python, Swift, and TypeScript via the install command:

# 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.

Going further

For information on all the available commands like deploys and more, invoke:

airbrake --help