Connect Falcon to Bugsink

When a Falcon request fails, Bugsink shows you the exception, the application frame that raised it, and the HTTP request that reached the resource.

This guide covers the initial setup and Falcon’s automatic capture of unhandled resource exceptions. You’ll connect an existing application, then make one request fail to confirm that it reaches Bugsink.

To follow along, create a Bugsink project and copy its DSN. The quickstart guide shows where to find it.

Install the SDK

Install the open-source Sentry SDK with its Falcon support in the environment your application uses. Bugsink accepts the Sentry event protocol, so the SDK can send events directly to your Bugsink project.

python -m pip install --upgrade "sentry-sdk[falcon]"

Configure Falcon

Import the SDK and Falcon integration where you create the application:

import os
from wsgiref.simple_server import make_server

import falcon
import sentry_sdk
from sentry_sdk.integrations.falcon import FalconIntegration

Initialize the SDK before creating the falcon.App. Reading the DSN from the environment keeps it out of source control:

sentry_sdk.init(
    dsn=os.environ["SENTRY_DSN"],
    integrations=[FalconIntegration()],
)

Set SENTRY_DSN in the environment where the application runs:

export SENTRY_DSN=https://key@bugsink.example/1

Trigger an unhandled exception

If a Falcon resource raises an exception and does not catch it, the integration reports it automatically. There is no SDK call inside the resource. To verify the setup, this checkout resource raises an exception when a product is missing:

class CheckoutResource:
    def on_get(self, request, response, sku):
        try:
            product = inventory[sku]
        except KeyError:
            raise ProductNotFound(f"Product {sku} is not in inventory") from None
        response.media = {"reserved": product["name"]}

The application maps that resource to /checkout/{sku}:

app = falcon.App()
app.add_route("/", InventoryResource())
app.add_route("/checkout/{sku}", CheckoutResource())

Start the application as usual, then request a product that does not exist through that URL:

python app.py
:::bash
curl http://127.0.0.1:8080/checkout/falcon-missing

Falcon returns an HTTP 500 response and the integration reports the exception.

See the error in Bugsink

Open your Bugsink project and select the new ProductNotFound issue. Its event points to the failing line in the resource and includes the GET request.

Bugsink preview

That’s it: unhandled Falcon resource exceptions will now be reported to Bugsink.

The integration runs around Falcon’s request handling, so your resources stay ordinary application code. An unhandled exception includes its Python stack, the application source frame, and the HTTP request that reached the resource.

If your application catches an exception itself, report it explicitly with capture_exception().