prometheus-ecto

Prometheus.io collector for Elixir.Ecto

Monthly Downloads: 42,013

Programming language: Elixir

License: MIT License

Tags: Instrumenting / Monitoring    

Latest version: v1.4.3

README

Prometheus.io Ecto Instrumenter

Ecto integration for Prometheus.ex

• IRC: #elixir-lang on Freenode;
• Slack: #prometheus channel - Browser or App(slack://elixir-lang.slack.com/messages/prometheus).

Quickstart

1. Define your instrumenter:

   defmodule MyApp.Repo.Instrumenter do
     use Prometheus.EctoInstrumenter
   end
   

2. Call MyApp.Repo.Instrumenter.setup/0 when application starts (e.g. supervisor setup):

   MyApp.Repo.Instrumenter.setup()
   

3. If using Ecto 2, add MyApp.Repo.Instrumenter to Repo loggers list:

   config :myapp, MyApp.Repo,
     loggers: [MyApp.Repo.Instrumenter, Ecto.LogEntry]
     # ...
   

   If using Ecto 3, attach to telemetry in your application start function:

   :ok =
     Telemetry.attach(
       "prometheus-ecto",
       [:my_app, :repo, :query],
       MyApp.Repo.Instrumenter,
       :handle_event,
       %{}
     )
   

   If using Ecto 3.1 with telemetry 0.4+:

   :ok =
     :telemetry.attach(
       "prometheus-ecto",
       [:my_app, :repo, :query],
       &MyApp.Repo.Instrumenter.handle_event/4,        
       %{}
     )
   

Integrations / Collectors / Instrumenters

• Ecto collector
• Plugs Instrumenter/Exporter
• Elli middleware
• Fuse plugin
• Phoenix instrumenter
• Process Info Collector
• RabbitMQ Exporter

Installation

Available in Hex, the package can be installed as:

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

     def deps do
       [{:prometheus_ecto, "~> 1.4.1"}]
     end
   

2. Ensure prometheus_ecto is started before your application:

     def application do
       [applications: [:prometheus_ecto]]
     end