Skip to main content

Web 应用自定义数据采集

功能概述

Lighthouse RUM SDK 除了自动采集基础的 Web 数据外，还提供了自定义数据采集能力。您可以：

  • 采集特定的错误信息和异常
  • 记录用户的关键行为和操作
  • 追踪重要的业务数据

错误采集

功能说明

RUM SDK 支持采集以下类型的错误：

  • 已处理的异常（try-catch）
  • Promise 异常（rejections）
  • 网络请求错误
  • 其他自定义错误

使用方法

使用 addError 方法采集自定义错误：

参数说明：

  • error：错误对象，支持 Error 实例或自定义错误对象
  • context：（可选）错误相关信息，用于补充错误发生时的上下文
// 采集自定义错误
const error = new Error("Something wrong occurred.");
LIGHT_RUM.addError(error, {
  pageStatus: "beta",
});

// 采集网络请求错误
fetch("<SOME_URL>").catch(function (error) {
  LIGHT_RUM.addError(error);
});

// 采集已处理的异常
try {
  //Some code logic
} catch (error) {
  LIGHT_RUM.addError(error);
}

行为采集

功能说明

通过行为采集，您可以记录：

  • 用户的关键操作（如点击、提交）
  • 业务流程的重要节点
  • 应用状态的变更信息

使用方法

使用 addAction 方法记录用户行为：

参数说明：

  • name：行为名称，描述当前操作类型
  • context：行为相关信息，可包含业务数据和操作结果
LIGHT_RUM.addAction("check", {
  name: "cart",
  value: 20,
  items: ["apple", "banana"],
});

使用建议

最佳实践

  1. 错误采集建议：

    • 添加必要的上下文信息，便于问题定位
    • 避免记录敏感信息（密码、token 等）
    • 对于高频错误，建议增加采样率

  2. 行为采集建议：

    • 选择重要的业务节点进行采集
    • 保持命名的一致性和规范性
    • 确保采集数据的完整性
注意事项
  1. 合理使用自定义采集，避免数据量过大
  2. 定期检查采集数据的有效性
  3. 注意数据采集的实时性和准确性

相关阅读