除了 Sentry 基础的特性,还提供以下小程序相关特性
- 记录客户端基本信息
- 记录页面 request 请求
- 记录应用生命周期(onAppLaunch, onAppShow, onAppHide)
- 记录页面导航
- 记录小程序 api 调用
- 记录 console 日志
- 记录应用框架异常和未捕获异常
- 记录微信小程序 Unhandled Promise Rejection Error
- 记录 setTimeout, setInterval 内异常
- 支持小程序 LogManager
- 将
browser/sentry-mina.js
拷贝到项目中
控制台报 regeneratorRuntime is not defined
错误,在开发工具上启用 增强编译
可解决 @NullYing
开发中配置 sentry.io 的 url 地址。(sentry.io 未经过 icp 备案,需自己做转发)
import * as sentry from "sentry-mina/browser/sentry-mina.js";
// config Sentry
sentry.init({
dsn: ''
})
// Set user information, as well as tags and further extras
Sentry.configureScope(scope => {
scope.setUser({ id: '4711' });
scope.setTag('user_mode', 'admin');
scope.setExtra('battery', 0.7);
// scope.clear();
});
// Add a breadcrumb for future events
Sentry.addBreadcrumb({
message: 'My Breadcrumb',
// ...
});
// Capture exceptions, messages or manual events
Sentry.captureMessage('Hello, world!');
Sentry.captureException(new Error('Good bye'));
Sentry.captureEvent({
message: 'Manual',
stacktrace: [
// ...
],
});
默认环境为微信小程序,其他平台小程序可在初始化时配置特定平台环境对象, 环境对象内属性灿在
sentry.init({
minaContext: {
getSystemInfo: () => {},
request: () => {},
setStorage: () => {},
getStorageSync: () => {},
getLaunchOptionsSync: () => {},
// ...
}
})
new sentry.Integrations.Breadcrumbs({
console: true,
request: true,
navigation: true,
api: true,
lifecycle: true,
unhandleError: true
})
配置 | 类型 | 默认值 | 描述 |
---|---|---|---|
console | Boolean, Array | true | 是否记录 console 日志,如果值为数组 ['log', 'info'],则只记录数组中所列的日志 |
request | Boolean | true | 是否记录页面 request 请求 |
navigation | Boolean | true | 是否记录页面导航信息 |
api | Boolean | true | 是否记录小程序 API 调用 |
lifecycle | Boolean | true | 是否记录小程序生命周期变化 |
unhandleError | Boolean | true | 是否记录微信小程序 Unhandled Promise Rejection Error |
捕获并记录 setTimeout, setInterval 内的异常
new sentry.Integrations.TryCatch()
将 Sentry 事件数据记录到小程序 LogManager
new sentry.Integrations.LogManager({
level: 0
})
配置 | 类型 | 默认值 | 描述 |
---|---|---|---|
level | Number | 0 | 取值为0表示是否会把 App、Page 的生命周期函数和 wx 命名空间下的函数调用写入日志,取值为1则不会 |
记录 app.onError 和 app.onPageNotFound 日志
new sentry.Integrations.GlobalHandlers()
目前小程序只支持通过 request 发送日志到服务器,由于小程序 request 有并发限制, sentry-mina
以队列的方式发送日志请求,避免过多占用请求资源。
sentry-mina
发送日志,支持失败重试,默认重试 2 次。可以通过以下方式
sentry.init({
transportOptions: {
retry: 2
}
})
进行配置。
sentry-mina
会记录未发送的日志,当用户重新进入小程序,会继续发送。