The Airbrake Netlify build plugin automatically notifies Airbrake of new deploys made to your site after it finishes building in Netlify.

Usage no npm install needed!

<script type="module">
  import bharathvajNetlifyPluginAirbrake from 'https://cdn.skypack.dev/@bharathvaj/netlify-plugin-airbrake';


Airbrake Netlify build plugin

Automatically notify Airbrake of new releases being deployed to your site after it finishes building in Netlify.

The Airbrake Netlify build plugin:

  • Notifies Airbrake of new releases being deployed.
  • Sends Airbrake the commit SHA of HEAD to enable commit features.

You can get more benefits by enabling Github Integration - Optional

Make sure build plugins are enabled on your site to see the plugin run.


UI Installation

To install plugins via the Netlify UI, go to your team sites list and select the Plugins tab (or follow this direct link to the plugins directory). Then find "Airbrake Build Plugin" and click Install.

UI installation is the recommended way to install this Build Plugin unless you need advanced configuration.

File-based Installation

Alternatively, to install with file-based installation, add the following lines to your netlify.toml file:

  package = "@bharathvaj/netlify-plugin-airbrake"

    airbrakeProjectId = "123456"
    airbrakeEnvironment = "staging"
    airbrakeDeployUserName = "john"
    airbrakeDeployUserEmail= "john@smith.com"
    airbrakeVersion= "v2"

Note: The [[plugins]] line is required for each plugin installed via file-based installation, even if you have other plugins in your netlify.toml file already.

You can also differentiate the production and deploy preview enviroments using the Netlify's deploy context feature.

Set Environment Variables in Netlify

Save the internal integration token and any other environment variables as site environment variables:

  1. In Netlify, go to your site's settings.
  2. Click on "Build & deploy".
  3. Click “Edit variables” and add AIRBRAKE_PROJECT_ID and AIRBRAKE_PROJECT_KEY. For more configuration options see the environment variables section below.
  4. Click "Save".

View of internal integration permissions.

For more information about the parameters below, please see the Airbrake API docs.

Environment Variables

You can use site environment variables to configure these values:

name description example
AIRBRAKE_ENVIRONMENT Deploy Environment production
AIRBRAKE_DEPLOY_USER_NAME Deploy user name john
AIRBRAKE_DEPLOY_USER_EMAIL Deploy user email john@smith.com
AIRBRAKE_VERSION Deploy version v2

Plugin Inputs

name description example
airbrakeProjectId Project Id -
airbrakeEnvironment Deploy Environment production
airbrakeDeployUserName Deploy user name john
airbrakeDeployUserEmail Deploy user email john@smith.com
airbrakeVersion Deploy version v2