The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
Logs docs and website updated
narrow-adventure65c6db6c5b73
diff --git a/docs/pages/learn/logs.mdx b/docs/pages/learn/logs.mdxindex aa73eed9..752216e8 100644--- a/docs/pages/learn/logs.mdx+++ b/docs/pages/learn/logs.mdx@@ -2,6 +2,8 @@Logs are time-stamped records emitted by your application as it runs. Traceway ingests OpenTelemetry logs via OTLP/HTTP, indexes them by body, severity, service, trace, and attributes, and links each log back to the trace and span that produced it.+<img src="/logs/logs-overview.png" alt="The Logs page" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />+## Log Record StructureEach log record contains the following fields:@@ -34,6 +36,10 @@ Traceway supports six severity levels, matching the OpenTelemetry specification:If your SDK sends only a severity number (no text), Traceway assigns the text level based on the number's range. If it sends only a text level, the number is computed from the text.+The severity dropdown on the Logs page filters by threshold. Picking `WARN+` keeps warnings and everything more severe.++<img src="/logs/logs-severity-filter.png" alt="Severity threshold dropdown" style={{ maxWidth: '560px', width: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />+## Attributes: Resource, Scope, LogOTel logs carry three layers of attributes, all of which are indexed and searchable in Traceway:@@ -42,8 +48,26 @@ OTel logs carry three layers of attributes, all of which are indexed and searcha- **Scope attributes** describe the instrumentation library or logger emitting the record — e.g. `logger.name`, scope `version`. Useful for separating framework logs from application logs.- **Log attributes** are specific to a single log record — e.g. `user.id`, `order.id`, `request.method`. These are the per-event details you add when logging.+Click any log row to expand it. The expanded view shows the raw body, the linked trace and span IDs, and every attribute from all three layers. Each attribute has a filter toggle, so you can pivot from a single log line to all logs sharing that value in one click.++<img src="/logs/logs-expanded-row.png" alt="Expanded log row with attributes" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />+See [Attributes](/learn/attributes) for the general model used across traces, spans, and logs.+## Message Templates++Many logging libraries send structured message templates instead of pre-rendered strings. The body keeps placeholders like `{Provider}`, and the values arrive as log attributes. This is the default in Serilog and `Microsoft.Extensions.Logging`, and other ecosystems use the same convention.++Traceway renders these templates inline. Each placeholder is resolved against the log's attributes and the value is highlighted in the message. Hover a highlighted value to see the parameter name it came from.++<img src="/logs/logs-template-tooltip.png" alt="A templated log message with the parameter name shown in a tooltip" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />++A few details:++- Alignment and format specs are understood, so `{ElapsedMs:N0}` resolves to its attribute value.+- The `@` and `$` operator prefixes from Serilog-style templates are supported.+- A placeholder with no matching attribute stays as literal text, like `{MaxAttempts}` in the row above. Nothing is silently dropped.+## Searching LogsThe **Logs** page supports filtering and search across all three attribute layers plus the body:@@ -52,10 +76,34 @@ The **Logs** page supports filtering and search across all three attribute layer- **Service** — exact match on `service.name`.- **Trace** — exact match on the hex trace ID, or on a Traceway distributed trace ID (returns logs from every linked trace).- **Body search** — full-text search over the log message. Single-token queries use a token-bloom index for speed; multi-word or punctuation-heavy queries fall back to substring matching.-- **Attribute filters** — exact match on any `resource.*`, `scope.*`, or log attribute key.+- **Attribute filters** — match on any `resource.*`, `scope.*`, or log attribute key, either as equals or not equals.- **Time range** — pick from presets (24h, 7d, 30d) or a custom window.-All filters combine, and results paginate.+All filters combine. Results load newest first, and a "Load more" button at the end of the list fetches older records in the same query.++### Attribute Filters++Click **Add filter** to open the filter dialog. Enter a key with its layer prefix, pick the operator, and set the value. The **Not equals** operator excludes matching logs, which is useful for muting a noisy logger or a known-chatty endpoint.++<img src="/logs/logs-filter-dialog-negative.png" alt="Attribute filter dialog with the Not equals operator selected" style={{ maxWidth: '520px', width: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />++Active filters show as pills under the search bar. Exclusion pills render the operator in red. Click a pill to edit it, or its X to remove it.++<img src="/logs/logs-filter-pills-zoom.png" alt="Filter pills, one equals and one not equals" style={{ maxWidth: '700px', width: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />++## Live Tail++The **Live** button next to the time range picker turns the Logs page into a live tail. While it is on, Traceway polls for new records every few seconds and prepends them to the list, so you can watch logs arrive as you exercise your system.++<img src="/logs/logs-live-button-zoom.png" alt="The Live button, active" style={{ maxWidth: '400px', width: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />++A few details worth knowing:++- Live tail works with preset ranges only. A custom range is a fixed window in the past, so there is nothing to tail.+- The list is pinned to newest first. Changing the sort stops the tail.+- All active filters apply to the tail, so you can live-follow a single service or severity.+- If you scroll down to read, the view holds its position while new rows arrive above. Scroll back to the top to follow the newest logs again.+- Under very high log volume the tail jumps ahead to the newest records instead of trying to backfill every line in between.## Linking to Traces@@ -69,7 +117,7 @@ No extra configuration is required — the standard OTel context propagation car## Retention-Logs are stored in ClickHouse with daily partitioning and a 30-day TTL on the timestamp date. Older logs are removed automatically without operator intervention.+Logs are stored in ClickHouse with daily partitioning and a 90-day TTL on the timestamp date. Older logs are removed automatically without operator intervention. Self-hosted deployments on SQLite or DuckDB prune logs after 30 days by default, configurable with `SQLITE_RETENTION_DAYS`.## Sending Logsdiff --git a/docs/public/logs/logs-expanded-row.png b/docs/public/logs/logs-expanded-row.pngnew file mode 100644index 00000000..fdd8a41eBinary files /dev/null and b/docs/public/logs/logs-expanded-row.png differdiff --git a/docs/public/logs/logs-filter-dialog-negative.png b/docs/public/logs/logs-filter-dialog-negative.pngnew file mode 100644index 00000000..94845e73Binary files /dev/null and b/docs/public/logs/logs-filter-dialog-negative.png differdiff --git a/docs/public/logs/logs-filter-pills-zoom.png b/docs/public/logs/logs-filter-pills-zoom.pngnew file mode 100644index 00000000..d20dfc5eBinary files /dev/null and b/docs/public/logs/logs-filter-pills-zoom.png differdiff --git a/docs/public/logs/logs-live-button-zoom.png b/docs/public/logs/logs-live-button-zoom.pngnew file mode 100644index 00000000..dc474273Binary files /dev/null and b/docs/public/logs/logs-live-button-zoom.png differdiff --git a/docs/public/logs/logs-overview.png b/docs/public/logs/logs-overview.pngnew file mode 100644index 00000000..e2ca3bf6Binary files /dev/null and b/docs/public/logs/logs-overview.png differdiff --git a/docs/public/logs/logs-severity-filter.png b/docs/public/logs/logs-severity-filter.pngnew file mode 100644index 00000000..8a2cab15Binary files /dev/null and b/docs/public/logs/logs-severity-filter.png differdiff --git a/docs/public/logs/logs-template-tooltip.png b/docs/public/logs/logs-template-tooltip.pngnew file mode 100644index 00000000..ccd810b0Binary files /dev/null and b/docs/public/logs/logs-template-tooltip.png differdiff --git a/frontend/src/routes/logs/+page.svelte b/frontend/src/routes/logs/+page.svelteindex 3654fc61..da4d0f0b 100644--- a/frontend/src/routes/logs/+page.svelte+++ b/frontend/src/routes/logs/+page.svelte@@ -1,5 +1,5 @@<script lang="ts">- import { onMount, onDestroy } from 'svelte';+ import { onMount, onDestroy, tick } from 'svelte';import { browser } from '$app/environment';import { goto } from '$app/navigation';import { api } from '$lib/api';@@ -70,7 +70,13 @@let expandedId = $state<string | null>(null);const pageSize = 50;+ // total counts the fixed history window (lastFromISO..lastToISO) as reported+ // by the backend; liveExtra counts live-prepended rows newer than lastToISO.+ // Keeping them separate stops loadMore's total refresh from erasing the live+ // rows out of "Showing X of Y".let total = $state(0);+ let liveExtra = $state(0);+ const displayTotal = $derived(total + liveExtra);let loadedPages = 1;let loadingMore = $state(false);let loadMoreError = $state('');@@ -110,7 +116,10 @@// Windowed rendering: only rows near the viewport are mounted, spacer rows// keep the scrollbar honest. Row height is measured from the first rendered- // row; the (single) expanded row's extra height is measured separately.+ // row; the (single) expanded row's extra height is measured separately and+ // folded into the offset math piecewise. INVARIANT: every collapsed row must+ // render at the same height — all cells truncate to one line today; a cell+ // that wraps would desync the spacer math and make the scrollbar drift.const OVERSCAN = 10;let scrollEl = $state<HTMLDivElement | null>(null);let scrollTop = $state(0);@@ -545,6 +554,7 @@if (gen !== requestGen) return;logs = response.data || [];total = response.pagination.total;+ liveExtra = 0;scrollEl?.scrollTo({ top: 0 });scrollTop = 0;} catch (e: any) {@@ -622,16 +632,44 @@// Restart the view from the newest rows instead of prepending// across a hole. Moving lastToISO up and treating the buffer as// the first LIVE_PAGE_SIZE/pageSize pages keeps "Load more"- // offsets aligned with the new tail.+ // offsets aligned with the new tail. The poll-window total+ // undercounts the widened history window; the next loadMore+ // refreshes it.logs = response.data;total = response.pagination.total;+ liveExtra = 0;lastToISO = toISO;loadedPages = LIVE_PAGE_SIZE / pageSize;scrollEl?.scrollTo({ top: 0 });scrollTop = 0;} else if (fresh.length > 0) {- logs = [...fresh, ...logs].slice(0, MAX_ROWS);- total += fresh.length;+ const merged = [...fresh, ...logs];+ if (merged.length > MAX_ROWS) {+ // Outside the replace branch the buffer is a contiguous+ // newest-first run, so after truncation it is exactly the+ // newest MAX_ROWS of (lastFromISO, toISO]. Re-anchor the+ // "Load more" window to that tail so the next page follows+ // it instead of leaving a hole where the dropped rows were.+ logs = merged.slice(0, MAX_ROWS);+ lastToISO = toISO;+ loadedPages = MAX_ROWS / pageSize;+ total += liveExtra + fresh.length;+ liveExtra = 0;+ } else {+ logs = merged;+ liveExtra += fresh.length;+ }+ // Keep the rows the user is looking at pinned in place while+ // new rows grow the list above them; at the very top, stay+ // pinned to the newest row instead.+ if (scrollTop > 0 && scrollEl) {+ const target = scrollTop + fresh.length * rowH;+ tick().then(() => {+ if (!scrollEl) return;+ scrollEl.scrollTop = target;+ scrollTop = scrollEl.scrollTop;+ });+ }}liveSinceMs = nowMs;} catch (e) {@@ -1068,7 +1106,7 @@<Table.Row class="hover:bg-transparent"><Table.Cell colspan={5}><div class="flex items-center justify-center gap-3 py-1">- {#if logs.length < total}+ {#if logs.length < displayTotal}<Button variant="outline" size="sm" onclick={loadMore} disabled={loadingMore}>{loadingMore ? 'Loading…' : `Load ${pageSize} more`}</Button>@@ -1077,7 +1115,7 @@<span class="text-xs text-red-500">{loadMoreError}</span>{/if}<span class="text-xs text-muted-foreground">- Showing {logs.length.toLocaleString()} of {total.toLocaleString()} logs+ Showing {logs.length.toLocaleString()} of {displayTotal.toLocaleString()} logs</span></div></Table.Cell>diff --git a/website/app/product/logs/page.tsx b/website/app/product/logs/page.tsxindex 2a0f4377..b44dcf8d 100644--- a/website/app/product/logs/page.tsx+++ b/website/app/product/logs/page.tsx@@ -1,4 +1,5 @@import Link from "next/link";+import Image from "next/image";import { ArrowRight, ScrollText, Network, Boxes } from "lucide-react";import { Chip } from "@/components/chip";@@ -9,54 +10,192 @@ import { FaqList } from "@/components/faq-list";import { FinalCTA } from "@/components/final-cta";import { AuroraBackground } from "@/components/aurora-background";+function Shot({+ src,+ alt,+ width,+ height,+}: {+ src: string;+ alt: string;+ width: number;+ height: number;+}) {+ return (+ <div+ className="rounded-[12px] overflow-hidden bg-white"+ style={{ border: "1px solid var(--hair)", boxShadow: "0 16px 48px rgba(15, 23, 42, 0.14)" }}+ >+ <Image src={src} alt={alt} width={width} height={height} className="w-full h-auto block" />+ </div>+ );+}+export default function LogsPage() {return (<main className="relative"><section className="hero hero-product relative"><AuroraBackground variant="hero" /><div className="wrap relative z-10">- <Chip>- <ScrollText className="h-3 w-3 inline mr-1" />- Logs- </Chip>- <h1 className="mt-6">- Every log, <em>with its full trace attached.</em>- </h1>- <p className="hero-sub">- Stop jumping between a log viewer and a trace viewer. Search by- severity, service, or attribute, then open the exact request that- produced any log line in one click.- </p>- <div className="hero-cta-row">- <Link href="https://docs.tracewayapp.com/learn/logs" className="btn btn-accent">- Get Started <ArrowRight className="h-4 w-4" />- </Link>- <Link href="https://cloud.tracewayapp.com/register" className="btn btn-ghost">- Try Traceway Cloud- </Link>+ <div className="lg:flex lg:items-center lg:gap-14">+ <div className="shrink-0 lg:w-[44%]">+ <Chip>+ <ScrollText className="h-3 w-3 inline mr-1" />+ Logs+ </Chip>+ <h1 className="mt-6">+ Every log, <em>with its full trace attached.</em>+ </h1>+ <p className="hero-sub">+ Stop jumping between a log viewer and a trace viewer. Search by+ severity, service, or attribute, tail new logs live as they arrive,+ and open the exact request that produced any log line in one click.+ </p>+ <div className="hero-cta-row">+ <Link href="https://docs.tracewayapp.com/learn/logs" className="btn btn-accent">+ Get Started <ArrowRight className="h-4 w-4" />+ </Link>+ <Link href="https://cloud.tracewayapp.com/register" className="btn btn-ghost">+ Try Traceway Cloud+ </Link>+ </div>+ </div>+ <div className="mt-12 lg:mt-0 lg:flex-1">+ <Image+ src="/images/logs-search-and-detail.png"+ alt="Logs search with attribute filters applied"+ width={1600}+ height={900}+ priority+ className="w-full h-auto rounded-[12px]"+ style={{+ border: "1px solid var(--hair-2)",+ boxShadow: "0 24px 80px rgba(0, 0, 0, 0.45)",+ }}+ />+ </div></div></div></section>- {/* Search across every log */}{/* WHITE BAND: feature sections render on white */}<div className="band-light">+ {/* Filtering close-ups */}+ <section className="wrap py-20">+ <SectionHead+ eyebrow="Filters"+ title={+ <>+ Include what matters. <em>Exclude the noise.</em>+ </>+ }+ description="Every filter is a pill you can see, edit, and remove. Flip the operator to not-equals to mute a chatty logger, and set a severity threshold to keep a level and everything above it."+ />+ <div className="max-w-5xl mx-auto">+ <div className="md:flex md:items-start">+ <div className="relative z-0 md:mt-24 md:w-[56%]">+ <Shot+ src="/images/logs-severity-filter.png"+ alt="Severity threshold dropdown"+ width={1148}+ height={748}+ />+ </div>+ <div className="relative z-10 mt-6 md:-ml-[14%] md:mt-0 md:w-[58%]">+ <Shot+ src="/images/logs-filter-dialog-negative.png"+ alt="Attribute filter dialog with the Not equals operator selected"+ width={1024}+ height={760}+ />+ </div>+ </div>+ <div className="relative z-20 mt-6 md:mx-auto md:-mt-12 md:w-[76%]">+ <Shot+ src="/images/logs-filter-pills-zoom.png"+ alt="Filter pills, one equals and one not equals"+ width={1398}+ height={100}+ />+ </div>+ </div>+ </section>++ {/* Live tail */}+ <section className="wrap">+ <FeatureRow+ reverse+ eyebrow="Live tail"+ title={+ <>+ Watch logs arrive <em>in realtime</em>+ </>+ }+ description="Hit Live and the Logs page becomes a live tail. New records stream in at the top every few seconds, with every active filter still applied, so you can follow one service or one severity while you exercise your system."+ bullets={[+ "One click to start tailing, one click to stop",+ "Filters and severity thresholds apply to the tail",+ "Scroll down to read without losing your place",+ "Keeps up under bursts by jumping to the newest records",+ ]}+ >+ <div className="flex items-center justify-center p-10 md:p-16">+ <Image+ src="/images/logs-live-button-zoom.png"+ alt="The Live button, active"+ width={594}+ height={144}+ className="w-full max-w-[420px] h-auto rounded-[10px]"+ style={{+ border: "1px solid var(--hair)",+ boxShadow: "0 16px 48px rgba(0, 0, 0, 0.25)",+ }}+ />+ </div>+ </FeatureRow>+ </section>++ {/* Message templates */}+ <section className="wrap py-20">+ <SectionHead+ eyebrow="Message templates"+ title={+ <>+ Structured logs, <em>rendered like structured logs</em>+ </>+ }+ description="Serilog-style message templates are resolved against each record's attributes. Parameter values are highlighted inline, and hovering one shows the parameter it came from. Placeholders without a matching attribute stay literal, so nothing is hidden."+ />+ <div+ className="rounded-[12px] overflow-hidden bg-white"+ style={{ border: "1px solid var(--hair)" }}+ >+ <Image+ src="/images/logs-template-tooltip.png"+ alt="A templated log message with the parameter name shown in a tooltip"+ width={2620}+ height={152}+ className="w-full h-auto block"+ />+ </div>+ </section>++ {/* Expanded row / detail */}<section className="wrap"><FeatureRow- eyebrow="Search"+ eyebrow="Detail"title={<>- Search across <em>every log</em>+ Expand any line, <em>pivot on anything</em></>}- description="Filter by severity, service, or trace. Full-text search over log bodies is powered by a token index, and any resource, scope, or log attribute can be queried for exact matches."+ description="Click a log to see its raw body, the trace and span that produced it, and every attribute across the resource, scope, and log layers. Each attribute doubles as a filter toggle, so one interesting value becomes a search in a single click."bullets={[- "Body search backed by token indexes",- "Six severity levels: TRACE, DEBUG, INFO, WARN, ERROR, FATAL",- "Attribute filters on resource, scope, and log fields",- "Time-range facet navigation",+ "Raw body with linked trace and span IDs",+ "All three attribute layers in one view",+ "One-click filter pivots from any attribute value",]}- image={{ src: "/images/logs-search-and-detail.png", alt: "Logs search and detail view", width: 1600, height: 1000 }}+ image={{ src: "/images/logs-expanded-row.png", alt: "Expanded log row with attributes", width: 1600, height: 900 }}/></section>@@ -93,7 +232,7 @@ export default function LogsPage() {<p>Send logs from any OTel SDK: Node.js, Python, Go, Java, .NET,PHP. No vendor client needed. OTLP/HTTP supports Protobuf and- JSON, with a 30-day TTL.+ JSON, with a 90-day TTL.</p></BentoCell></BentoGrid>@@ -148,9 +287,13 @@ export default function LogsPage() {</>),},+ {+ q: "Can I tail logs in real time?",+ a: "Yes. The Live button on the Logs page polls for new records every few seconds and streams them into the list, with all of your active filters applied. It works with any preset time range.",+ },{q: "How long are logs retained?",- a: "30 days by default. ClickHouse-backed storage with daily partitioning and TTL, so retention is enforced automatically without manual cleanup.",+ a: "90 days on Traceway Cloud. ClickHouse-backed storage with daily partitioning and TTL, so retention is enforced automatically without manual cleanup. Self-hosted deployments default to 30 days and are configurable.",},{q: "Do logs count toward my event limit?",diff --git a/website/public/images/logs-expanded-row.png b/website/public/images/logs-expanded-row.pngnew file mode 100644index 00000000..fdd8a41eBinary files /dev/null and b/website/public/images/logs-expanded-row.png differdiff --git a/website/public/images/logs-filter-dialog-negative.png b/website/public/images/logs-filter-dialog-negative.pngnew file mode 100644index 00000000..baea8f56Binary files /dev/null and b/website/public/images/logs-filter-dialog-negative.png differdiff --git a/website/public/images/logs-filter-pills-zoom.png b/website/public/images/logs-filter-pills-zoom.pngnew file mode 100644index 00000000..d20dfc5eBinary files /dev/null and b/website/public/images/logs-filter-pills-zoom.png differdiff --git a/website/public/images/logs-live-button-zoom.png b/website/public/images/logs-live-button-zoom.pngnew file mode 100644index 00000000..dc474273Binary files /dev/null and b/website/public/images/logs-live-button-zoom.png differdiff --git a/website/public/images/logs-live-tail.png b/website/public/images/logs-live-tail.pngnew file mode 100644index 00000000..0fc90723Binary files /dev/null and b/website/public/images/logs-live-tail.png differdiff --git a/website/public/images/logs-search-and-detail.png b/website/public/images/logs-search-and-detail.pngindex ea9363ed..a3920504 100644Binary files a/website/public/images/logs-search-and-detail.png and b/website/public/images/logs-search-and-detail.png differdiff --git a/website/public/images/logs-severity-filter.png b/website/public/images/logs-severity-filter.pngnew file mode 100644index 00000000..8a2cab15Binary files /dev/null and b/website/public/images/logs-severity-filter.png differdiff --git a/website/public/images/logs-template-tooltip.png b/website/public/images/logs-template-tooltip.pngnew file mode 100644index 00000000..e7674bfbBinary files /dev/null and b/website/public/images/logs-template-tooltip.png differ