New Relixir

This repository has been archived.

📚 Archived Status: This repository is no longer actively maintained or updated. It is being preserved for historical reference or potential future use. Issues, pull requests, and contributions are no longer accepted.

🙏 Thank You: We appreciate the contributions and engagement from the community during the active phase of this project.

Thank you!

Instrument your Phoenix and Plug applications with New Relic.

New Relixir currently supports instrumenting bare-bones Plug endpoints, Phoenix controllers and Ecto repositories, to record response times of web transactions and database queries.

• Documentation

Usage

The following instructions show how to add instrumentation with New Relixir to a hypothetical Phoenix application named MyApp.

1. Add new_relixir to your list of dependencies in mix.exs:

   # mix.exsdefmoduleMyApp.MixfiledouseMix.Project# ...defpdepsdo[{:new_relixir,"~> 0.4"}]endend

   If you use the applications key (only for apps created before Elixir 1.4) in def application do, then you will also need to add new_relixir to it:

   defapplicationdo[mod: {MyApp,[]},applications: [:new_relixir]]end

   If your app does not have an applications key, skip this instruction.

2. Add your New Relic application name and license key to config/config.exs. You may wish to use environment variables to keep production, staging, and development environments separate:

   # config/config.exsconfig:new_relixir,application_name: System.get_env("NEWRELIC_APP_NAME"),license_key: System.get_env("NEWRELIC_LICENSE_KEY")

3. Add NewRelixir.Instrumenters.Phoenix to the list of instrumenters in your Endpoint configuration:

   # config/config.exsconfig:my_app,MyAppWeb.Endpoint,instrumenters: [NewRelixir.Instrumenters.Phoenix],# ...

4. If your app also uses Ecto, define a module to wrap your repository's methods with New Relic instrumentation:

   # lib/my_app/repo.exdefmoduleMyApp.RepodouseEcto.Repo,otp_app: :my_appdefmoduleNewRelicdouseNewRelixir.Plug.Repo,repo: MyApp.Repoendend

   Now MyApp.Repo.NewRelic can be used as a substitute for MyApp.Repo. It will dispatch and instrument the response time for all Repo calls.

   If you've defined custom functions on your Repo, you will need to define them on your wrapper module as well. In the wrapper module, simply call your repository's original function inside a closure that you pass to instrument_db:

   # lib/my_app/repo.exdefmoduleMyApp.RepodouseEcto.Repo,otp_app: :my_appdefmy_custom_operation(queryable,opts\\[])do# ...enddefmoduleNewRelicdouseNewRelixir.Plug.Repo,repo: MyApp.Repodefmy_custom_operation(queryable,opts\\[])doinstrument_db(:my_custom_operation,queryable,opts,fn()->MyApp.Repo.my_custom_operation(queryable,opts)end)endendend

   When using the wrapper module's my_custom_operation, the time it takes to call MyApp.Repo.my_custom_operation/2 will be recorded to New Relic.

Error Reporting

If you want to report all errors to new relic

Configure your router

# lib/my_app/router.exdefmoduleMyApp.RouterdouseMyApp,:routeruseNewRelixir.Plug.Exception...end

If you want to report caught errors

trydoraise"oops"catchkind,reason->transaction=caseNewRelixir.CurrentTransaction.get()do{:ok,transaction}->transaction{:error,_}->NewRelixir.CurrentTransaction.set(conn.request_path)endNewRelixir.Transaction.record_error(transaction,{kind,reason})# You may want to re-raise this exception:erlang.raise(kind,reason,System.stacktrace)end

Upgrading from 0.3.x

1. Remove NewRelixir.Plug.Phoenix from your Plug pipeline and all further references to that module.

2. Add NewRelixir.Instrumenters.Phoenix to the list of instrumenters in your Endpoint configuration. See more in usage.

3. Passing a conn to the functions of your Repo wrapper is no longer required, calls to the wrapper can now be made the same way as calls to the original Repo:

   # web/controllers/users.exdefmoduleMyApp.UserControllerdouseMyApp.Web,:controllerdefindex(conn,_params)do# Beforeusers=Repo.all(User,conn: conn)# Nowusers=Repo.all(User)endend

Copyright

Copyright © 2016 The RealReal, Inc.

Distributed under the MIT License.