如何访问通过buildfire.publicData.insert推送的BuildFire公开日志？

1. 如何访问推送的日志 #

• 通过Buildfire插件后台的数据管理模块访问：
  1. 登录Buildfire后台，进入对应插件项目
  2. 找到「Public Data 存储」或「数据管理」板块
  3. 在该板块内可筛选、查询所有通过buildfire.publicData.insert插入的日志条目
• 也能通过代码调用查询接口获取：

  buildfire.publicData.search({
    filter: { /* 自定义过滤条件，如日志类型、时间范围 */ },
    sort: { createdAt: -1 }
  }, (err, result) => {
    if (err) console.error(err);
    else console.log(result);
  });
  

2. 日志是否包含请求头？ #

默认情况下，buildfire.publicData.insert不会自动记录请求头。如果需要保存这类信息，必须在调用接口时主动将请求头作为日志字段传入，示例：

// 主动收集并插入请求头
const reqHeaders = /* 从当前环境获取请求头，如前端的headers或后端的req.headers */;
buildfire.publicData.insert({
  logInfo: "业务操作日志",
  requestHeaders: reqHeaders
}, (err, result) => {
  // 回调处理
});

3. 如何记录并查看源地址与目标地址 #

这两个信息同样需要手动传入日志对象，接口不会自动捕获：

• 调用接口前，先获取源地址（如用户IP、发起请求的页面URL）和目标地址（如接口地址、跳转目标）
• 将这两个字段作为日志属性一起插入，示例：

  buildfire.publicData.insert({
    logInfo: "转发操作日志",
    sourceAddress: "192.168.1.100",
    targetAddress: "https://example.com/api/transfer"
  }, (err, result) => {
    // 回调处理
  });
  

• 之后无论在后台面板查看，还是通过查询接口获取，都能直接读取这两个核心字段。

内容的提问来源于stack exchange，提问作者DCarter