From 06357f53cf5748db877c42a79b269e1e47cc8ba5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sanja=20Malovi=C4=87?= Date: Sun, 19 Jul 2026 14:10:14 +0200 Subject: [PATCH] docs: mark Performance, Releases, and search as shipped Reflect v1.16/v1.17 capabilities in READMEs, ROADMAP, and /docs/dashboard. Co-authored-by: Cursor --- CHANGELOG.md | 2 + README.de.md | 10 ++- README.es.md | 10 ++- README.md | 10 ++- apps/dashboard/app/docs/dashboard/page.tsx | 89 +++++++++++++++++++--- docs/ROADMAP.md | 24 +++--- 6 files changed, 112 insertions(+), 33 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 88fd5e85..21ed11c4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,8 @@ Contributors: add user-facing changes under **[Unreleased]** in your PR to `deve ### Changed +- **Docs** — mark Performance / Web Vitals, Releases, and Global search as shipped in README (EN/DE/ES) and site `/docs/dashboard`; mark roadmap milestones v1.16.x and v1.17.x as shipped + ### Database --- diff --git a/README.de.md b/README.de.md index d75db504..9acfef14 100644 --- a/README.de.md +++ b/README.de.md @@ -52,6 +52,9 @@ | Fehler | ✅ | | Events | ✅ | | Sessions | ✅ | +| Performance / Web Vitals | ✅ | +| Releases | ✅ | +| Globale Suche | ✅ | | Organisationen | ✅ | | Projekte | ✅ | | API-Keys | ✅ | @@ -61,7 +64,8 @@ | Self-hosted | ✅ | | Hosted cloud ([telemetry-tracker.com](https://telemetry-tracker.com)) | ✅ | | Zahlungspläne (Free / Pro / Business, in EUR) | ✅ | -| Benachrichtigungen | ✅ | +| Benachrichtigungen (Notifications & Kanäle) | ✅ | +| Alert-Regeln (Bedingungen & Ziele) | ✅ | | Source Maps | ✅ | Self-Hosting-Einrichtung: [DEPLOYMENT.md](DEPLOYMENT.md) @@ -203,13 +207,12 @@ Die bereits verfügbaren Funktionen befinden sich oben unter **[Features](#featu | **In Entwicklung** | Als *Coming soon* gekennzeichnet; Zeitpunkt und Umfang noch offen |
-Geplant & in Entwicklung (11 Bereiche — Observierung, Plattform, Konto) +Geplant & in Entwicklung (9 Bereiche — Observierung, Plattform, Konto) ### Observierung | Bereich | Status | |---------|--------| -| [Performance / Web Vitals](https://github.com/Telemetry-Tracker/telemetry-tracker/issues/99) | Geplant | | Traces | In Entwicklung | | Logs | In Entwicklung | @@ -218,7 +221,6 @@ Die bereits verfügbaren Funktionen befinden sich oben unter **[Features](#featu | Bereich | Status | |---------|--------| | Benutzerdefinierte Dashboards | Geplant | -| Releases | In Entwicklung | | Feature Flags | In Entwicklung | | Exportberichte | In Entwicklung | diff --git a/README.es.md b/README.es.md index a6be53e8..d3f8e33b 100644 --- a/README.es.md +++ b/README.es.md @@ -52,6 +52,9 @@ | Errores | ✅ | | Eventos | ✅ | | Sesiones | ✅ | +| Rendimiento / Web Vitals | ✅ | +| Lanzamientos (Releases) | ✅ | +| Búsqueda global | ✅ | | Organizaciones | ✅ | | Proyectos | ✅ | | API keys | ✅ | @@ -61,7 +64,8 @@ | Autoalojado | ✅ | | Nube alojada ([telemetry-tracker.com](https://telemetry-tracker.com)) | ✅ | | Planes de pago (Gratis / Pro / Business, EUR mediante Stripe) | ✅ | -| Alertas | ✅ | +| Alertas (notificaciones y canales) | ✅ | +| Reglas de alerta (condiciones y destinos) | ✅ | | Source maps | ✅ | Configuración autoalojada: [DEPLOYMENT.md](DEPLOYMENT.md) @@ -203,13 +207,12 @@ Las funcionalidades ya implementadas se encuentran en **[Características](#cara | **En exploración** | Etiquetado como *Próximamente* en el producto; fecha y alcance por definir |
-Planificado y en exploración (11 áreas — Observabilidad, Plataforma, Cuenta) +Planificado y en exploración (9 áreas — Observabilidad, Plataforma, Cuenta) ### Observabilidad | Área | Estado | |------|--------| -| Rendimiento / Web Vitals | Planificado | | Trazas | En exploración | | Logs | En exploración | @@ -218,7 +221,6 @@ Las funcionalidades ya implementadas se encuentran en **[Características](#cara | Área | Estado | |------|--------| | Paneles personalizados | Planificado | -| Lanzamientos | En exploración | | Feature flags | En exploración | | Exportar informes | En exploración | diff --git a/README.md b/README.md index a0c2d8a7..f70921af 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,9 @@ | Errors | ✅ | | Events | ✅ | | Sessions | ✅ | +| Performance / Web Vitals | ✅ | +| Releases | ✅ | +| Global search | ✅ | | Organizations | ✅ | | Projects | ✅ | | API keys | ✅ | @@ -61,7 +64,8 @@ | Self-hosted | ✅ | | Hosted cloud ([telemetry-tracker.com](https://telemetry-tracker.com)) | ✅ | | Paid plans (Free / Pro / Business, EUR via Stripe) | ✅ | -| Alerting | ✅ | +| Alerting (notifications & channels) | ✅ | +| Alert rules (conditions & destinations) | ✅ | | Source maps | ✅ | Self-host setup: [DEPLOYMENT.md](DEPLOYMENT.md) @@ -203,13 +207,12 @@ Shipped capabilities are in **[Features](#features)** above. What follows is **p | **Exploring** | Labeled *Coming soon* in the product; timing and scope TBD |
-Planned & exploring (11 areas — Observability, Platform, Account) +Planned & exploring (9 areas — Observability, Platform, Account) ### Observability | Area | Status | |------|--------| -| [Performance / Web Vitals](https://github.com/Telemetry-Tracker/telemetry-tracker/issues/99) | Planned | | Traces | Exploring | | Logs | Exploring | @@ -218,7 +221,6 @@ Shipped capabilities are in **[Features](#features)** above. What follows is **p | Area | Status | |------|--------| | Custom dashboards | Planned | -| Releases | Exploring | | Feature flags | Exploring | | Export reports | Exploring | diff --git a/apps/dashboard/app/docs/dashboard/page.tsx b/apps/dashboard/app/docs/dashboard/page.tsx index 4899f261..edee94b8 100644 --- a/apps/dashboard/app/docs/dashboard/page.tsx +++ b/apps/dashboard/app/docs/dashboard/page.tsx @@ -4,7 +4,8 @@ import { DocsArticle } from "@/app/components/docs/DocsArticle"; export const metadata: Metadata = { title: "Dashboard — Docs — Telemetry Tracker", - description: "Overview, errors, events, and sessions in the Telemetry Tracker UI", + description: + "Overview, errors, events, sessions, performance, releases, search, compare, and alerts in the Telemetry Tracker UI", }; export default function DocsDashboardPage() { @@ -14,7 +15,7 @@ export default function DocsDashboardPage() { lede={

The web app is your control plane: filter by app and time, drill from trends into error - groups, and inspect sessions end to end. + groups, inspect sessions end to end, and monitor releases and Web Vitals.

} > @@ -27,7 +28,7 @@ export default function DocsDashboardPage() { In your app: init({ ingestUrl, app, apiKey }) — see{" "} SDK docs. -
  • Confirm data on Overview, Errors, Events, and Sessions.
    • +
  • Confirm data on Overview, Errors, Events, Sessions, Performance, and Releases.
    • @@ -44,9 +45,10 @@ export default function DocsDashboardPage() {

    Time range

    - Overview, Errors, Events, and Sessions share a Time range{" "} - picker. Leave it unselected to show the latest rows regardless of age (sorted and paginated). - To narrow results, choose a preset, enter a custom relative window (for example{" "} + Overview, Errors, Events, Sessions, Performance, Releases, and Search share a{" "} + Time range picker. Leave it unselected to show + the latest rows regardless of age (sorted and paginated). To narrow results, choose a + preset, enter a custom relative window (for example{" "} 2h or 8w ), or pick an absolute From /{" "} To date range. @@ -66,11 +68,23 @@ export default function DocsDashboardPage() {

    +
    +

    Compare periods

    +

    + Overview, Errors, Events, Sessions, and Performance support an explicit{" "} + Compare mode. Pick a calendar preset (for + example Today vs Yesterday, this week vs last week, this month vs last month; UTC) or equal- + duration custom ranges. Deltas show as New / — when there is no prior baseline. Releases + uses release-vs-previous “New” handling for first-seen versions. +

    +
    +

    Overview

    - High-level counts and trends, plus top error groups and top event names. Use the time range - picker and app/environment filters to narrow scope. + High-level counts and trends, plus top error groups, top event names, recent releases, and + a Performance / Web Vitals snapshot. Use the time range picker and app/environment filters + to narrow scope.

    @@ -91,13 +105,70 @@ export default function DocsDashboardPage() {

    -
    +

    Sessions

    Sessions group activity by session id and optional identity. Filter by time range, then use the list to jump into a single session’s timeline and metadata.

    + +
    +

    Performance / Web Vitals

    +

    + The Performance page summarizes Core Web + Vitals (LCP, INP/FID, CLS, TTFB) with Good / Needs improvement / Poor ratings, distribution + bars, and trend charts. Tables list slowest{" "} + $request routes (method, path, count, p50/p95, + error rate) and slowest $web_vital pages (path, + LCP p75, CLS, samples), with deep links back to Events. Overview also shows a scoped + vitals snapshot with a link into the full report. +

    +
    + +
    +

    Releases

    +

    + The Releases page lists versions seen in your + telemetry with health signals (errors, sessions, and related activity) for the selected + time range and filters. Use it to spot regressions after a deploy and jump into scoped + Errors / Events / Sessions for that release. +

    +
    + +
    +

    Global search

    +

    + Search finds issues, events, sessions, + releases, and users in the current project. Use free text and optional{" "} + key:value filters (for example{" "} + environment:production,{" "} + release:…, browser, country, device, platform, + error, user, range). Results are grouped by type with links to open the matching list + views. +

    +
    + +
    +

    Alerts & alert rules

    +

    + Alerts covers notification delivery: email + recipients, webhook / Slack / Discord / Teams / Telegram channels, recent alert events, + and delivery history. Alert rules decide{" "} + when to fire (conditions, thresholds, cooldowns) and which destinations to bind. + Built-in error-spike and quota rules ship as system-managed rules; you can add custom + rules for project-specific thresholds. See also{" "} + + Alert rules docs + + . +

    +
    ); } diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index b128bb8d..334fca95 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,6 +1,6 @@ # Telemetry Tracker roadmap milestones -Future product lines after the shipped **v1.13.x — Dashboard UX**, **v1.14.x — Notifications**, and **v1.15.x — Alert Rules** lines. +Future product lines after the shipped **v1.13.x — Dashboard UX**, **v1.14.x — Notifications**, **v1.15.x — Alert Rules**, **v1.16.x — Release Intelligence**, and **v1.17.x — Performance Intelligence** lines. > **Version note:** The thematic roadmap originally drafted Notifications as `v1.13.x`, but that line number was already used for Dashboard UX (`v1.13.0`–`v1.13.2`). Notifications therefore started at **`v1.14.x`**, with later themes shifted by one. @@ -9,15 +9,15 @@ Roadmap **priorities** (P3–P9, etc.) remain independent of release numbering. ## Progression ```text -v1.13.x Dashboard UX (shipped) +v1.13.x Dashboard UX (shipped) ↓ -v1.14.x Notifications (shipped) +v1.14.x Notifications (shipped) ↓ -v1.15.x Alert Rules (shipped) +v1.15.x Alert Rules (shipped) ↓ -v1.16.x Release Intelligence +v1.16.x Release Intelligence (shipped) ↓ -v1.17.x Performance Intelligence +v1.17.x Performance Intelligence (shipped) ↓ v1.18.x AI Intelligence ↓ @@ -33,8 +33,8 @@ v1.20.x Data & Export | [v1.13.x — Dashboard UX](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/12) | Nav/rename/ATF polish | Shipped (#480, #482, #484, #486, …) | | [v1.14.x — Notifications](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/17) | Operational awareness | Shipped — parent #492; children #508, #499, #223, #224, #225, #500, … | | [v1.15.x — Alert Rules](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/18) | When & where to notify | Shipped — parent #493; children #532–#536 (foundation, UX, conditions + cron, built-ins, release) | -| [v1.16.x — Release Intelligence](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/19) | Release health + search | #453, #494 | -| [v1.17.x — Performance Intelligence](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/20) | Compare + performance UX | #495, #197, #196 | +| [v1.16.x — Release Intelligence](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/19) | Release health + search | Shipped — #453, #494 | +| [v1.17.x — Performance Intelligence](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/20) | Compare + performance UX | Shipped — #495, #196, #197 | | [v1.18.x — AI Intelligence](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/21) | Grounded AI summaries | #496 | | [v1.19.x — Organization Management](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/22) | Org defaults + PII | #497, #477, #476 | | [v1.20.x — Data & Export](https://github.com/Telemetry-Tracker/telemetry-tracker/milestone/23) | Export & share | #498 | @@ -49,13 +49,13 @@ Know immediately when something important happens. Notification Center, email fa Decide when notifications should be generated and where they should be delivered. See [ALERT-RULES.md](./ALERT-RULES.md). Ops: schedule the [alert-rules-evaluator cron](./RAILWAY.md#alert-rules-evaluator-cron) for non-ingest conditions. -### v1.16.x — Release Intelligence +### v1.16.x — Release Intelligence (shipped) -Understand release health and find telemetry across releases, errors, events, and sessions. +Understand release health and find telemetry across releases, errors, events, and sessions. Releases page plus Global search (#453, #494). -### v1.17.x — Performance Intelligence +### v1.17.x — Performance Intelligence (shipped) -Understand whether application health is improving or regressing over time. +Understand whether application health is improving or regressing over time. Compare periods, Performance / Web Vitals (including Overview card), and slow routes / pages (#495, #196, #197). ### v1.18.x — AI Intelligence