Flames 
Installation
The package can be installed as:
- Add
flamesto your list of dependencies inmix.exs:
def deps do
[{:flames, "~> 0.7"}]
end- Add configuration to tell
flameswhat your repository and (optional) Phoenix Endpoint modules are as well as adding it as a Logger backend:
config :flames,
repo: MyPhoenixApp.Repo,
endpoint: MyPhoenixApp.Endpoint,
timezone: "America/New_York",
table: "errors" # Optional, defaults to "errors"
config :logger,
backends: [:console, Flames.Logger]- Add the following migration. Run
mix ecto.gen.migration create_flames_tableto generate a migration file:
defmodule MyApp.Repo.Migrations.CreateFlamesTable do
use Ecto.Migration
def change do
# Make sure this table name matches the above configuration
create table(:errors) do
add :message, :text
add :level, :string
add :timestamp, :utc_datetime
add :alive, :boolean
add :module, :string
add :function, :string
add :file, :string
add :line, :integer
add :count, :integer
add :hash, :string
add :incidents, :json
timestamps()
end
create index(:errors, [:hash])
create index(:errors, [:updated_at])
end
endRun mix ecto.migrate to migrate the database.
- Add
import Flames.Routerandflames "/errors"to your Phoenix Router for live updates:
Router (You should place this under a secure pipeline and secure it yourself)
defmodule MyAppWeb.Router do
use Phoenix.Router
import Flames.Router # <--- Add this here
scope "/admin", MyAppWeb do
# Define require_admin plug to ensure public users cannot get here
pipe_through [:browser, :require_admin]
flames "/errors" # <--- Add this here
end
endVisit http://localhost:4000/errors (or wherever you mounted it) to see a live stream of errors.
