Falcon

Installing Airbrake in a Falcon application

Falcon

The pybrake package makes it quick and easy to monitor your Falcon app’s performance. It only takes a few minutes to start collecting real performance data so let’s jump right in!

Key Features


Installation & Configuration

Set up the Pybrake’s middleware and project config for your web application

Step 1: Install the latest version of pybrake

Airbrake for Falcon uses our official Python notifier pybrake. To install run:

pip install -U pybrake

Step 2: Configure the Pybrake Falcon middleware

First, import the Falcon middleware from the pybrake package

from pybrake.middleware.falcon import init_app
"""
Initiate the pybrake notifier and apply the patch for error monitoring and APM.

:param app: Instance of Falcon (WSGI/ASGI) application to configure error 
            monitoring and APM
:param config: Dictionary object of application configure error monitoring 
              and APM
:param sqlEngine: SQLALCHEMY engine instance if you want to monitor query 
                    stats, default value will be None
:return: Application instance and update pybrake configuration with 
        notifier object 
"""

Next, configure pybrake parameters and register middleware into your application

app = falcon.App()
PYBRAKE_CONFIG = {
    "PYBRAKE": dict(
        project_id=123,
        project_key='FIXME',
    )
}
app, PYBRAKE_CONFIG = init_app(app, PYBRAKE_CONFIG)

Now you are ready to start reporting errors and performance monitoring to Airbrake from your Falcon app. Please look into sample example to get more idea.


Additional Settings

Please visit our Pybrake overview for details on useful features like:


Troubleshoot

If you have any questions or concerns, please address them here.