sentry

The Official Sentry Client for Elixir which provides a simple API to capture exceptions, automatically handle Plug Exceptions and provides a backend for the Elixir Logger.

Documentation

Installation

To use Sentry with your projects, edit your mix.exs file to add it as a dependency and add the :sentry package to your applications:

defp application do
 [applications: [:sentry, :logger]]
end

defp deps do
  [{:sentry, "~> 1.0"}]
end

Setup the application environment in your config/prod.exs

config :sentry,
  dsn: "https://public:secret@app.getsentry.com/1",
  tags: %{
    env: "production"
  }

Capture Exceptions

Sometimes you want to capture specific exceptions, to do so use the Sentry.capture_exception/3.

try do
  ThisWillError.reall()
rescue
  my_exception ->
    Sentry.capture_exception(my_exception, [stacktrace: System.stacktrace(), extra: %{extra: information}])
end

For optional settings check the docs.

Setup with Plug or Phoenix

In your router add the following lines:

use Plug.ErrorHandler
use Sentry.Plug

Capture all Exceptions

This library comes with an extension to capture all Error messages that the Plug handler might not. Simply set use_error_logger to true.

This is based on the Erlang error_logger.

config :sentry,
  use_error_logger: true

Configuration

Key	Required	Default	Notes
`dsn`	True	n/a
`environment_name`	False	`:dev`
`included_environments`	False	`~w(prod test dev)a`	If you need non-standard mix env names you need to include it here
`tags`	False	`%{}`
`release`	False	None
`server_name`	False	None
`use_error_logger`	False	False

Testing Your Configuration

To ensure you've set up your configuration correctly we recommend running the included mix task. It can be tested on different Mix environments and will tell you if it is not currently configured to send events in that environment:

$ MIX_ENV=dev mix sentry.send_test_event
Client configuration:
server: https://sentry.io/
public_key: public
secret_key: secret
included_environments: [:prod]
current environment_name: :dev

:dev is not in [:prod] so no test event will be sent

$ MIX_ENV=prod mix sentry.send_test_event
Client configuration:
server: https://sentry.io/
public_key: public
secret_key: secret
included_environments: [:prod]
current environment_name: :prod

Sending test event!

Docs

To build the docs locally, you'll need the Sphinx:

$ pip install sphinx

Once Sphinx is available building the docs is simply:

$ make docs

You can then view the docs in your browser:

$ open docs/_build/html/index.html

License

This project is Licensed under the MIT License.