The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
Update README.md
ddux3b7176358f6d
diff --git a/README.md b/README.mdindex fa943966..4c1b3ccf 100644--- a/README.md+++ b/README.md@@ -43,13 +43,13 @@ Plus: configurable alerts (Slack / GitHub / email / webhook), Apdex + Impact-Sco## Why Traceway-| | Enterprise (Datadog / New Relic) | DIY OSS stack (Prometheus + Loki + Tempo + ...) | **Traceway** |-| -------------- | -------------------------------- | ----------------------------------------------- | ------------------------------- |-| **Pricing** | Per-event, per-host, per-seat | Free + ops time | Self-host free, fixed cloud tiers |-| **Setup** | Vendor SDK per language | Glue 6 tools together | `docker compose up -d` |-| **License** | Proprietary | Mixed (some BSL / open-core) | **MIT — no asterisks** |-| **OTel** | Wrapped in vendor SDK | OTel Collector required | **Native OTLP/HTTP ingest** |-| **Replay + traces + AI** | 3 separate products | Wire it yourself | One system, one trace ID |+| | Enterprise (Datadog / New Relic) | DIY OSS stack (Prometheus + Loki + Tempo + ...) | **Traceway** |+| ------------------------ | -------------------------------- | ----------------------------------------------- | --------------------------------- |+| **Pricing** | Per-event, per-host, per-seat | Free + ops time | Self-host free, fixed cloud tiers |+| **Setup** | Vendor SDK per language | Glue 6 tools together | `docker compose up -d` |+| **License** | Proprietary | Mixed (some BSL / open-core) | **MIT — no asterisks** |+| **OTel** | Wrapped in vendor SDK | OTel Collector required | **Native OTLP/HTTP ingest** |+| **Replay + traces + AI** | 3 separate products | Wire it yourself | One system, one trace ID |## Quick Start@@ -98,22 +98,22 @@ Traceway integrates with the tools you already use. Every integration ships trac<table width="100%"><tbody><tr>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/gin-middleware"><img src="./docs/public/gin.png" height="48" alt="Gin" /><br/><b>Gin</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/chi-middleware"><img src="./docs/public/chi.png" height="48" alt="Chi" /><br/><b>Chi</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/fiber-middleware"><img src="./docs/public/fiber.svg" height="48" alt="Fiber" /><br/><b>Fiber</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/fasthttp-middleware"><img src="./docs/public/fasthttp.png" height="48" alt="FastHTTP" /><br/><b>FastHTTP</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/gin-middleware"><img src="./docs/public/gin.png" height="28" alt="Gin" /><br/><b>Gin</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/chi-middleware"><img src="./docs/public/chi.png" height="28" alt="Chi" /><br/><b>Chi</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/fiber-middleware"><img src="./docs/public/fiber.svg" height="28" alt="Fiber" /><br/><b>Fiber</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/fasthttp-middleware"><img src="./docs/public/fasthttp.png" height="28" alt="FastHTTP" /><br/><b>FastHTTP</b></a></td></tr><tr>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/http-middleware"><img src="./docs/public/stdlib.png" height="48" alt="net/http" /><br/><b>net/http</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/sdk"><img src="./docs/public/custom.png" height="48" alt="Go Generic" /><br/><b>Go Generic</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/node-sdk"><img src="./docs/public/node.png" height="48" alt="Node.js" /><br/><b>Node.js</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/nestjs"><img src="./docs/public/nestjs.png" height="48" alt="NestJS" /><br/><b>NestJS</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/http-middleware"><img src="./docs/public/stdlib.png" height="28" alt="net/http" /><br/><b>net/http</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/sdk"><img src="./docs/public/custom.png" height="28" alt="Go Generic" /><br/><b>Go Generic</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/node-sdk"><img src="./docs/public/node.png" height="28" alt="Node.js" /><br/><b>Node.js</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/nestjs"><img src="./docs/public/nestjs.png" height="28" alt="NestJS" /><br/><b>NestJS</b></a></td></tr><tr>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/hono"><img src="./docs/public/hono.png" height="48" alt="Hono" /><br/><b>Hono</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/symfony"><img src="./docs/public/symfony.png" height="48" alt="Symfony" /><br/><b>Symfony</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/cloudflare"><img src="./docs/public/cloudflare.png" height="48" alt="Cloudflare Workers" /><br/><b>Cloudflare</b></a></td>-<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/otel"><img src="./docs/public/otel.png" height="48" alt="OpenTelemetry" /><br/><b>OpenTelemetry</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/hono"><img src="./docs/public/hono.png" height="28" alt="Hono" /><br/><b>Hono</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/symfony"><img src="./docs/public/symfony.png" height="28" alt="Symfony" /><br/><b>Symfony</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/cloudflare"><img src="./docs/public/cloudflare.png" height="28" alt="Cloudflare Workers" /><br/><b>Cloudflare</b></a></td>+<td align="center" width="25%"><a href="https://docs.tracewayapp.com/client/otel"><img src="./docs/public/otel.png" height="28" alt="OpenTelemetry" /><br/><b>OpenTelemetry</b></a></td></tr></tbody></table>@@ -125,59 +125,65 @@ Traceway integrates with the tools you already use. Every integration ships trac<table width="100%"><tbody><tr>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/nextjs"><img src="./docs/public/nextjs.png" height="48" alt="Next.js" /><br/><b>Next.js</b></a></td>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/react"><img src="./docs/public/react.png" height="48" alt="React" /><br/><b>React</b></a></td>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/vue"><img src="./docs/public/vue.png" height="48" alt="Vue" /><br/><b>Vue</b></a></td>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/svelte"><img src="./docs/public/svelte.png" height="48" alt="Svelte" /><br/><b>Svelte</b></a></td>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/jquery"><img src="./docs/public/jquery.png" height="48" alt="jQuery" /><br/><b>jQuery</b></a></td>-<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/js-sdk"><img src="./docs/public/javascript.png" height="48" alt="JavaScript" /><br/><b>JavaScript</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/nextjs"><img src="./docs/public/nextjs.png" height="28" alt="Next.js" /><br/><b>Next.js</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/react"><img src="./docs/public/react.png" height="28" alt="React" /><br/><b>React</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/vue"><img src="./docs/public/vue.png" height="28" alt="Vue" /><br/><b>Vue</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/svelte"><img src="./docs/public/svelte.png" height="28" alt="Svelte" /><br/><b>Svelte</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/jquery"><img src="./docs/public/jquery.png" height="28" alt="jQuery" /><br/><b>jQuery</b></a></td>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/js-sdk"><img src="./docs/public/javascript.png" height="28" alt="JavaScript" /><br/><b>JavaScript</b></a></td></tr></tbody></table>### Mobile-<a href="https://docs.tracewayapp.com/client/flutter"><img src="./docs/public/flutter.png" height="48" alt="Flutter" /></a> **[Flutter](https://docs.tracewayapp.com/client/flutter)**+<table>+<tbody>+<tr>+<td align="center" width="16.66%"><a href="https://docs.tracewayapp.com/client/flutter"><img src="./docs/public/flutter.png" height="28" alt="Flutter" /><br/><b>Flutter</b></a></td>+</tr>+</tbody>+</table>### AI-<a href="https://docs.tracewayapp.com/client/openrouter"><img src="./docs/public/openrouter.png" height="48" alt="OpenRouter" /></a> **[OpenRouter](https://docs.tracewayapp.com/client/openrouter)**+<a href="https://docs.tracewayapp.com/client/openrouter"><img src="./docs/public/openrouter.png" height="28" alt="OpenRouter" /></a> **[OpenRouter](https://docs.tracewayapp.com/client/openrouter)**## Screenshots-| | |-|---|---|-| **Logs — trace-linked search**<br> | **Traces — cross-service**<br> |-| **Span waterfall**<br> | **Metrics — application dashboard**<br> |-| **Session replay**<br> | **Exceptions — grouped & ranked**<br> |-| **Endpoint impact (Apdex)**<br> | **AI observability**<br> |+| | |+| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |+| **Logs — trace-linked search**<br> | **Traces — cross-service**<br> |+| **Span waterfall**<br> | **Metrics — application dashboard**<br> |+| **Session replay**<br> | **Exceptions — grouped & ranked**<br> |+| **Endpoint impact (Apdex)**<br> | **AI observability**<br> |## Tech Stack-| Component | Technology |-|-----------|------------|-| Backend | Go 1.25, Gin |-| Frontend | SvelteKit 2, Svelte 5, Tailwind CSS v4 |-| Telemetry DB | ClickHouse (standalone) or SQLite (embedded) |-| Relational DB | PostgreSQL (standalone) or SQLite (embedded) |-| Ingest | OTLP/HTTP (Protobuf + JSON) for traces, metrics, logs |+| Component | Technology |+| ------------- | ----------------------------------------------------- |+| Backend | Go 1.25, Gin |+| Frontend | SvelteKit 2, Svelte 5, Tailwind CSS v4 |+| Telemetry DB | ClickHouse (standalone) or SQLite (embedded) |+| Relational DB | PostgreSQL (standalone) or SQLite (embedded) |+| Ingest | OTLP/HTTP (Protobuf + JSON) for traces, metrics, logs |## Project Structure-| Directory | Description |-|-----------|-------------|-| `backend/` | Go/Gin API server — OTLP ingest, REST API, notifications, migrations |-| `frontend/` | SvelteKit 2 dashboard SPA |-| `docs/` | Documentation site (Nextra) |+| Directory | Description |+| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |+| `backend/` | Go/Gin API server — OTLP ingest, REST API, notifications, migrations |+| `frontend/` | SvelteKit 2 dashboard SPA |+| `docs/` | Documentation site (Nextra) || `examples/` | Working examples — [embedded mode](./examples/embedded-backend-otel) and OTel-instrumented apps ([Express](./examples/express-otel), [NestJS](./examples/nestjs-otel), [Next.js](./examples/nextjs-otel), [Hono](./examples/hono-otel)) |-| `website/` | Landing page |+| `website/` | Landing page |## Build Tags-| Tag | Purpose |-|-----|---------|-| *(none)* | SQLite storage — embedded mode, zero dependencies. This is the default. |-| `pgch` | ClickHouse + PostgreSQL storage — standalone server mode. |+| Tag | Purpose |+| ----------- | --------------------------------------------------------------------------------------------------------------- |+| _(none)_ | SQLite storage — embedded mode, zero dependencies. This is the default. |+| `pgch` | ClickHouse + PostgreSQL storage — standalone server mode. || `localdist` | Embeds frontend from `static/dist/` instead of `static/frontend/`. Used by traceway-cloud to inject billing UI. |```bash