The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
docs and website updated
narrow-adventure8ce2a605da55
diff --git a/docs/pages/learn/dashboards.mdx b/docs/pages/learn/dashboards.mdxindex 6c6a5fb4..1ca59ce2 100644--- a/docs/pages/learn/dashboards.mdx+++ b/docs/pages/learn/dashboards.mdx@@ -6,7 +6,7 @@ Dashboards visualize your metrics as tabs of chart widgets. A dashboard belongs## The Dashboards page-Each tab on the Dashboards page is one dashboard applied to the current project. New projects offer to populate framework-appropriate defaults (host dashboards for OpenTelemetry projects, runtime dashboards for Go and Node.js SDK projects). The active tab's menu holds everything you can do with a dashboard:+Each tab on the Dashboards page is one dashboard applied to the current project. A project with no dashboards yet shows a single **Browse Dashboards & Templates** button that opens the command palette described below. The active tab's menu holds everything you can do with a dashboard:<img src="/dashboards/dashboards-menu.png" alt="Dashboard menu" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />@@ -33,11 +33,13 @@ Templates are ready-made dashboards you install and then customize freely. The m| Template | Category | Source of the metrics || --- | --- | --- |-| Server | server | [Traceway OTel Agent](/learn/otel-agent) host CPU, memory, disk and network metrics |+| OTelemetry Server Agent | server | [Traceway OTel Agent](/learn/otel-agent) host CPU, memory, disk and network metrics || Go Application | go | Go SDK runtime and process metrics (goroutines, heap, GC, CPU, memory) || Traceway ClickHouse | traceway | A monitored Traceway instance's `traceway.ch.*` metrics || Traceway DuckDB | traceway | A monitored Traceway instance's `traceway.duckdb.*` metrics |+<img src="/dashboards/dashboards-palette-templates.png" alt="Templates in the command palette" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />+Widgets can group series by resource tags such as `container.name`, `k8s.pod.name`, `k8s.node.name`, or `postgresql.database.name`, so one widget shows one line per container, pod, node, or database. Point the matching OpenTelemetry Collector receiver at your Traceway project's OTLP endpoint and build widgets on the metrics it reports.## Dashboards as codediff --git a/docs/public/dashboards/dashboards-apply.png b/docs/public/dashboards/dashboards-apply.pngindex ce9c2ea9..d0c5a79e 100644Binary files a/docs/public/dashboards/dashboards-apply.png and b/docs/public/dashboards/dashboards-apply.png differdiff --git a/docs/public/dashboards/dashboards-edit-json.png b/docs/public/dashboards/dashboards-edit-json.pngindex 47ca8c5d..01e60a3d 100644Binary files a/docs/public/dashboards/dashboards-edit-json.png and b/docs/public/dashboards/dashboards-edit-json.png differdiff --git a/docs/public/dashboards/dashboards-grafana-import.png b/docs/public/dashboards/dashboards-grafana-import.pngindex 1857b21b..5994f269 100644Binary files a/docs/public/dashboards/dashboards-grafana-import.png and b/docs/public/dashboards/dashboards-grafana-import.png differdiff --git a/docs/public/dashboards/dashboards-grafana-warnings.png b/docs/public/dashboards/dashboards-grafana-warnings.pngindex a09592e7..cf08f340 100644Binary files a/docs/public/dashboards/dashboards-grafana-warnings.png and b/docs/public/dashboards/dashboards-grafana-warnings.png differdiff --git a/docs/public/dashboards/dashboards-menu.png b/docs/public/dashboards/dashboards-menu.pngindex 4d9601af..aba90a38 100644Binary files a/docs/public/dashboards/dashboards-menu.png and b/docs/public/dashboards/dashboards-menu.png differdiff --git a/docs/public/dashboards/dashboards-new-widget.png b/docs/public/dashboards/dashboards-new-widget.pngindex e3e83f1a..9b189568 100644Binary files a/docs/public/dashboards/dashboards-new-widget.png and b/docs/public/dashboards/dashboards-new-widget.png differdiff --git a/docs/public/dashboards/dashboards-page.png b/docs/public/dashboards/dashboards-page.pngindex 978d6596..e7b0388a 100644Binary files a/docs/public/dashboards/dashboards-page.png and b/docs/public/dashboards/dashboards-page.png differdiff --git a/docs/public/dashboards/dashboards-palette-templates.png b/docs/public/dashboards/dashboards-palette-templates.pngnew file mode 100644index 00000000..99dfa6c0Binary files /dev/null and b/docs/public/dashboards/dashboards-palette-templates.png differdiff --git a/docs/public/dashboards/dashboards-palette.png b/docs/public/dashboards/dashboards-palette.pngindex 891dddec..122d15f9 100644Binary files a/docs/public/dashboards/dashboards-palette.png and b/docs/public/dashboards/dashboards-palette.png differdiff --git a/frontend/src/lib/state/timezone.svelte.ts b/frontend/src/lib/state/timezone.svelte.tsindex 266a4f73..47075fb9 100644--- a/frontend/src/lib/state/timezone.svelte.ts+++ b/frontend/src/lib/state/timezone.svelte.ts@@ -8,5 +8,12 @@ export function getTimezone(): string {const timezone = authState.getTimezoneForOrganization(organizationId);if (timezone) return timezone;}+ // Before the project list resolves there is no current project to pick the+ // organization from. Fall back to the sole organization's timezone so the+ // resolved zone doesn't flip mid-session once projects load — wall-clock+ // state materialized under one zone must not be reinterpreted under another.+ if (authState.organizations.length === 1 && authState.organizations[0].timezone) {+ return authState.organizations[0].timezone;+ }return DateTime.local().zoneName || 'UTC';}diff --git a/frontend/src/routes/+layout.svelte b/frontend/src/routes/+layout.svelteindex 261e0118..35b16759 100644--- a/frontend/src/routes/+layout.svelte+++ b/frontend/src/routes/+layout.svelte@@ -4,6 +4,8 @@import { authState } from '$lib/state/auth.svelte';import { projectsState, type Project } from '$lib/state/projects.svelte';import { themeState, initTheme, toggleTheme } from '$lib/state/theme.svelte';+ import { getTimezone } from '$lib/state/timezone.svelte';+ import { DateTime } from 'luxon';import { incrementNavDepth, decrementNavDepth } from '$lib/utils/back-navigation';import AppSidebar from '$lib/components/app-sidebar.svelte';import AddProjectModal from '$lib/components/add-project-modal.svelte';@@ -12,7 +14,7 @@import FrameworkIcon from '$lib/components/framework-icon.svelte';import * as Sidebar from '$lib/components/ui/sidebar';import { Button } from '$lib/components/ui/button';- import { Sun, Moon, LogOut, Plus, Check, Pencil } from '@lucide/svelte';+ import { Sun, Moon, LogOut, Plus, Check, Pencil, TriangleAlert } from '@lucide/svelte';import { onMount } from 'svelte';import * as DropdownMenu from '$lib/components/ui/dropdown-menu/index.js';import { ChevronDown } from 'lucide-svelte';@@ -52,6 +54,26 @@const bannerOrganizationId = $derived(projectsState.currentProject?.organizationId ?? null);+ // Warn when the browser's timezone renders times differently from the+ // organization's timezone (all timestamps are shown in the org timezone).+ // Compare offsets, not zone names — Europe/Berlin vs Europe/Belgrade is+ // not a mismatch worth warning about.+ const browserZone = Intl.DateTimeFormat().resolvedOptions().timeZone;+ const orgZone = $derived(getTimezone());+ const timezoneMismatch = $derived.by(() => {+ if (!orgZone || orgZone === browserZone) return false;+ const now = Date.now();+ return (+ DateTime.fromMillis(now, { zone: orgZone }).offset !==+ DateTime.fromMillis(now, { zone: browserZone }).offset+ );+ });++ function zoneLabel(zone: string): string {+ if (zone === 'UTC') return 'UTC';+ return `${zone}, UTC${DateTime.now().setZone(zone).toFormat('Z')}`;+ }+const PUBLIC_PATHS = new Set(['/login','/register',@@ -276,6 +298,17 @@</div></header><main class="min-w-0 flex-1 p-4">+ {#if timezoneMismatch}+ <div+ class="mb-4 flex items-start gap-2 rounded-md border border-orange-600/40 bg-orange-500/10 px-3 py-2 text-sm text-orange-700 dark:text-orange-400"+ >+ <TriangleAlert class="mt-0.5 h-4 w-4 shrink-0" />+ <span>+ Your browser's timezone ({zoneLabel(browserZone)}) differs from the organization's+ ({zoneLabel(orgZone)}). All times are shown in the organization's timezone.+ </span>+ </div>+ {/if}{#if CrossSiteNotificationBanner && bannerOrganizationId !== null}<div class="mb-4"><CrossSiteNotificationBanner organizationId={bannerOrganizationId} />diff --git a/frontend/src/routes/dashboards/+page.svelte b/frontend/src/routes/dashboards/+page.svelteindex e874f929..7affc48f 100644--- a/frontend/src/routes/dashboards/+page.svelte+++ b/frontend/src/routes/dashboards/+page.svelte@@ -933,6 +933,24 @@}sharedTimeDomain = [new Date(getFromDateTimeUTC()), new Date(getToDateTimeUTC())];});++ // The resolved timezone can flip from the browser zone to the organization+ // zone once projects finish loading. The wall-clock range state above was+ // materialized under the old zone; re-resolve the preset under the new one+ // or every widget query shifts by the offset difference.+ let lastResolvedTimezone = timezone;+ $effect(() => {+ const tz = timezone;+ if (tz === lastResolvedTimezone) return;+ lastResolvedTimezone = tz;+ if (!selectedPreset) return;+ const range = getTimeRangeFromPreset(selectedPreset, tz);+ fromDate = dateToCalendarDate(range.from, tz);+ toDate = dateToCalendarDate(range.to, tz);+ fromTime = dateToTimeString(range.from, tz);+ toTime = dateToTimeString(range.to, tz);+ sharedTimeDomain = [new Date(getFromDateTimeUTC()), new Date(getToDateTimeUTC())];+ });</script><svelte:window onkeydown={handlePageKeydown} />diff --git a/website/app/product/dashboards/page.tsx b/website/app/product/dashboards/page.tsxnew file mode 100644index 00000000..3b53bec8--- /dev/null+++ b/website/app/product/dashboards/page.tsx@@ -0,0 +1,246 @@+import Link from "next/link";+import { ArrowRight, LayoutDashboard } from "lucide-react";++import { Chip } from "@/components/chip";+import { SectionHead } from "@/components/section-head";+import { FeatureRow } from "@/components/feature-row";+import { FaqList } from "@/components/faq-list";+import { FinalCTA } from "@/components/final-cta";+import { AuroraBackground } from "@/components/aurora-background";++export default function DashboardsPage() {+ return (+ <main className="relative">+ <section className="hero hero-product relative">+ <AuroraBackground variant="hero" />+ <div className="wrap relative z-10">+ <Chip variant="ok">+ <LayoutDashboard className="h-3 w-3 inline mr-1" />+ Dashboards as Code+ </Chip>+ <h1 className="mt-6">+ Dashboards you can <em>diff, review, and ship.</em>+ </h1>+ <p className="hero-sub">+ Every Traceway dashboard is a plain JSON document underneath. Build+ it in the UI, export it to your repo, sync it from CI, and apply it+ across every project in your organization. No click-ops, no drift.+ </p>+ <div className="hero-cta-row">+ <Link+ href="https://docs.tracewayapp.com/learn/dashboards"+ className="btn btn-accent"+ >+ Read the Docs <ArrowRight className="h-4 w-4" />+ </Link>+ <Link+ href="https://cloud.tracewayapp.com/register"+ className="btn btn-ghost"+ >+ Try Traceway Cloud+ </Link>+ </div>+ </div>+ </section>++ {/* WHITE BAND: feature sections render on white */}+ <div className="band-light">+ <section className="wrap">+ <FeatureRow+ eyebrow="Plain JSON"+ title={+ <>+ Every dashboard is <em>one JSON document</em>+ </>+ }+ description="Widgets, sources, aggregations, and layout live in a single versioned document with a schemaVersion. Edit it in place from the dashboard menu, validated on save, or round-trip it through export and import. Widget ids are stable, so homepage stars survive edits."+ bullets={[+ "Edit as JSON directly in the UI, validated on save",+ "Export a dashboard, or your whole organization, as JSON",+ "Widget order in the array is the display order",+ "Stable widget ids keep starred widgets intact",+ ]}+ image={{+ src: "/images/dashboards-edit-json.png",+ alt: "Editing a Traceway dashboard as JSON",+ }}+ />+ </section>++ <section className="wrap">+ <FeatureRow+ reverse+ eyebrow="GitOps"+ title={+ <>+ Keep dashboards <em>in your repository</em>+ </>+ }+ description={+ <>+ The import API has an upsert mode that matches dashboards by+ name, so a CI job is one curl:{" "}+ <code>+ POST /api/dashboards/import{" "}+ {`{"mode": "upsert", "data": ...}`}+ </code>{" "}+ with a personal access token. Review dashboard changes in pull+ requests like any other code, and let the pipeline keep every+ environment in sync.+ </>+ }+ bullets={[+ "Upsert mode matches dashboards by name — safe to re-run",+ "Import a single dashboard or a whole-organization bundle",+ "Authenticate with a personal access token from CI",+ "The UI and the API edit the same document — no drift",+ ]}+ image={{+ src: "/images/dashboards-page.png",+ alt: "The Traceway dashboards page",+ }}+ />+ </section>++ <section className="wrap">+ <FeatureRow+ eyebrow="Shared across projects"+ title={+ <>+ Build once, <em>apply everywhere</em>+ </>+ }+ description="Dashboards belong to your organization, not to a single project. Apply the same dashboard to any set of projects; a fix made in one is instantly live in all of them. Each project still curates its own homepage by starring the widgets it cares about."+ bullets={[+ "One shared definition, per-project tabs",+ "Nothing is copied — edits propagate everywhere",+ "Per-project starred widgets for the homepage",+ "Unapplying only removes it from that project's tabs",+ ]}+ image={{+ src: "/images/dashboards-apply.png",+ alt: "Applying a dashboard to projects",+ }}+ />+ </section>++ <section className="wrap">+ <FeatureRow+ reverse+ eyebrow="Grafana import"+ title={+ <>+ Bring the Grafana dashboards <em>you already have</em>+ </>+ }+ description="Paste any Grafana dashboard JSON export. Timeseries and graph panels become line charts, stat becomes a single value, gauges stay gauges, and Prometheus queries are unwrapped into metric sources with their label matchers and group-bys. Anything that cannot be converted faithfully is reported, not silently dropped."+ bullets={[+ "Panels and Prometheus queries converted automatically",+ "rate() approximations and skipped panels are called out",+ "Imported dashboards are normal dashboards — edit freely",+ ]}+ image={{+ src: "/images/dashboards-grafana-warnings.png",+ alt: "Grafana import with conversion warnings",+ }}+ />+ </section>++ <section className="wrap">+ <FeatureRow+ eyebrow="Templates & ⌘K"+ title={+ <>+ Start from a template, <em>find anything fast</em>+ </>+ }+ description="One command palette covers your organization's dashboards, the built-in template marketplace, and every metric name seen across your projects. Install the OTelemetry Server Agent template for host metrics, Go Application for runtime metrics, or ClickHouse and DuckDB health dashboards for a monitored Traceway instance."+ bullets={[+ "⌘K searches dashboards, templates, and metrics together",+ "Templates install as normal dashboards you customize freely",+ "Selecting a metric opens the widget editor prefilled",+ ]}+ image={{+ src: "/images/dashboards-palette-templates.png",+ alt: "Dashboard templates in the command palette",+ }}+ />+ </section>+ </div>++ <FinalCTA+ title={+ <>+ Observability dashboards <em>without the click-ops</em>+ </>+ }+ description="Plain JSON, org-wide sharing, CI sync, Grafana import. Included on every plan."+ primary={{+ label: "Read the Dashboards docs",+ href: "https://docs.tracewayapp.com/learn/dashboards",+ }}+ secondary={{+ label: "Start Free",+ href: "https://cloud.tracewayapp.com/register",+ }}+ />++ <section className="wrap pt-10 pb-24">+ <div className="max-w-3xl mx-auto">+ <SectionHead+ align="center"+ eyebrow="FAQ"+ title="Questions about dashboards as code"+ />+ <div className="mt-4">+ <FaqList+ items={[+ {+ q: "What does the dashboard JSON look like?",+ a: (+ <>+ <p>+ A dashboard is one document with a{" "}+ <code>schemaVersion</code>, a name, and a{" "}+ <code>widgets</code> array. Each widget carries its+ type (line chart, area, stacked area, bar, single+ value, gauge, table) and one or more sources: a metric+ name, an aggregation, optional tag filters, and an+ optional group-by that splits the chart into one+ series per tag value. Array order is display order.+ </p>+ </>+ ),+ },+ {+ q: "How do I sync dashboards from CI?",+ a: (+ <>+ <p>+ Export the dashboard once, commit the JSON to your+ repo, and have CI post it to{" "}+ <code>/api/dashboards/import</code> with{" "}+ <code>{`"mode": "upsert"`}</code> and a personal access+ token. Upsert matches dashboards by name, so the job+ is idempotent — re-running it converges every+ environment to the file in your repository.+ </p>+ </>+ ),+ },+ {+ q: "What happens when someone edits a dashboard in the UI?",+ a: "The UI edits the exact same JSON document the API serves — there is no separate representation. If you treat your repo as the source of truth, the next CI upsert brings the dashboard back to the committed state; if you prefer UI-first, just export after editing and commit the result.",+ },+ {+ q: "How faithful is the Grafana import?",+ a: "Panels and Prometheus queries are converted on a best-effort basis, and every compromise is reported in the import dialog: rate() approximations, dropped regex matchers, unsupported panel types. You end up with a normal Traceway dashboard you can keep editing, never a black box.",+ },+ ]}+ />+ </div>+ </div>+ </section>+ </main>+ );+}diff --git a/website/app/product/metrics/page.tsx b/website/app/product/metrics/page.tsxindex c47317db..887954e8 100644--- a/website/app/product/metrics/page.tsx+++ b/website/app/product/metrics/page.tsx@@ -93,7 +93,7 @@ export default function MetricsPage() {description="Build a dashboard once and apply it across every project in your organization. Each dashboard is a plain JSON document, so you can edit it as code, keep it in your repo, or import the Grafana dashboards you already have."bullets={["One dashboard, applied across projects",- "Template marketplace: hosts, Docker, Kubernetes, PostgreSQL, Redis",+ "Template marketplace: OTel host agent, Go runtime, ClickHouse, DuckDB","Import existing Grafana dashboards","Search and add anything with ⌘K",]}diff --git a/website/components/site-footer.tsx b/website/components/site-footer.tsxindex 67018c04..4391720a 100644--- a/website/components/site-footer.tsx+++ b/website/components/site-footer.tsx@@ -26,6 +26,7 @@ const COLUMNS: Column[] = [{ label: "Agent Skills", href: "/product/agent-skills" },{ label: "MCP Server", href: "/product/mcp" },{ label: "AI Tracing", href: "/product/ai-tracing" },+ { label: "Dashboards as Code", href: "/product/dashboards" },{ label: "Performance", href: "/product/performance" },{ label: "Flutter Session Replay", href: "/product/flutter-session-replay" },{ label: "Symbolicator", href: "/product/symbolication" },diff --git a/website/components/site-header.tsx b/website/components/site-header.tsxindex 14982319..277115aa 100644--- a/website/components/site-header.tsx+++ b/website/components/site-header.tsx@@ -17,6 +17,7 @@ import {Bot,Braces,Plug,+ LayoutDashboard,} from "lucide-react";import { MobileNav } from "@/components/mobile-nav";import { DiscordIcon } from "@/components/discord-icon";@@ -83,6 +84,12 @@ const SPECIALIZED: NavItem[] = [href: "/product/ai-tracing",icon: Workflow,},+ {+ title: "Dashboards as Code",+ description: "JSON dashboards you version, sync, and share.",+ href: "/product/dashboards",+ icon: LayoutDashboard,+ },{title: "Performance",description: "P50/P95/P99 percentiles, waterfall traces.",diff --git a/website/public/images/dashboards-apply.png b/website/public/images/dashboards-apply.pngnew file mode 100644index 00000000..d0c5a79eBinary files /dev/null and b/website/public/images/dashboards-apply.png differdiff --git a/website/public/images/dashboards-edit-json.png b/website/public/images/dashboards-edit-json.pngnew file mode 100644index 00000000..01e60a3dBinary files /dev/null and b/website/public/images/dashboards-edit-json.png differdiff --git a/website/public/images/dashboards-grafana-warnings.png b/website/public/images/dashboards-grafana-warnings.pngnew file mode 100644index 00000000..cf08f340Binary files /dev/null and b/website/public/images/dashboards-grafana-warnings.png differdiff --git a/website/public/images/dashboards-page.png b/website/public/images/dashboards-page.pngnew file mode 100644index 00000000..e7b0388aBinary files /dev/null and b/website/public/images/dashboards-page.png differdiff --git a/website/public/images/dashboards-palette-templates.png b/website/public/images/dashboards-palette-templates.pngnew file mode 100644index 00000000..99dfa6c0Binary files /dev/null and b/website/public/images/dashboards-palette-templates.png differ