Buffalo

Installing Airbrake in a Buffalo application

Buffalo

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

Installation & Configuration

Step 1: Install the latest version of gobrake

go get github.com/airbrake/gobrake/v5
import (
  "github.com/airbrake/gobrake/v5"
  buffalobrake "github.com/airbrake/gobrake/v5/buffalo"
  "github.com/gobuffalo/buffalo"
)

Step 2: Configure the Airbrake Buffalo middleware

Configuration is done through the gobrake.NotifierOptions struct, which you are supposed to pass to gobrake.NewNotifierWithOptions.

var notifier = gobrake.NewNotifierWithOptions(&gobrake.NotifierOptions{
  ProjectId:   <YOUR PROJECT ID>, // <-- Fill in this value
  ProjectKey:  "<YOUR API KEY>", // <-- Fill in this value
  Environment: "production",
})

To find <YOUR PROJECT ID> and <YOUR API KEY> navigate to your project’s Settings and copy the values from the right sidebar.

Now pass the notifier in the custom middleware provided by gobrake i.e. buffalobrake and add it as a middleware.

app := buffalo.New(buffalo.Options{})
airbrake, err := buffalobrake.New(notifier)
if err != nil {
  log.Fatal(err)
}
app.Use(airbrake.Handle)

Voilà you are ready to start performance monitoring to Airbrake from your Buffalo app. Please look into sample example to get more idea.


Additional Settings

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


Troubleshoot

In case you have a problem, question or a bug report, feel free to file an issue.