TimelessStack

An all-in-one observability container that bundles TimelessMetrics, TimelessLogs, TimelessTraces, and TimelessUI into a single deployable image.

Ports

Port	Service
4000	TimelessUI (Phoenix web dashboard)
8428	TimelessMetrics (Prometheus-compatible HTTP)
9428	TimelessLogs (log ingestion HTTP)
10428	TimelessTraces (OTLP trace ingestion HTTP)

Quick Start

Container (recommended)

docker pull ghcr.io/awksedgreep/timeless-stack:latest

docker run -d \
  -p 4000:4000 \
  -p 8428:8428 \
  -p 9428:9428 \
  -p 10428:10428 \
  -v timeless_data:/data \
  ghcr.io/awksedgreep/timeless-stack:latest

All data is stored under /data (metrics, logs, traces, and the UI database). Mount a volume to persist across restarts.

From Source

TimelessStack requires three sibling repos checked out side-by-side:

parent/
  timeless_stack/
  timeless_metrics/
  timeless_ui/

git clone https://github.com/awksedgreep/timeless_stack.git
git clone https://github.com/awksedgreep/timeless_metrics.git
git clone https://github.com/awksedgreep/timeless_ui.git

cd timeless_stack
mix deps.get
mix assets.setup
mix assets.deploy
mix phx.server

Configuration

All services are configured in config/config.exs. Key settings:

# Data directories (default to /data/* in container)
config :timeless_metrics, data_dir: "/data/metrics", port: 8428
config :timeless_logs, storage: :disk, data_dir: "/data/logs", http: [port: 9428]
config :timeless_traces, storage: :disk, data_dir: "/data/traces", http: [port: 10428]

Building the Container Locally

From the parent directory containing all three repos:

docker build -t timeless-stack -f timeless_stack/Dockerfile .

Architecture

TimelessStack is a thin orchestration layer. Each component runs as a supervised OTP application:

• TimelessMetrics -- Prometheus-compatible time-series storage using Gorilla compression (delta-of-delta timestamps, XOR'd float values) backed by SQLite.
• TimelessLogs -- Structured log storage with SQLite index and compressed blocks (zstd/openzl columnar format).
• TimelessTraces -- OpenTelemetry-compatible span storage using the same block architecture as logs.
• TimelessUI -- Phoenix LiveView dashboard with real-time canvas visualization, alerting, and metric/log/trace exploration.

Health Checks

Each ingestion service exposes a /health endpoint:

curl http://localhost:8428/health   # metrics
curl http://localhost:9428/health   # logs
curl http://localhost:10428/health  # traces

License

MIT -- see LICENSE for details.