README

LiveDashboard Plugin for Timeless Logs

"I found it ironic that the first thing you do to time series data is squash the timestamp. That's how the name Timeless was born." --Mark Cotner

Phoenix LiveDashboard page for browsing TimelessLogs logs.

Provides three tabs:

• Search -- query logs with level, message, and metadata filters + pagination
• Stats -- aggregate metrics (blocks, entries, compressed size, index size, timestamps)
• Live Tail -- real-time streaming of new log entries

Installation

Quick Start (Igniter)

mix igniter.install timeless_logs_dashboard

This automatically:

1. Adds config :timeless_logs, data_dir: "priv/timeless_logs" to your config
2. Adds import TimelessLogsDashboard.Router to your router
3. Adds timeless_logs_dashboard "/dashboard" to your browser scope
4. Updates your .formatter.exs

For in-memory storage (logs lost on restart):

mix igniter.install timeless_logs_dashboard --storage memory

Manual Setup

Add timeless_logs_dashboard to your dependencies:

def deps do
  [
    {:timeless_logs_dashboard, "~> 0.6.0"}
  ]
end

Configure TimelessLogs in config/config.exs:

config :timeless_logs, data_dir: "priv/timeless_logs"

Add the router macro:

# lib/my_app_web/router.ex
import TimelessLogsDashboard.Router

scope "/" do
  pipe_through :browser
  timeless_logs_dashboard "/dashboard"
end

Or add the page directly to an existing LiveDashboard:

live_dashboard "/dashboard",
  additional_pages: [
    logs: TimelessLogsDashboard.Page
  ]

Navigate to /dashboard/logs in your browser.

Requirements

• TimelessLogs must be running in your application
• Phoenix LiveDashboard ~> 0.8
• Phoenix LiveView ~> 1.0

License

MIT