Having issues deploy tracking in your app? Check the deploy troubleshooting doc.
Why track deploys?
Deploy Tracking with Airbrake gives insight into the relationship between your deploys and your errors. Here are a few of the benefits deploy tracking gives you:
- Resolve all errors on a deploy
- Deploy markers on project and error graphs
- Insight into which deploys introduced problems
- Insight into which deploys solved problems
- Generate backtrace links to click through to the offending lines of code
- Filter errors by deploy
- Project and account-wide deploy trends
- Advanced deploy analytics
Resolve all errors on a deploy
When enabled, triggering a deploy in your Airbrake project resolves all errors
in the specified
environment this gives you a fresh slate each deploy so you
can tell which errors you fixed and which errors are still an issue.
Deploys show on your project’s error graphs
Deploys are marked with blue circles on your project’s graphs
They link to the detailed view for this deploy. Hovering over them will show a summary including a timestamp, the environment and an estimation of how many errors this deploy fixed.
Deploys create backtrace links
Using deploy tracking creates helpful links in your backtrace so you can click through to the file/line/revision in GitHub/GitLab/Bitbucket.
Filter errors by deploy
You can see your deploy activity on your project overview page and you can filter by a specific deploy in the search dropdown.
Deploy tracking with the API
You can track a deploy with a POST to the /v4/deploys API endpoint.
You want to trigger a POST each time you deploy, specifying at least your
environment in the JSON data. If you also
revision, this will enable us to build links in
backtraces that link to your repository.
Example curl command
Example bash script
This is a simple example that registers a deploy with Airbrake. It assumes it is
run from a Git repository of your deployed project code. You can tweak how the
REVISION is determined to suite your deploy process. Make sure you
check and modify the variables as appropriate for your project and requirements.
JSON post data description
You can post JSON data with the following keys:
The API returns
201 Created status code on success.
Deploy tracking with
The airbrake Ruby gem provides a convenient Rake task to track deploys.
Deploy tracking with Capistrano
The airbrake Ruby gem provides a convenient Capistrano recipe to track deploys.
Deploy tracking on Heroku
To implement Deploy Hooks on Heroku, please use one of the following options.
You can manually create the Deploy hook:
Or create it using rake:
Be sure to provide the app name for the rake task if you have multiple Heroku
apps configured. You can send it by setting the
The repository URL will default to the URL of the
origin remote. The
REPOSITORY_URL environment variable can be used to override this value.
Deploy tracking on Engine Yard Cloud
To notify Airbrake of your deploys to EngineYard cloud, you can use the
You can find more info on
config and its variables in the EngineYard doc on ruby deploy hooks.