Purpose
Lightmetrics is an owned telemetry path for small fleets that need a narrow agent, explicit ingest contracts, and private reads without a hosted-control-plane assumption.
Self-hosted telemetry path for small fleets
Lightmetrics
A pre-production Rust agent and collector for owned telemetry: durable local queues, Cap'n Proto batches, private query APIs, and stock Grafana access through a narrow Prometheus-compatible surface.
- Pre-productionWorking ingest and query pieces with explicit limits
- Self-hostedNo signup, pricing, hosted service, or public cloud API
- Implementation-awarePlanned behavior is labeled before it is built
Current shape agent to collector to private reads
Host lm-agent queue, heartbeat, logs
POST batch
Ingest lm-collector spool, dedupe, live notices
Durability Accepted data local spool, raw blobs, manifests
private API
Reads Console and Grafana Prometheus subset, logs, alerts
curl -H "Authorization: Bearer $QUERY_TOKEN" \
"http://127.0.0.1:18080/api/v1/query?query=lmagent_up"Project information
Public pages start from current source, not a product promise
The landing route gives readers a short path to the implemented repository, the verified local demo, and the limitations that still matter.
Current maturity
The repository is pre-production. Local ingest, query, object-store, Grafana-smoke, demo, and console pieces exist, while production packaging and operations remain tracked work.
Claim boundary
Public pages summarize implemented source, limitations, and plan rows. Design targets and planned rows are not presented as shipped runtime behavior.
Core architecture
Current flow through agent, ingest, accepted data, and private reads
lm-agent
Collects heartbeat, host/process metrics, and configured complete log lines into the durable local upload queue.
lm-collector
Accepts framed Cap'n Proto batches over the public ingest endpoint with bearer identity checks, validation, and sequence dedupe.
Accepted data
Keeps accepted frames in local spool storage and can land raw blobs plus accepted manifests through filesystem or S3-compatible object stores.
Console and Grafana
Serves bounded metrics, logs, alerts, live notices, and a narrow Prometheus-compatible query surface behind the private query token.
Capability boundary
What the current repository can and cannot claim
Ingest and accepted storage path
Framed Cap'n Proto validation, bearer-authenticated ingest, sequence dedupe, local spool acceptance, and S3-compatible accepted manifests are represented in the current source.
Private read surfaces
The collector exposes bounded metrics, logs, alerts, live SSE notices, buildinfo, and a narrow Prometheus-compatible API subset for stock Grafana.
Host telemetry and console depth
Linux heartbeat metrics, capped CPU, memory, load, network bytes, queue filesystem, process CPU, and process RSS exist. Some console depth remains bounded by missing backend contracts.
Production operations
Service units, package formats, broader admin workflows, and the public deployment path are tracked but not complete.
Start points
Quickstart, install, status, roadmap, and source links
Current Quickstart Run the local demo harness and query lmagent_up from a checkout. Current source Install Review the source-rendered manual binary layout and unsupported package formats. Current Limitations Check component limits before treating design notes as implemented behavior. Generated Roadmap Read generated status, dependencies, estimates, and evidence from the repository plan data. Build-time Source boundary Inspect which repository files the static site reads during build. Source GitHub Open the repository for code, docs, plan rows, and worklog evidence.
Local evaluation
Quickstart path
- Start the demo harness
scripts/lightmetrics-demo restart - Inspect service state
scripts/lightmetrics-demo status - Query the agent heartbeat
/api/v1/query?query=lmagent_up
Roadmap preview
Public site workstream
WEB-01
Claude Design public website HTML mockup/pages for lightmetrics.dev
DoneWorklog: WEB-01. Static reference bundle archived at design-artifacts/claude-design/lightmetrics-public-site-2026-05-08.tar.gz; no Astro scaffold, Cloudflare deployment, or DNS change.
WEB-02
Static Astro site scaffold and content/source boundary. Production website contract change: add the site/ package, select pnpm as the site package manager, and define build-time repository inputs for public pages
DoneWorklog: WEB-02. Static Astro scaffold committed under site/; no Cloudflare adapter, SSR, DNS/custom-domain change, full Markdown publishing pipeline, or full public Gantt surface.
WEB-03
Landing page and project information content
DoneWorklog: WEB-03. Landing route now includes source-grounded project facts, architecture steps, start-point links, and desktop/mobile browser verification; no full Markdown docs publishing, full public Gantt surface, Cloudflare Pages configuration, or DNS/custom-domain change.
WEB-04
Public documentation publishing pipeline
DoneWorklog: WEB-04. Static Astro docs routes are generated from an allowlist of repository Markdown sources, the build checks same-origin output links, planned guides remain listed as planned, and agent/review/worklog procedure sources are excluded from public docs routes. No full public Gantt interaction, Cloudflare Pages configuration, runtime API calls, DNS/custom-domain change, or package/service-unit docs are introduced.