Dartastic SymbolizerDartastic Symbolizer

从生产环境错误直达源代码行。

Dartastic Symbolizer将生产环境错误转换为可据以行动的源代码行,并且全程私有。

经过Dartastic Symbolizer处理的Flutter错误Span:带有函数名和源代码行的真实堆栈帧

运作方式

当Native SDK检测到错误时,可以调用Dartastic Symbolizer,为错误补充其源代码位置。您的可观测性平台收到的错误会自动指向具体的源代码行。

调试符号(或源映射)加上您的应用,就等于您的源代码。将它们上传给可观测性厂商,会为您的知识产权增加攻击面,还会带来额外的运维负担。

将符号文件保存在您发布package的地方,即Dartastic Pub中,由您掌控谁能看到您的知识产权。

堆栈问题,迎刃而解。

发送一段混淆后的生产环境堆栈,得到同一段堆栈,但带有真实的函数名和源代码行号。符号文件保留在您的Dartastic Pub服务器中,无需另行上传到可观测性厂商,从而缩小您知识产权的攻击面。

混淆后 · 来自生产环境
Dartastic Observatory中的Span事件:一个未经符号化的Flutter崩溃,只显示build_id和_kDartIsolateInstructions中的原始指令偏移量
已符号化 · 经由Dartastic Symbolizer
经过Dartastic Symbolizer处理后的同一个Span事件:带有函数名和源代码行的真实堆栈帧,例如symbolizer_demo.dart:157:7处的_SymbolizerDemoPageState._validateQuantity

适用于任何兼容OTLP的平台。Dartastic Native OTel SDK会在Span出错或崩溃后调用Dartastic Symbolizer,在导出器之前改写堆栈,因此您的可观测性平台看到的不是一堆乱码,而是人类可读的堆栈,直指与问题相关的源代码行。

Dartastic Symbolizer如何将混淆后的崩溃转换为源代码行 端到端完成,就在同一个链路Span中。无需第二个工具,无需复制粘贴。 Flutter应用OTel CollectorDartastic Pub私有符号存储Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Observatory1. 错误Span2. 错误、应用版本3. 构建信息4. .symbols5. 源代码堆栈 所有流量均经TLS加密 · API密钥按package限定范围 · 符号文件始终归您所有
不使用Dartastic Observatory? 从您自己的集成调用同一个Web API。您的符号文件永远不会离开您的Pub。 您的集成例如错误跟踪工具Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Pub私有符号存储1. 错误、应用版本2. 错误、构建信息3. .symbols4. 源代码堆栈 一次HTTPS调用 · 符号文件保留在您的私有Pub中

优势

  • 可读的错误驱动整个工作流程。 一个指明文件和行号的错误,就是一个可以在午饭前完成分类、分配和修复的工单。有没有符号化,决定了您只是在看着生产环境,还是真正理解它。团队一旦用上,就会好奇以前没有它是怎么发布的。
  • 全自动。发布即完成。 使用flutter build apk --release --obfuscate --split-debug-info=symbols/构建,并将版本连同.symbols一起发布到您的私有Dartastic Pub。Dartastic Symbolizer会自行为每个应用、版本和平台找到确切的符号文件。多年以后,1.4.0版本的错误依然可读。
  • 比Sentry或Crashlytics更简单。 这些平台要求您为每个平台、每次发布都向它们上传调试符号,这是一个需要您自己搭建并时时照看的CI步骤。Dartastic省去了这一整套流程。您的符号文件本来就在自己家里。
  • 也更安全。 调试符号是通往您源代码的地图,把它们上传给厂商会扩大您知识产权的攻击面。使用Dartastic,符号文件保留在您的私有Pub中,由您的密钥守护。您的可观测性厂商只会看到友好、可读的文本。
  • 您喜欢的平台直接可用。 在任何兼容OTLP的平台中,错误都会附带源代码行:Datadog、Honeycomb、Dartastic Dedicated,甚至Sentry本身。厂商端无需安装任何东西,也无需等待集成。
  • 毫秒级完成,作为链路的一部分。 一个简单的API。缓存命中的查询在毫秒内返回,每个响应都包含您本月至今的用量。感觉就像链路从未被混淆过。
符号文件始终是构建系统的一部分。

大多数团队会把.symbols / .dSYM作为单独的步骤上传到Datadog、Sentry或类似平台。这等于交给厂商一把重建您源代码的钥匙。Dartastic Symbolizer将符号文件保留在pub.dartastic.io内部,只向下游输出反混淆后的文本。

本地部署选项(合规)

受监管的工作流程可以在自己的安全边界内运行Dartastic Symbolizer,作为封闭的Dartastic Dedicated平台的一部分。生产环境链路永远不会离开客户的网络。

从Dartastic Pub自动获取

使用flutter build apk --release --obfuscate --split-debug-info=symbols/将您的Flutter应用发布到pub.dartastic.io;Dartastic Symbolizer会在首次缓存未命中时下载归档。无需第二次上传。

获取Dartastic Symbolizer

OTel Pro和Dartastic Observatory均包含Dartastic Symbolizer。选择适合您的方案,即可附带Dartastic Symbolizer。