Installing Airbrake in a Python app

python flag


  • Simple to install and configure
  • Integrates with your existing logger
  • Add extra context to errors before they are sent
  • Set error severity and control notification thresholds
  • Compatible with Airbrake On-Premise

Getting Started

Download the Airbrake notifier

pip install -U airbrake

Automatic configuration

The easiest way to get set up is with a few environment variables. You can find your PROJECT ID and PROJECT API KEY on your project’s settings page.

export AIRBRAKE_API_KEY='<Your project API KEY>'
export AIRBRAKE_PROJECT_ID='<Your project ID>'
export AIRBRAKE_ENVIRONMENT=production

and you’re done! These environment variables are used to automatically configure your AirbrakeHandler.

Manual configuration

Or, you can manually instantiate your AirbrakeHandler by passing your PROJECT ID and PROJECT API KEY as arguments to the getLogger() helper.

import airbrake

logger = airbrake.getLogger(api_key="<Your project API KEY>", project_id=<Your project ID>)

except Exception:
    logger.exception("Bad math.")

Getting the most out of your errors

Now that your Python notifier is configured and ready to go we recommend you add extra context to your errors and add Airbrake to your existing logger. Please visit our official GitHub repo for the full list of notifier features.