介绍

基于IndexedDB的前端日志存储系统Mplogd。

前端开发同学定位问题困难，无法了解用户真实操作场景，很多时候定位问题只能靠猜。因此选择记录下用户的操作日志，帮助定位问题。

Mplogd优势：

1. 个性化灵活配置。比如：日志监控上报、关键日志实时上报等等。

2. 支持自动记录。包括：http请求、页面error错误、promise reject、fetch请求，每一自动记录项都支持单独配置。

3. 更稳定的服务。维护内部状态，错误监控。

4. 容量控制。1. 保存7天日志。 2. 单条日志大小自定义限制。 3.日志总容量控制。

使用

@tencent/mplogd 1.0.6

示例

const Mplogd = require('@tencent/mplogd');
const mplog = new Mplogd();
1. 记录
mplog.info('ajax request', requestBodyData);   // description: 记录描述(可用于后续半匹配搜索) 和 data: 具体数据

2. 查询
mplog.get('2021-4-18', '2021-4-19', (items) => {
	if (items.length) {
		items.forEach(item => {
			console.log(item);
		})
	}
});

默认数据库记录格式

1. location 当前页面地址
2. level 日志等级
3. description 日志信息补充描述
4. data 数据
5. timestamp 时间戳

自定义配置项如下：

自定义属性 | 说明 | 默认
----| ---- | ---- dbName | 数据库名 | mplog dbStoreName | 数据库表名 | logs dbVersion | 数据库版本 | 1 bufferSize | 写日志缓存的记录大小，可设置为1即时记录 | 10 autoLogError |是否自动记录错误信息 | false
autoLogRejection |是否自动记录promise错误 | false autoLogAjax | 是否自动记录AJAX请求 | false autoLogFetch | 是否自动记录fetch请求 | false logAjaxFilter | 过滤AJAX请求的函数, 默认不做过滤 | null maxErrorNum | 最大容错数（比如：写入某条日志错误 | 3 maxLogSize | 单条日志最大长度 | 3000 ErrorReport | 错误监控上报 | null reportFunction | 实时日志上报 | null

扩展配置使用方式

// 错误兼容上报
let ErrorReport = (errorMsg, errorInfo) => {
	// errorMsg和errorInfo, 为错误描述和具体的错误内容，业务方可自行处理上报。
};

const Mplogd = require('@tencent/mplogd');
const mplog = new Mplogd({
	dbName: `mplog__${useruin}`,
	autoLogError: true,
	autoLogAjax: true,
	autoLogRejection: true,
	maxLogSize: 10000,
	ErrorReport
});

// 实时日志上报
let reportFunction = (items) => { // 当前的日志元素 [数组格式]
	// 可上报日志到实时
};