这些页面显示的是Cloud的URL。在Dedicated上登录后,即显示您服务器的URL。

Dartastic OTel Reference Demo

可直接运行的Flutter应用,展示Dartastic的每一项功能,所有配置均已完成。运行它们,端到端地看到Dartastic的实际效果,然后阅读代码,照着使用。

它是开源Dart OTel Reference Demo的增强商业版,包含多得多的演示。每个应用都从您的Dartastic Pub解析package,并将数据发送到您的Observatory,因此演示一旦运行成功,就证明您的账号可以正常工作。

构建DARTASTIC架构用户令牌IssuePub令牌推送CI令牌交换应用发布给用户:应用商店、Web、服务器符号崩溃堆栈源代码遥测数据开发者电脑flutter run · dart pub getCIGitHub Actions、GitLab…Control Room生成令牌 · 基于角色的访问控制控制平面组织 · 角色 · 令牌Dartastic Pubpackage · 源代码Observatory会话 · 链路 · 日志Symbolizer崩溃 → 源代码行Dartastic AI综合两者作答Issue跟踪器GitHub · Jira · Linear移动和桌面应用手机 · 平板 · 电脑使用OTLP令牌发送Web应用运行在浏览器中使用Browser OTLP令牌发送Dart服务器后端 · 服务使用OTLP令牌发送

下载

登录Control Room,按下每个界面顶部、“Help”旁边的Reference Demo:

Control Room顶栏,“Reference Demo”按钮位于“Help”和“Sign Out”旁边

它会下载dartastic-otel-reference-demo-<version>.tar.gz。将其解压到您存放代码的位置:

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

顶层的README.md是完整指南。按下面的步骤即可完成首次运行。

在Dedicated上:指向您的服务器

演示默认指向Dartastic Cloud,因此在Cloud上这里无需任何操作。在Dedicated上,请用您的子域名运行一次:

shell
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:

shell
flutter pub get

如果成功,说明您的Dartastic Pub和Pub令牌可用。然后启动一个应用;tool/launch.sh会询问在哪台设备上运行:

shell
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中看到的内容

以下界面来自一次演示运行。您自己运行时数值会有所不同,但每个界面展示的内容相同。

帧构建时间

all_demos_flutter在flutter.frame.build的“Metric”界面上以热力图显示:四分钟的帧,p95线随运行逐渐升高。
all_demos_flutter在flutter.frame.build的“Metric”界面上以热力图显示:四分钟的帧,p95线随运行逐渐升高。

版本健康度

链路按版本健康度演示的flutter.session Span筛选,每个会话一条。红色的那条是发生崩溃的会话。
链路按版本健康度演示的flutter.session Span筛选,每个会话一条。红色的那条是发生崩溃的会话。

应用启动

flutter.app.startup.duration的“Metric”界面,以热力图显示:三次约2.2秒的冷启动,以及两次分别为33毫秒和63毫秒的热启动。
flutter.app.startup.duration的“Metric”界面,以热力图显示:三次约2.2秒的冷启动,以及两次分别为33毫秒和63毫秒的热启动。

网络不稳定

链路按dartastic.network.flaky = true筛选:两个不稳定的请求,一个耗时6.56秒,另一个耗时114毫秒并以错误结束。
链路按dartastic.network.flaky = true筛选:两个不稳定的请求,一个耗时6.56秒,另一个耗时114毫秒并以错误结束。

Interaction to Next Paint

flutter.experience.inp的“Metric”界面,以热力图显示:八次交互,两次低于16毫秒,六次在200到250毫秒之间。
flutter.experience.inp的“Metric”界面,以热力图显示:八次交互,两次低于16毫秒,六次在200到250毫秒之间。

First Contentful Paint

flutter.experience.fcp的“Metric”界面:一次First Contentful Paint,耗时2.67秒。
flutter.experience.fcp的“Metric”界面:一次First Contentful Paint,耗时2.67秒。

应用无响应(事件)

日志按anr_demo_flutter的dartastic.app.anr事件筛选:三次ANR,由于事件不带严重级别而计入“Unspecified”,每一行都显示其事件名称。
日志按anr_demo_flutter的dartastic.app.anr事件筛选:三次ANR,由于事件不带严重级别而计入“Unspecified”,每一行都显示其事件名称。

应用无响应(时长)

同样三次ANR显示在flutter.anr.duration的“Metric”界面上:导出时,每次时长为6.0至6.6秒。
同样三次ANR显示在flutter.anr.duration的“Metric”界面上:导出时,每次时长为6.0至6.6秒。

iOS MetricKit应用退出

dartastic.app.exit.count的“Metric”界面,以柱状图显示:一个五分钟步长内共50次退出,其中43次正常退出、3次内存不足、3次看门狗终止和1次超时。
dartastic.app.exit.count的“Metric”界面,以柱状图显示:一个五分钟步长内共50次退出,其中43次正常退出、3次内存不足、3次看门狗终止和1次超时。