Phoenix Analytics is embedded plug and play tool designed for Phoenix applications. It provides a simple and efficient way to track and analyze user behavior and application performance without impacting your main application's performance and database.

Key features:

• ⚡️ Lightweight and fast analytics tracking
• 🗄️ Flexible database support (PostgreSQL, SQLite3, MySQL)
• 🔌 Easy integration with Phoenix applications
• 📊 Minimalistic dashboard for data visualization
• 🎨 12 customizable color themes
• 🌙 Full dark mode support across all themes

Phoenix Analytics now supports multiple database backends using Ecto, allowing you to choose the database that best fits your deployment environment and requirements. Whether you're using PostgreSQL in production, SQLite3 for development, or MySQL in your infrastructure, Phoenix Analytics will work seamlessly.

If available in Hex, the package can be installed by adding phoenix_analytics to your list of dependencies in mix.exs:

def deps do
  [
    {:phoenix_analytics, "~> 0.4"}
  ]
end

Phoenix Analytics uses your existing Ecto repository, making setup incredibly simple:

# config/dev.exs
config :phoenix_analytics,
  repo: MyApp.Repo,
  app_domain: System.get_env("PHX_HOST") || "example.com",
  cache_ttl: System.get_env("CACHE_TTL") || 60

Create the analytics table in your existing database:

mix ecto.gen.migration add_phoenix_analytics

defmodule MyApp.Repo.Migrations.AddPhoenixAnalytics do
  use Ecto.Migration

  def up, do: PhoenixAnalytics.Migration.up()
  def down, do: PhoenixAnalytics.Migration.down()
end

# indexes, no sqlite support
defmodule MyApp.Repo.Migrations.AddPhoenixAnalyticsIndexes do
  def change do
    PhoenixAnalytics.Migration.add_indexes()
  end
end

mix ecto.migrate

Alternative: If you don't use migrations, you can run the migration directly:

iex -S mix
PhoenixAnalytics.Migration.up()

Add plug to enable tracking to endpoint.ex, ‼️ add it straight after your Plug.Static

plug PhoenixAnalytics.Plugs.RequestTracker

Add dashboard route to your router.ex

use PhoenixAnalytics.Web, :router

phoenix_analytics_dashboard "/analytics"

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/phoenix_analytics.

Shortcuts:

• t -> today
• ctrl+t -> yesterday
• w -> last_week
• m -> last_30_days
• q -> last_90_days
• y -> last_12_month
• ctrl+w -> previous_week
• ctrl+m -> previous_month
• ctrl+q -> previous_quarter
• ctrl+y -> previous_year
• a -> all_time

If you would like to contribute, first you would need to install deps, assets and then compile css and js. I put everything under next mix command:

mix setup

Then you would need some database with seeds. Here is command for this:

# For SQLite3
mix run priv/repo/seeds.exs sqlite 10000

# For PostgreSQL
mix run priv/repo/seeds.exs postgres

# For MySQL
mix run priv/repo/seeds.exs mysql 10000

Lastly you can use one of example applications to start server.

cd examples/sqlite/

mix deps.get

mix phx.server

You can navigate to http://localhost:4000/dev/analytics

I performed vegeta test on basic Macbook Air M2, to see if plug will affect application performance. Script can be found here: vegeta/vegeta.sh

With plug	Without

• Single instance Phoenix app (any supported database)
• Multiple instances of Phoenix app without auto scaling group (any supported database)
• Multiple instances of Phoenix app with auto scaling group (PostgreSQL or MySQL)

• error-tracker
• plausible.io