Skip to content

开源 · 小程序与小游戏监控

小程序出了问题,
找到排查的线索。

把线上异常、操作经过和源码位置串起来。用 Sentry 排查难复现的报错,也能按需找出慢请求与业务操作的耗时。

原生小程序 · Taro · uni-app · 微信 / 抖音小游戏

从报错到源码流程示意
异常支付操作失败结合上下文,了解发生了什么
进入页面发起请求捕获异常
pages/checkout/index.ts源码定位
18async function submitOrder() {19  const result = await pay();20  throw new Error('支付失败');21}
上传同一构建的 Source Map,定位原始源码
一套 SDK,七个平台
微信支付宝字节跳动钉钉QQ百度快手
查看支持范围

围绕你的排查工作

少一点猜测,多一些线索。

先接通错误上报,再按项目需要补充源码定位、性能与发送策略。

报错难复现,也有迹可循

集中查看异常,结合设备、页面、操作与请求记录还原经过;上传匹配的 Source Map,找到业务源码。

了解错误排查

操作变慢,找到耗时步骤

开启性能采样,查看请求与业务步骤耗时;配置链路追踪,关联已接入 Sentry 的后端操作。

配置性能监控

按网络与隐私要求上报

符合策略的发送失败数据可暂存并尝试补发;需要用户同意时,配置同意门禁后再发送监控数据。

了解发送策略

选择接入方式

从你的工程开始。

入口位置、组件错误和分端配置,
都在对应指南里。

安装并验证

从第一个
测试事件开始。

尽早初始化,发送一个测试错误,然后到 Sentry Issues 中确认事件。

当前指南面向 2.x。需要 Sentry 官方云服务,或 26.4.2 及以上的自建 Sentry。已有项目升级或使用更旧的后台时,先看版本选择与迁移。

查看完整接入步骤
bash
npm install sentry-miniapp
# 或 yarn add sentry-miniapp
js
import * as Sentry from 'sentry-miniapp';

Sentry.init({
  dsn: 'YOUR_DSN', // 替换为 Sentry 项目中的完整 DSN
  release: 'my-miniapp@1.0.0',
  environment: 'production',
});

Sentry.captureException(new Error('sentry-miniapp test'));

原生小程序在入口顶部、App() 之前初始化;原生微信工程还需构建 npm。没有事件时,先检查 Sentry 上报域名是否已加入 request 合法域名。

基础上报之后

把监控带到生产环境。

沿着实际要完成的任务,继续配置和验证。

开源,与你一起完善。

已收录于 Sentry 官方文档的社区 SDK 索引。

Sentry Community SDK 提交反馈

基于 @sentry/core 的跨端小程序与小游戏 SDK · MIT Licensed