All-in-One Observability Container

---

"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

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.

Performance note: with rootless podman, published ports go through pasta user-mode forwarding, which costs ~13–18% of peak ingest throughput at saturation (measured 2026-07-18, timeless_metrics cardinality bank). For ingest-heavy deployments use --network=host (drop the -p flags — the stack binds 4000/8428/9428/10428 directly). Under sustained heavy ingest also set a generous stop timeout (e.g. --stop-timeout 120 or TimeoutStopSec= in quadlets) so the shutdown flush completes.

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 this repo (the data plane is downloaded from the named timeless-libsql release, not built from source — the tag must have published artifacts):

docker build -t timeless-stack -f timeless_stack/Dockerfile \
  --build-arg TIMELESS_BUILD_RELEASE=v0.7.1 .

Architecture

TimelessStack is a thin orchestration layer. The default production data plane is three supervised, signal-specific Rust API processes backed by the public timeless-libsql extension. Phoenix remains the control plane and the legacy embedded engines remain available only through the documented offline rollback window.

The exact supported API/query surface, limits, ownership boundary, and rollback procedure are frozen in docs/telemetry_data_plane_compatibility.md.

The bundled components are:

• TimelessMetrics -- Prometheus-compatible time-series storage and extension-owned rollups in libSQL.
• TimelessLogs -- Structured rich-log storage in the libSQL block virtual table.
• TimelessTraces -- OpenTelemetry-compatible rich spans in the libSQL trace virtual table.
• TimelessUI -- Phoenix LiveView dashboard with real-time canvas visualization, alerting, and metric/log/trace exploration.

Data Retention

TimelessStack ships with longer retention defaults suited for a dedicated observability server.

Engine	Default Retention	Size Limit
Metrics (raw)	90 days	none
Metrics (daily rollup)	365 days	none
Logs	90 days	2 GB
Traces	90 days	1 GB

Customizing retention

Override in config/config.exs or config/runtime.exs:

config :timeless_logs,
  retention_max_age: 180 * 86_400,         # 180 days
  retention_max_size: 4_294_967_296,       # 4 GB cap (nil = unlimited)
  retention_check_interval: 300_000        # check every 5 minutes

config :timeless_traces,
  retention_max_age: 30 * 86_400,          # 30 days
  retention_max_size: 2_147_483_648        # 2 GB cap

For metrics:

config :timeless_metrics,
  raw_retention_seconds: 180 * 86_400,     # 180 days raw
  daily_retention_seconds: 730 * 86_400    # 2 years rolled up

Setting retention_max_age to nil disables time-based retention. Setting retention_max_size to nil disables size-based retention.

Environment variables can also be used at runtime (see config/runtime.exs):

LOGS_RETENTION_AGE=7776000    # 90 days in seconds
LOGS_RETENTION_SIZE=2147483648
TRACES_RETENTION_AGE=7776000
TRACES_RETENTION_SIZE=1073741824

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.