Capture exceptions and send them to Airbrake or to your Errbit installation.
This library was originally forked from the
airbrake
Hex package. Development and
support for that library seems to have lapsed, but we (the devs at
CityBase) had changes and updates we wanted to make.
So we decided to publish our own fork of the library.
Add airbrake_client
to your dependencies:
defp deps do
[
{:airbrake_client, "~> 0.10"}
]
end
If you are switching from the original airbrake
library:
- Replace the
:airbrake
dependency with the:airbrake_client
dependency above.- You may want to start with version
~> 0.8.0
for maximum backwards compatibility.
- You may want to start with version
- Remove the
airbrake
dependency in your lockfile.- Command:
mix deps.unlock --unused
- If the dependency remains in the lockfile, check all of your apps and all of your dependencies.
- Command:
- Update your
config/*.exs
files to configure:airbrake_client
instead of:airbrake
.- A search-and-replace-in-project on
config :airbrake
can work really well. - When you run your project(even running the tests), you should get a
complaint if you're still configuring
:airbrake
.
- A search-and-replace-in-project on
config :airbrake_client,
api_key: System.get_env("AIRBRAKE_API_KEY"),
project_id: System.get_env("AIRBRAKE_PROJECT_ID"),
environment: Mix.env(),
filter_parameters: ["password"],
filter_headers: ["authorization"],
host: "https://api.airbrake.io" # or your Errbit host
config :logger,
backends: [{Airbrake.LoggerBackend, :error}, :console]
Required configuration arguments:
:api_key
- (binary) the token needed to access the Airbrake API. You can find it in User Settings.:project_id
- (integer) the id of your project at Airbrake.
Optional configuration arguments:
:environment
- (binary or function returning binary) the environment that will be attached to each reported exception.:filter_parameters
- (list of binaries) allows to filter out sensitive parameters such as passwords and tokens.:filter_headers
- (list of binaries) filters HTTP headers.:host
- (binary) the URL of the HTTP host; defaults tohttps://api.airbrake.io
.:ignore
- (MapSet of binary or function returning boolean or :all) allows to ignore some or all exceptions. See examples below.:options
- (keyword list or function returning keyword list) values that are included in all reports to Airbrake.io. See examples below.
To ignore some exceptions use the :ignore
config key. The value can be a
MapSet
:
config :airbrake_client,
ignore: MapSet.new(["Custom.Error"])
The value can also be a two-argument function:
config :airbrake_client,
ignore: fn type, message ->
type == "Custom.Error" && String.contains?(message, "silent error")
end
Or the value can be the atom :all
to ignore all errors (and effectively
turning off all reporting):
config :airbrake_client,
ignore: :all
If you have data that should always be reported, they can be included in the
config with the :options
key. Its value should be a keyword list with any of
these keys: :context
, :params
, :session
, and :env
.
config :airbrake_client,
options: [env: %{"SOME_ENVIRONMENT_VARIABLE" => "environment variable"}]
Alternatively, you can specify a function (as a tuple) which returns a keyword list (with the same keys):
config :airbrake_client,
options: {Web, :airbrake_options, 1}
The function takes a keyword list as its only parameter; the function arity is always 1.
defmodule YourApp.Router do
use Phoenix.Router
use Airbrake.Plug # <- put this line to your router.ex
# ...
end
def channel do
quote do
use Phoenix.Channel
use Airbrake.Channel # <- put this line to your web.ex
# ...
try do
String.upcase(nil)
rescue
exception -> Airbrake.report(exception)
end
Use Airbrake.GenServer
instead of GenServer
:
defmodule MyServer do
use Airbrake.GenServer
# ...
end
By pid:
Airbrake.monitor(pid)
By name:
Airbrake.monitor(Registered.Process.Name)
The Elixir apps defined in integration_test_apps
are used for testing
different dependency scenarios. If you make changes to the way jason
or
poison
is used this library, you should consider adding tests to those apps.