Dartastic OTel Reference Demo
可直接运行的Flutter应用,展示Dartastic的每一项功能,所有配置均已完成。运行它们,端到端地看到Dartastic的实际效果,然后阅读代码,照着使用。
它是开源Dart OTel Reference Demo的增强商业版,包含多得多的演示。每个应用都从您的Dartastic Pub解析package,并将数据发送到您的Observatory,因此演示一旦运行成功,就证明您的账号可以正常工作。
下载
登录Control Room,按下每个界面顶部、“Help”旁边的Reference Demo:

它会下载dartastic-otel-reference-demo-<version>.tar.gz。将其解压到您存放代码的位置:
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*顶层的README.md是完整指南。按下面的步骤即可完成首次运行。
在Dedicated上:指向您的服务器
演示默认指向Dartastic Cloud,因此在Cloud上这里无需任何操作。在Dedicated上,请用您的子域名运行一次:
tool/set-hosted-slug.sh <subdomain>它会将您的子域名写入.env(git会忽略该文件),并更新各个pubspec。用另一个子域名再次运行即可切换,用""运行则切回Cloud。
所需的令牌
在Control Room的Tokens界面逐一生成。每个令牌只显示一次,因此请在生成时复制。
| 令牌 | 用途 |
|---|---|
Pub令牌dart pub token add(一次) | 所有演示:flutter pub get从您的Dartastic Pub解析package。 |
OTLP令牌OTEL_EXPORTER_OTLP_HEADERS | 所有演示:应用将遥测数据发送到您的Observatory。 |
Symbolizer令牌DARTASTIC_SYMBOLIZER_TOKEN | 仅用于symbolizer_demo_flutter。 |
除symbolizer_demo_flutter和crash_demo_flutter外,所有演示只需只读Pub令牌;这两个演示会发布到您的Pub,需要读写令牌。入门指南介绍了如何添加Pub令牌并导出其他令牌。
请在shell中导出令牌,而不要写入.env:共享或提交到代码库的.env是密钥泄露的常见途径。
运行演示
演示是一个Flutter工作区,因此可在其顶层文件夹一次性获取所有应用的package:
flutter pub get如果成功,说明您的Dartastic Pub和Pub令牌可用。然后启动一个应用;tool/launch.sh会询问在哪台设备上运行:
tool/launch.sh --list # every demo app
tool/launch.sh # weather_flutter
tool/launch.sh rum_demo_flutter- 只有
weather_flutter和all_demos_flutter需要Docker:它们会在您的电脑上启动天气API,展示一条贯穿应用和服务器的链路。 - 演示可在Android、iOS、macOS、Windows和Linux的真机和模拟器上运行,不支持Web。
包含哪些内容
| 应用 | 展示内容 |
|---|---|
weather_flutter | 一次点击的端到端追踪:应用、天气API、其缓存和外部天气服务,都在同一条链路中。 |
all_demos_flutter | 几乎所有演示都以标签页的形式集中在一个应用中。 |
rum_demo_flutter | 会话、屏幕浏览、点击和受挫信号,以及会话回放。 |
crash_demo_flutter | 即使应用终止,崩溃也会被记录并送达。 |
symbolizer_demo_flutter | 一个混淆后的发布构建版本,其调用栈还原为您的文件和行号,卡顿也能追溯到具体widget。 |
anr_demo_flutter | 应用无响应(ANR)检测。 |
pii_demo_flutter | 让个人信息远离您的遥测数据。 |
webview_demo_flutter | 来自应用内网页的遥测数据,并入应用的链路。 |
| 平台关键指标 | 版本健康度、Android Vitals、iOS MetricKit、应用启动、设备状态、发热状态、网络不稳定、用户体验和Linux服务器关键指标,各有一个应用。 |
每个应用都链接到它发送到您Observatory中的数据。要学习某项功能,先运行对应的应用,再阅读其代码:它是该功能最小的可用示例。也可以让您的AI编程助手参考它。
您在Observatory中看到的内容
以下界面来自一次演示运行。您自己运行时数值会有所不同,但每个界面展示的内容相同。
帧构建时间

版本健康度

应用启动

网络不稳定

Interaction to Next Paint

First Contentful Paint

应用无响应(事件)

应用无响应(时长)

iOS MetricKit应用退出
