Open-source streaming observability engine

Observe every stream without storing every event.

SketchLog turns high-volume telemetry into compact, mergeable sketches for latency percentiles, unique counts, event frequencies, anomalies, SLOs, canary analysis, and distributed monitoring.

100Mevents compressed
93 KBexample sketch size
Mergeabledistributed views
OpenMIT licensed
Production telemetry overview
Healthy
184 msdown 12%
1.8Mstable
0.7xwithin budget
IngestMetrics, traces, logs, events
CompressDDSketch, HLL, Count-Min
OperateSLOs, alerts, canaries
Why SketchLog

Built for teams that cannot afford to keep every raw event.

Modern systems generate more telemetry than teams can store, query, and pay for. SketchLog keeps the operational signal: distributions, cardinality, frequencies, drift, and release risk.

High-volume streams

Compress the signal, not the story.

Turn millions of latency samples, user IDs, and events into compact sketches that remain useful for real-time decisions.

Operational answers

Ask production questions directly.

Track p95, p99, unique users, top events, SLO burn rate, anomaly signals, and canary risk without replaying raw logs.

Distributed by design

Merge views across services and regions.

Sketches are compact and mergeable, making them practical for federation, namespaces, edge workloads, and multi-tenant systems.

Platform capabilities

A complete sketch-based observability layer.

SketchLog combines streaming data structures with production workflows, APIs, dashboards, and integrations for real systems.

Latency percentilesDDSketch-powered p50, p95, p99, and tail-latency tracking.
Unique countingHyperLogLog-style cardinality for users, sessions, tenants, and keys.
Event frequencyCount-Min sketches for high-volume event and error counting.
Streaming SQLQuery sketches with SQL-like aggregation and grouping.
Anomaly detectionAdaptive drift signals for real-time changes in stream behavior.
Smart SLOsAuto-calibrated targets and burn-rate analysis for operational risk.
Canary analysisCompare baseline and candidate streams before rolling out.
Mesh federationShare sketch snapshots across nodes without central coordination.
NamespacesTenant-aware stream isolation, quotas, and deployment boundaries.
Grafana pluginQuery SketchLog directly from Grafana dashboards.
OTel CollectorRoute pipeline telemetry into SketchLog from infrastructure.
WASM runtimeRun sketches in browsers, edge functions, and CDN environments.
Hosted playground

Try SketchLog in the browser before installing anything.

The hosted playground is a zero-dependency static demo. It works offline, uses no external CDN, stores no secrets, and shows the same sketch concepts behind the production package.

DDSketch quantilesAdd latency or duration values and watch p50, p95, and p99 update in real time.
Accuracy controlsAdjust relative accuracy and inspect how the bucket distribution changes.
Stream simulationWrite JSON records to stream paths and read them back in the browser.
Exporter previewsInspect Loki, Datadog, and New Relic payload shapes before using credentials.
Python cheatsheetCopy snippets for sketch usage, stream writes, agent config, and Loki export.
Safe static demoNo cookies, no tracking, no API keys, no eval, and no build step.
Developer workflow

Start with a simple local demo. Grow into production pipelines.

SketchLog is designed to be easy to try and credible to operate. Run it locally with Docker, send telemetry through SDKs or OpenTelemetry Collector, query it from APIs, and visualize results in Grafana or the live dashboard.

# run the local SketchLog demo stack
git clone https://github.com/SBALAVIGNESH123/sketchlog
cd sketchlog/demo
docker compose up -d

# verify the stack
python smoke.py
Launch demo smoke verification passed.

# query SketchLog directly
curl http://localhost:8000/v1/streams/api.latency
curl http://localhost:8000/metrics
How teams use it

One engine for real-time stream intelligence.

SketchLog is not a log warehouse or a full APM replacement. It is a lightweight observability layer for the high-cardinality, high-volume questions that become expensive with raw event storage.

1

Measure production latency

