Skip to content

The only tool you need to know what is happening and how to fix it.

flutter docs

ddux618a9e933c66
diff --git a/docs/pages/client/flutter/index.mdx b/docs/pages/client/flutter/index.mdx
index 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 |
```dart
Traceway.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 Masking
Use `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.tsx
index 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>
<BentoCell
size="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>