# AirbrakeEx [](https://hex.pm/packages/airbrake_ex)
Elixir client for the [Airbrake](https://airbrake.io) service.
## Installation
Add AirbrakeEx as a dependency to your `mix.exs` file:
```elixir
defp deps do
[{:airbrake_ex, "~> 0.2.6"}]
end
```
If on Elixir 1.3 or lower you will need to add it to your applications.
```elixir
def application do
[applications: [:airbrake_ex]]
end
```
Then run `mix deps.get` in your shell to fetch the dependencies.
### Configuration
It requires `project_key` and `project` parameters to be set
in your application environment, usually defined in your `config/config.exs`.
`logger_level` and `environment` are optional.
```elixir
config :airbrake_ex,
project_key: "abcdef12345",
project_id: 123456,
logger_level: :error,
environment: Mix.env
```
#### Advanced Configuration
If you want to use errbit instance, set custom url as `endpoint`.
If you connect through a proxy or need to pass other specific options to
`HTTPoison` you can use `http_options`, see https://hexdocs.pm/httpoison/HTTPoison.html#request/5
for a list of the available options.
```elixir
config :airbrake_ex,
project_key: "abcdef12345",
project_id: 123456,
endpoint: "http://errbit.yourdomain.com",
http_options: [ssl: [cacertfile: "/path/to/certfile.pem"]]
```
## Usage
```elixir
try do
IO.inspect("test",[],"")
rescue
exception -> AirbrakeEx.notify(exception, __STACKTRACE__)
end
```
### Logger Backend
There is a Logger backend to send logs to the Airbrake,
which could be configured as follows:
```elixir
config :logger,
backends: [:console, AirbrakeEx.LoggerBackend]
```
### Plug
You can plug `AirbrakeEx.Plug` in your web application Plug stack to send all exception to Airbrake
```elixir
defmodule YourApp.Router do
use Phoenix.Router
use AirbrakeEx.Plug
# ...
end
```
### Ignore
You can ignore certain types of errors by specifying a global `:ignore` as well as an `:ignore_backend` config key:
#### Global ignore
This will prevent errors from being sent from the notifier to Airbrake
```elixir
config :airbrake_ex,
...
# List form
ignore: [Phoenix.Router.NoRouteError]
# OR
# Function
ignore: fn(error) ->
cond do
error.type == Phoenix.Router.NoRouteError -> true
String.contains?(error.message, "Ecto.NoResultsError") -> true
true -> false
end
end
```
#### Ignore Backend
This is only needed if you are using the [Logger Backend](#logger-backend).
`:ignore_backend` prevents logs from being sent from the backend to the notifier. For example, it can be used to prevent errors that are already being logged by the plug from double logging.
```elixir
config :airbrake_ex,
...
# Function
ignore_backend: fn(log) ->
cond do
{_, message, _, _} = log ->
Enum.at(message, 2) == "MyApp.Endpoint"
true -> false
end
end
```
### Filter parameter
```elixir
config :airbrake_ex,
...
# List form
filter_parameters: [Phoenix.Router.NoRouteError]
# OR
# Function
filter_parameters: fn(error) ->
cond do
error.type == Phoenix.Router.NoRouteError -> true
String.contains?(error.message, "Ecto.NoResultsError") -> true
true -> false
end
end
```
## History
This library was based on a fork from the
[`airbrakex`](https://hex.pm/packages/airbrakex) Hex package. Development and
support for that library seems to have lapsed, but we (the devs at
[Rum&Code](https://rumandcode.io/)) had changes and updates we wanted to make, so we decided to turn our forked version into a separate library. We'd like to thank to [Michał Kalbarczyk](https://github.com/fazibear) for his work on the original library.
