概览
Dartastic让您看到Dart和Flutter应用在用户手中的真实表现,并帮助您修复出现的问题。本页是一张地图。读一遍,然后按入门指南逐步操作。
平台
每个帮助页面都展示同一张图,并点亮该页涉及的部分,让您始终知道自己所处的位置。
- 构建:在您的电脑和CI中。您的应用从Dartastic Pub获取Dartastic的package,方式与从pub.dev获取package相同。
- 运行:在手机和桌面上、在浏览器中,以及作为Dart服务器。其中的Dartastic OTel package记录所发生的事情,并将其发送到Observatory。
- 出现问题时,Symbolizer会利用您随应用发布到Pub的符号,将崩溃还原为您的文件和行号。
- 想知道原因时,可以询问Dartastic AI。它会读取遥测数据和您在Pub上的源代码,给出原因和修复方案。
- Control Room是您配置这一切的地方:它生成令牌,打通图中的每一条箭头。
组成部分
| 组件 | 作用 | 在哪里使用 |
|---|---|---|
| Control Room | 您的账号中心。在这里生成令牌、邀请团队成员、选择方案并下载Reference Demo。 | dartastic.io/control-room,登录后 |
| Dartastic Pub | 用法与pub.dev相同的私有package仓库。您从它获取Dartastic的package,在上面存放自己的私有package,并将应用的源代码发布到上面。 | dart pub get, dart pub publish |
| Dartastic OTel | 您添加到应用中的package。它们以OpenTelemetry格式记录应用中发生的事情(页面、点击、网络调用、错误、崩溃、性能),并将其发送出去。 | 您的pubspec.yaml和main() |
| Observatory | 查看数据的地方。针对您的应用发送的所有数据,提供带回放的会话、链路、日志、指标、崩溃、仪表板和告警。 | 从Control Room打开 |
| Symbolizer | 将混淆后的发布构建版本中难以阅读的调用栈,还原为您的文件名和行号。崩溃到达时自动运行。 | 无需调用:它读取您发布到Pub的符号 |
| Dartastic AI | 用日常语言回答关于您应用的问题。它读取您的遥测数据和Pub上的源代码,找出原因并提出修复方案。 | Observatory和Control Room中的“Ask”按钮 |
您会看到什么
这就是Observatory。用户的每个会话都会列出,包括其页面、点击、错误和受挫信号:

打开一个会话并回放。在播放头下方,您可以看到那一刻的链路、日志和错误,并可直接跳转到对应的代码行:

令牌连接各个组件
图中的每条箭头都需要各自类型的令牌。您在Control Room中生成令牌,每个令牌只显示一次,因此请在生成时复制。大多数开发者从未在dart pub中使用过令牌;Pub页面会一步步指导您。
| 令牌 | 从 | 到 | 用途 |
|---|---|---|---|
| Pub令牌 | 您的电脑 | Dartastic Pub | dart pub get可以下载Dartastic的package和您的私有package;dart pub publish可以上传。 |
| CI交换 | 您的CI | Dartastic Pub | 您的CI读取和发布package,无需在其中存储任何令牌。 |
| OTLP令牌 | 手机或桌面上的应用、您的Dart服务器 | Observatory | 允许应用发送遥测数据。 |
| Browser OTLP令牌 | 您的Flutter Web应用 | Observatory | 允许Web应用发送遥测数据,仅限来自您列出的网站。 |
您持有的所有令牌都列在同一个界面上。令牌说明了每种令牌,以及如何撤销或替换。
运行位置:您的方案
- Cloud运行在Dartastic由多个客户共享的基础设施上。您的Pub是
pub.dartastic.io。 - Dedicated为您的组织提供专属服务器,使用您选择的子域名:您的Pub是
pub.<subdomain>.dartastic.io。 - Self-Hosted在您自己的网络内运行整个平台。
每种方案的步骤都相同。URL不同之处,这些页面会同时列出两者。比较方案。
所需条件
- 全部功能需要Flutter 3.44和Dart 3.12或更高版本;除Flutter指标外的所有功能需要Flutter 3.22和Dart 3.4。每个package所需的版本。
- 一个Dartastic账号:注册免费。注册后,您的组织从Cloud Free开始,无需信用卡。
- 仅Reference Demo的天气后端需要:Docker。
如何学习
选择适合您的方式;它们涵盖相同的内容。
- 阅读:按顺序阅读这些页面。每页底部的“上一页”和“下一页”会引导您逐页阅读。
- 运行Dartastic OTel Reference Demo。它是开源Dart OTel Reference Demo的增强商业版:包含多得多的演示,都是可直接运行的Flutter应用,展示如何使用Dartastic的每项功能,所有配置均已完成。阅读其代码、照着使用,或让您的AI编程助手参考它。获取Reference Demo。
- 提问:支持为您解答问题。
这些页面中使用的术语
- OpenTelemetry(OTel)
- 记录软件运行情况的开放标准。Dartastic端到端地使用它,因此您编写的任何内容都不会被锁定在Dartastic上。
- OTLP
- OpenTelemetry的传输格式:应用发送所记录数据的方式。
- 链路和Span
- Span是一段计时的工作(一次点击、一次网络调用、一次数据库查询)。链路是一次操作的Span树,可以跨越您的应用和服务器。
- 日志
- 应用写下的一行文本,关联到其发生时所在的链路。
- 指标
- 随时间测量的数值:帧时间、内存、请求数。
- 会话
- 一个人对您应用的一次访问,从启动到离开,包含其中的每个页面、点击、错误和链路。
- 回放
- 回看一次会话。您可以选择捕获多少内容:事件时间线、线框图或真实像素。
- RUM
- 真实用户监控:来自真正使用您应用的人的遥测数据,而非测试。
- 混淆和符号
- 发布构建版本可以打乱其中的名称(flutter build --obfuscate)。它写出的符号文件(--split-debug-info)是还原这些名称的钥匙。
- 令牌
- 一串较长的密钥字符串,让一方能与另一方通信。每种令牌打通上图中的一条路径。