The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
flutter docs
ddux618a9e933c66
diff --git a/docs/pages/client/flutter/index.mdx b/docs/pages/client/flutter/index.mdxindex f7d8fb80..393738ff 100644--- a/docs/pages/client/flutter/index.mdx+++ b/docs/pages/client/flutter/index.mdx@@ -63,6 +63,11 @@ TracewayClient.instance?.captureMessage('User completed onboarding');| `persistToDisk` | `bool` | `true` | Persist pending exceptions to disk so they survive app restarts || `maxLocalFiles` | `int` | `5` | Max exception files stored on disk || `localFileMaxAgeHours` | `int` | `12` | Hours after which unsynced local files are deleted |+| `captureLogs` | `bool` | `true` | Mirror every `print` / `debugPrint` into the rolling log buffer |+| `captureNetwork` | `bool` | `true` | Install `HttpOverrides.global` to record every dart:io HTTP call |+| `captureNavigation` | `bool` | `true` | Record navigation transitions reported by `Traceway.navigatorObserver` |+| `eventsWindow` | `Duration` | `10s` | Rolling window kept in the log/action buffers |+| `eventsMaxCount` | `int` | `200` | Hard cap applied independently to logs and actions |```dartTraceway.run(@@ -122,6 +127,93 @@ When `screenCapture` is set to `true`:- Touch and click positions are rendered as blue circles on the captured frames. These overlays are invisible to the user during normal use.- Recordings appear in the Traceway dashboard alongside the stack trace, giving you full visual context for every error.+## Logs & Actions++Every captured exception ships with the last ~10 seconds of session context, attached to the same session recording as the video. Two independent rolling buffers — **logs** and **actions** — are kept in memory, each capped at 200 entries by default.++### Logs++Every `print` and `debugPrint` line is mirrored into the log buffer via a Zone print override installed by `Traceway.run()`. Console output behaves normally; it just gets a copy.++`dart:developer.log` is **not** captured — it doesn't flow through the Zone print hook.++### Actions++Three kinds of actions are collected:++- **Network** — every dart:io HTTP request (method, URL, status, duration, request/response byte counts). `HttpOverrides.global` is installed by `Traceway.run()`, so this catches `package:http`, Dio, Firebase, and any other library that sits on the dart:io HttpClient on native platforms.+- **Navigation** — push / pop / replace / remove transitions, recorded by `Traceway.navigatorObserver`. Wire it into your app's navigator:++ ```dart+ MaterialApp(+ navigatorObservers: [Traceway.navigatorObserver],+ home: const HomePage(),+ );+ ```++- **Custom** — anything your app records explicitly:++ ```dart+ Traceway.recordAction(+ category: 'cart',+ name: 'add_item',+ data: {'sku': 'SKU-123', 'qty': 2},+ );+ ```++### Wire shape++Logs and actions are sent to the backend inside the same `sessionRecordings` entry that carries the MP4 — they're stored under separate `logs` and `actions` arrays:++```json+{+ "sessionRecordings": [+ {+ "exceptionId": "...",+ "events": [{"type": "flutter_video", "data": "...", "fps": 15}],+ "logs": [+ {"type": "log", "timestamp": "...", "level": "info", "message": "user tapped pay"}+ ],+ "actions": [+ {"type": "navigation", "action": "push", "from": "/", "to": "/cart", "timestamp": "..."},+ {"type": "network", "method": "GET", "url": "...", "statusCode": 200, "durationMs": 86, "timestamp": "..."},+ {"type": "custom", "category": "cart", "name": "add_item", "data": {"sku": "SKU-1"}, "timestamp": "..."}+ ]+ }+ ]+}+```++A session recording entry is created for every captured exception that has any timeline data — even when `screenCapture: false` and there's no video.++### Network capture on Flutter web++`HttpOverrides.global` does not run on Flutter web. Use `TracewayHttpClient` instead — it's a drop-in `http.Client` you can use directly or pass to libraries that accept a custom client (Dio, Chopper, etc.):++```dart+import 'package:traceway/traceway.dart';++final client = TracewayHttpClient();+final res = await client.get(Uri.parse('https://api.example.com/users'));+```++### Disabling channels++Each channel can be turned off individually via `TracewayOptions`:++```dart+Traceway.run(+ connectionString: 'your-token@https://traceway.example.com/api/report',+ options: TracewayOptions(+ screenCapture: true,+ captureLogs: true, // print / debugPrint+ captureNetwork: true, // HttpOverrides+ captureNavigation: true, // NavigatorObserver+ ),+ child: MyApp(),+);+```+## Privacy MaskingUse `TracewayPrivacyMask` to hide sensitive content in screen recordings. Masked regions are applied to the recorded frames only — the user sees no visual change in the live app.diff --git a/website/app/product/flutter-session-replay/page.tsx b/website/app/product/flutter-session-replay/page.tsxindex 60eb231a..843d024f 100644--- a/website/app/product/flutter-session-replay/page.tsx+++ b/website/app/product/flutter-session-replay/page.tsx@@ -6,6 +6,9 @@ import {Terminal as TerminalIcon,MousePointer2,BookOpen,+ Globe,+ Route,+ Bookmark,} from "lucide-react";import { Chip } from "@/components/chip";@@ -193,19 +196,67 @@ export default function FlutterSessionReplayPage() {iconColor="var(--a2)"><p>- Every tap, scroll, and gesture for the last 60 seconds — synced- frame-for-frame with the recording.+ Every tap and gesture rendered onto the recording, frame-synced+ with the last 10 seconds before the crash.</p></BentoCell><BentoCellsize="med"icon={TerminalIcon}- title="Console & exceptions"+ title="Console logs"iconColor="var(--warn)"><p>- <code>print</code> output, caught <code>FlutterError</code>s, and- the full symbolicated stack trace — all stitched to the timeline.+ Every <code>print</code> and <code>debugPrint</code> from the+ last 10 seconds — captured via a Zone hook, no manual wiring.+ Capped at 200 lines.+ </p>+ </BentoCell>+ <BentoCell+ size="med"+ icon={Globe}+ title="HTTP requests"+ iconColor="var(--a1)"+ >+ <p>+ Method, URL, status, duration, and byte counts for every dart:io+ HTTP call. Catches <code>package:http</code>, Dio, Firebase, and+ anything on the platform client — no per-call instrumentation.+ </p>+ </BentoCell>+ <BentoCell+ size="med"+ icon={Route}+ title="Navigation timeline"+ iconColor="var(--a2)"+ >+ <p>+ Every push, pop, and replace from any <code>Navigator</code> —+ attach <code>Traceway.navigatorObserver</code> once and the+ route history rides with every crash.+ </p>+ </BentoCell>+ <BentoCell+ size="med"+ icon={Bookmark}+ title="Custom actions"+ iconColor="var(--warn)"+ >+ <p>+ Tag your own breadcrumbs — <code>cart.add_item</code>,{" "}+ <code>auth.login_succeeded</code> — with{" "}+ <code>Traceway.recordAction</code>. Capped at 200 entries.+ </p>+ </BentoCell>+ <BentoCell+ size="med"+ icon={TerminalIcon}+ title="Full stack trace"+ iconColor="var(--a1)"+ >+ <p>+ Caught <code>FlutterError</code>s and uncaught async exceptions,+ symbolicated and stitched to the same timeline as the replay.</p></BentoCell></BentoGrid>