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

概览

Dartastic让您看到Dart和Flutter应用在用户手中的真实表现,并帮助您修复出现的问题。本页是一张地图。读一遍,然后按入门指南逐步操作。

平台

每个帮助页面都展示同一张图,并点亮该页涉及的部分,让您始终知道自己所处的位置。

构建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令牌发送
  1. 构建:在您的电脑和CI中。您的应用从Dartastic Pub获取Dartastic的package,方式与从pub.dev获取package相同。
  2. 运行:在手机和桌面上、在浏览器中,以及作为Dart服务器。其中的Dartastic OTel package记录所发生的事情,并将其发送到Observatory。
  3. 出现问题时,Symbolizer会利用您随应用发布到Pub的符号,将崩溃还原为您的文件和行号。
  4. 想知道原因时,可以询问Dartastic AI。它会读取遥测数据和您在Pub上的源代码,给出原因和修复方案。
  5. 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。用户的每个会话都会列出,包括其页面、点击、错误和受挫信号:

Observatory的“Sessions”列表,每行一个用户会话

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

一次会话回放,包含时间线、播放头下的链路及其日志

令牌连接各个组件

图中的每条箭头都需要各自类型的令牌。您在Control Room中生成令牌,每个令牌只显示一次,因此请在生成时复制。大多数开发者从未在dart pub中使用过令牌;Pub页面会一步步指导您。

令牌从到用途
Pub令牌您的电脑Dartastic Pubdart pub get可以下载Dartastic的package和您的私有package;dart pub publish可以上传。
CI交换您的CIDartastic 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)是还原这些名称的钥匙。
令牌
一串较长的密钥字符串,让一方能与另一方通信。每种令牌打通上图中的一条路径。