Capture p50, p95, p99, and tail shifts for APIs, workers, queues, RPC systems, and edge services.

2

Understand release risk

Use canary analysis, sketch diffing, SLO burn-rate signals, and anomaly scores to decide whether a rollout is safe.

3

Control telemetry cost

Store compact sketches for operational decisions instead of retaining every raw event forever.

Storage proof

Choose the right backend and reproduce the evidence.

SketchLog stores compact stream summaries instead of raw telemetry rows. The proof suite shows how each backend behaves across write, query, restart, and recovery paths.

In-memoryBest for demos, unit tests, notebooks, and fast local experiments. State is intentionally ephemeral after restart.
PostgreSQLRecommended durable path for shared server deployments that already operate SQL backups, monitoring, and access controls.
OmniKV embeddedOptional local-first durability for edge, embedded, or single-node deployments without a separate SQL service.
2,500 events
935,441 bytes
90,176 bytes
10.374x
242.289 ms
Verified

These are deterministic proof-fixture numbers, not a universal benchmark. They demonstrate bounded-memory behavior, Streaming SQL aggregates, cardinality, top counters, and durable recovery where configured.

# backend correctness proof
python scripts/storage_proof.py --backend memory
python scripts/storage_proof.py --backend postgres --postgres-start --postgres-stop
python scripts/storage_proof.py --backend omnikv

# realistic telemetry load proof
python scripts/telemetry_load_proof.py --backend omnikv
PASS SketchLog telemetry load proof
Clear positioning

Designed to complement your observability stack.

Use SketchLog alongside logs, metrics, traces, Prometheus, Grafana, and OpenTelemetry when you need compact distribution-aware analytics over high-volume streams.

NeedTraditional approachSketchLog approach
Tail latencyStore raw events or pre-aggregate fixed histograms.Use mergeable DDSketch distributions with configurable accuracy.
Unique usersDeduplicate raw IDs or maintain large sets.Track cardinality with compact probabilistic sketches.
Event frequencyCount every key and pay for high cardinality.Estimate frequent events with bounded-memory Count-Min structures.
Release safetyManually compare dashboards after deployment.Run canary analysis with distribution drift, SLO risk, and event deltas.
Distributed viewsCentralize raw telemetry before querying.Merge compact peer snapshots across services, tenants, and regions.
Integrations

Fits into standard engineering workflows.

SketchLog ships with practical integration points so teams can adopt it without rebuilding their telemetry stack.

Prometheus
Grafana
OpenTelemetry
Docker
Kubernetes
WASM
Python
TypeScript
Go
FastAPI
SQL
eBPF
# example: canary analysis
curl -X POST http://localhost:8000/v1/canary/analyze \
  -H 'content-type: application/json' \
  -d '{
    "baseline_stream": "production.checkout.latency",
    "candidate_stream": "canary.checkout.latency",
    "error_event_name": "checkout_failed"
  }'

{
  "verdict": "warning",
  "p99_shift_percent": 18.4,
  "slo_burn_rate_increase": 1.8,
  "summary": "Candidate shows elevated rollout risk."
}
Product workflows

Turn sketches into decisions, not just charts.

The value is not only compact storage. SketchLog connects stream summaries to operational workflows: anomaly detection, SLO burn-rate evaluation, canary release analysis, namespace isolation, and distributed sketch federation.

For platform teams

Use namespaces, quotas, mesh federation, production checks, and storage backends to operate telemetry as shared infrastructure.

For product engineers

Answer practical questions about latency, user impact, event spikes, and release safety without building custom analytics.

Open source

Try SketchLog locally, then bring it into your stack.

Run the demo, inspect the APIs, connect Grafana or OpenTelemetry Collector, and decide if sketch-based observability fits your workload.

git clone https://github.com/SBALAVIGNESH123/sketchlog
cd sketchlog/demo
docker compose up -d

The demo includes the server, telemetry generator, dashboard, metrics endpoint, and smoke verifier.