Skip to content

Commit 65b8dad

Browse files
Fiona2016claude
andcommitted
docs(rum): drop the transient tracking-client caveat
The resource-collection issue it described is being fixed, so documenting it would only churn the page. Removed from both the integration guide and the compatibility limits, zh and en. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent 5feb785 commit 65b8dad

4 files changed

Lines changed: 2 additions & 12 deletions

File tree

‎en/rum/sdk/flutter/compatible.mdx‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Dart class names begin with `Datadog*`, and the site enum is `FlashcatSite` (`.c
3737
|------|----------|------|
3838
| Automatic views | Supported | Requires a `DatadogNavigationObserver` on `MaterialApp` |
3939
| Automatic actions | Supported | Requires wrapping the subtree with `RumUserActionDetector`; `trackFrustrations` is enabled by default |
40-
| Automatic resources | Supported (requires companion package) | Through `enableHttpTracking()` from `flashcat_tracking_http_client`; 0.1.0 has a known issue, see the limits below |
40+
| Automatic resources | Supported (requires companion package) | Through `enableHttpTracking()` from `flashcat_tracking_http_client` |
4141
| Unhandled exceptions | Supported | When using `DatadogSdk.runApp`, automatically takes over `FlutterError.onError` / `PlatformDispatcher.onError` |
4242
| Native crashes | Supported | Requires `nativeCrashReportEnabled: true` |
4343
| Distributed tracing | Supported | Injects W3C `traceparent` for hosts that match `firstPartyHosts` |
@@ -49,7 +49,6 @@ Dart class names begin with `Datadog*`, and the site enum is `FlashcatSite` (`.c
4949
| Platform scope | iOS / Android only; Flutter Web and Desktop are not supported |
5050
| Logs | Log reporting is not supported (`DatadogLoggingConfiguration` is a no-op) |
5151
| Session Replay | Not supported |
52-
| Known resource-collection issue | In `flashcat_tracking_http_client` 0.1.0, a request whose response body is consumed with `drain()` or `asFuture()` produces no resource event — both replace the `onDone` / `onError` handlers the SDK registers. Use `toList()`, `transform()`, or a `listen()` with your own `onDone` to work around it |
5352
| dio / gql / grpc | The corresponding interceptor packages are not supported |
5453
| Page performance metrics | `reportFlutterPerformance` is disabled by default |
5554
| Minimum version | Use `flashcat_flutter_plugin` 0.1.3 or later; on earlier versions `flutter build apk --release` fails in R8 |

‎en/rum/sdk/flutter/sdk-integration.mdx‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,10 +133,6 @@ final configuration = DatadogConfiguration(
133133
)..enableHttpTracking();
134134
```
135135

136-
<Warning>
137-
**Known issue (`flashcat_tracking_http_client` 0.1.0)**: a request produces no resource event if its response body is consumed with `drain()` or `asFuture()`. Both replace the `onDone` / `onError` callbacks the SDK registers on the response stream, so resource collection starts but never finishes — silently, with no error reported. Use `toList()`, `transform()`, or a `listen()` with your own `onDone` instead.
138-
</Warning>
139-
140136
## Identify users
141137

142138
After sign-in, you can set the current user. The SDK writes the user fields to the `usr` object on subsequent RUM events.

‎zh/rum/sdk/flutter/compatible.mdx‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Dart 类名以 `Datadog*` 开头,站点枚举为 `FlashcatSite`(`.cn` 默认
3737
|------|----------|------|
3838
| 自动 view | 支持 | 需为 `MaterialApp` 添加 `DatadogNavigationObserver` |
3939
| 自动 action | 支持 | 需用 `RumUserActionDetector` 包裹子树;`trackFrustrations` 默认开启 |
40-
| 自动 resource | 支持(需伴生包) | 通过 `flashcat_tracking_http_client` 的 `enableHttpTracking()`;0.1.0 存在已知问题,见下方限制 |
40+
| 自动 resource | 支持(需伴生包) | 通过 `flashcat_tracking_http_client` 的 `enableHttpTracking()` |
4141
| 未处理异常 | 支持 | 使用 `DatadogSdk.runApp` 时自动接管 `FlutterError.onError` / `PlatformDispatcher.onError` |
4242
| 原生崩溃 | 支持 | 需 `nativeCrashReportEnabled: true` |
4343
| 分布式追踪 | 支持 | 对 `firstPartyHosts` 命中的域名注入 W3C `traceparent` |
@@ -49,7 +49,6 @@ Dart 类名以 `Datadog*` 开头,站点枚举为 `FlashcatSite`(`.cn` 默认
4949
| 平台范围 | 仅 iOS / Android;Flutter Web 与 Desktop 不支持 |
5050
| Logs | 不支持日志上报(`DatadogLoggingConfiguration` 为空操作) |
5151
| Session Replay | 不支持 |
52-
| resource 采集已知问题 | `flashcat_tracking_http_client` 0.1.0 中,用 `drain()` 或 `asFuture()` 消费响应体的请求不会产生 resource 事件(这两个方法会覆盖 SDK 注册的 `onDone` / `onError`)。改用 `toList()`、`transform()` 或自带 `onDone` 的 `listen()` 可规避 |
5352
| dio / gql / grpc | 对应拦截包暂不支持 |
5453
| 页面性能指标 | `reportFlutterPerformance` 默认关闭 |
5554
| 最低版本 | 请使用 `flashcat_flutter_plugin` 0.1.3 或更高版本;更低版本 `flutter build apk --release` 会失败于 R8 |

‎zh/rum/sdk/flutter/sdk-integration.mdx‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,10 +133,6 @@ final configuration = DatadogConfiguration(
133133
)..enableHttpTracking();
134134
```
135135

136-
<Warning>
137-
**已知问题(`flashcat_tracking_http_client` 0.1.0)**:若用 `drain()` 或 `asFuture()` 消费响应体,该请求不会产生 resource 事件。这两个方法会覆盖 SDK 注册在响应流上的 `onDone` / `onError` 回调,导致资源采集只开始、不结束,且没有任何报错。改用 `toList()`、`transform()` 或自带 `onDone` 的 `listen()` 可正常上报。
138-
</Warning>
139-
140136
## 关联用户信息
141137

142138
登录后,你可以设置当前用户。SDK 会把用户字段写入后续 RUM 事件的 `usr` 对象。

0 commit comments

Comments
 (0)