An open API service indexing awesome lists of open source software.

https://github.com/j3rn/saturn_phoenix

Display Saturn-gathered query statistics in the Phoenix LiveDashboard.
https://github.com/j3rn/saturn_phoenix

Last synced: over 1 year ago
JSON representation

Display Saturn-gathered query statistics in the Phoenix LiveDashboard.

Awesome Lists containing this project

README

          

# SaturnPhoenix

Display [Saturn]-gathered query statistics in the [Phoenix LiveDashboard].

![video showing the "Saturn" page in Phoenix LiveDashboard live-updating with query metrics](saturn_phoenix.gif)

## Installation

First, you'll need to [install and configure Saturn]

The package can be installed by adding `saturn_phoenix` to your list of dependencies in `mix.exs`:

```elixir
def deps do
[
{:saturn_phoenix, git: "git@github.com:instinctscience/saturn_phoenix"}
]
end
```

Next, you'll need to configure the live dashboard to show the Saturn query page. In your `router.ex` file, you should have a section that looks like this:

```elixir
live_dashboard "/",
metrics: MyApp.Web.Telemetry,
ecto_repos: [MyApp.Repo]
```

You'll want to add `saturn: SaturnPhoenix.QueriesPage` to the list after an `additional_pages:`, like so:

```elixir
live_dashboard "/",
metrics: MyApp.Web.Telemetry,
ecto_repos: [MyApp.Repo],
additional_pages: [
saturn: SaturnPhoenix.QueriesPage
]
```

Now when you visit your Live Dashboard, you should see a new "Saturn" tab. Install complete!

[Saturn]: https://github.com/instinctscience/saturn
[Phoenix LiveDashboard]: https://hexdocs.pm/phoenix_live_dashboard/Phoenix.LiveDashboard.html
[install and configure Saturn]: https://github.com/instinctscience/saturn#installation