# DogExceptex
Elixir `Logger` backend for Datadog. Funnels exceptions and error-level logging into
datadog error events via the Datadog statsd agent.
## Running tests
Clone the repository, then,
`mix deps.get`
`mix test`
## Installation
The package can be installed by adding `dog_exceptex` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:dog_exceptex, "~> 0.0.1"}
]
end
```
To add `DogExceptex` as a logger backend, in your `config/config.exs` add (or change):
```elixir
config :logger, :backends, [:console, DogExceptex.Logger]
```
And configure with
```elixir
config :logger, :dog_exceptex,
statsd_host: "host",
statsd_port: port,
event_opts: [
priority: "normal",
tags: [ # Tags in this list should have a string value, and are arbitrary.
environment: System.get_env("MIX_ENV"),
app: "some-app",
]
]
```
If you wish to start a `Dogstatsd` process yourself, you may configure with `statsd_pid`.
`Logger.configure_backend/2` is supported.
## Docs
Documentation can be generated with `mix docs`