Our Elixir agent supports Phoenix 1.2.0+, Ecto 2.0+, and Elixir 1.4+.


Tailored instructions are provided within our user interface. General instructions for a Phoenix 1.3+ app:

1. Add the scout_apm dependency.

Your mix.exs file:

# mix.exs

 def deps do
   [{:phoenix, "~> 1.4.0"},
    {:scout_apm, "~> 1.0"}]

If your Mixfile manually specifies applications, :scout_apm must be added:

# mix.exs
def application do
  [mod: {YourApp, []},
  applications: [..., :scout_apm]]


mix deps.get

2. Download your customized config file, placing it at config/scout_apm.exs.

Your customized config file is available within your Scout account. Inside the file, replace "YourApp" with the app name you’d like to appear within Scout.

3. Integrate into your Phoenix app.

Instrument Controllers. In lib/your_app_web.ex:

# lib/your_app_web.ex
defmodule YourApp.Web do
  def controller do
    quote do
      use Phoenix.Controller
      use ScoutApm.Instrumentation

Instrument Templates. In config/config.exs:

# config/config.exs
config :phoenix, :template_engines,
  eex: ScoutApm.Instruments.EExEngine,
  exs: ScoutApm.Instruments.ExsEngine

4. Integrate Ecto

Using Ecto 2.x?. In config/config.exs:

# config/config.exs
import_config "scout_apm.exs"

config :your_app, YourApp.Repo,
  loggers: [{Ecto.LogEntry, :log, []},
            {ScoutApm.Instruments.EctoLogger, :log, []}]

Using Ecto 3.x?. In lib/my_app/application.ex:

# lib/my_app/application.ex
defmodule MyApp.Application do
  use Application

  def start(_type, _args) do
    import Supervisor.Spec
    children = [
        # ...
 :ok = ScoutApm.Instruments.EctoTelemetry.attach(MyApp.Repo) 
    # ...
    Supervisor.start_link(children, opts)

5. Restart your app.

mix phx.server

Updating to the Newest Version

1. Ensure your mix.exs dependency entry for scout_apm is: {:scout_apm, "~> 0.0"}`


mix deps.get scout_apm

3. Recompile and deploy.

Auto-Instrumented Libraries

Our install instructions walk through instrumenting the following libraries:

See instrumenting common libraries for guides on instrumenting other Elixir libraries.