Packages

Live error monitoring to watch your Phoenix app going up in flames in real time! Open source version of error aggregation services. Hooks into Elixir's Logger to provide accurate error reporting all throughout your application.

Current section

Files

Jump to
flames README.md
Raw

README.md

# Flames
**TODO: Add description**
## Installation
If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:
1. Add `flames` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[{:flames, "~> 0.1.0"}]
end
```
2. Ensure `flames` is started before your application:
```elixir
def application do
[applications: [:flames]]
end
```
3. Add configuration to tell `flames` what your repository and (optional) Phoenix Endpoint modules are as well as adding it as a Logger backend:
```elixir
config :flames,
repo: SlackCoder.Repo,
endpoint: SlackCoder.Endpoint
config :logger,
backends: [:console, Flames.Logger]
```
4. Add the following migration:
```elixir
defmodule MyApp.Repo.Migrations.CreateFlamesTable do
use Ecto.Migration
def change do
create table(:errors) do
add :message, :text
add :level, :string
add :timestamp, :datetime
add :alive, :boolean
add :module, :string
add :function, :string
add :file, :string
add :line, :integer
add :count, :integer
add :hash, :string
timestamps
end
create index(:errors, [:hash])
end
end
```
5. (Optional) Add it to your Phoenix Router and Phoenix Endpoint for live updates:
Router (You should place this under a secure pipeline and secure it yourself)
```elixir
forward "/errors", Flames.Web
```
Endpoint (Make sure this is the full path, adding `/socket` to the end)
```elixir
socket "/errors/socket", Flames.UserSocket
```
Visit http://localhost:4000/errors (or wherever you mounted it) to see a live stream of errors.