事件、审计与导出
Guard 保留两类记录:
- 事件:Agent 尝试做了什么、Guard 怎么判定的。由执行器上报。
- 控制操作审计:人和令牌对项目做了什么,比如发布策略、批准票据、撤销接入。
事件
一个动作通常留下几条事件,每个阶段一条:proposed(带判定)、decided(放行、拒绝、降级、待审批)、started 和 completed(带结果状态)。它们共用这个动作的任务 ID、追踪 ID 和动作 ID,所以可以从头到尾追踪一次调用,或者一整个任务。
每条事件离开执行器之前都已脱敏:只有名称、判定和摘要,没有参数值和返回值。见哪些数据会离开你们的环境。
调查
控制台的「事件」打开事件调查。可以按 Agent、可信主体、资源、任务、策略版本、判定结果和时间区间(要带时区)筛选,每页 100 条。打开一条事件,能看到判定、命中的规则、相关的审批,以及同一个任务里最多 100 条其他事件。
保留
每个项目默认保留 30 天、最多 100,000 条事件。存满之后,新事件会被拒绝(EVENT_CAPACITY_FULL),执行器把它们留在本地队列里。用托管控制面时,需要调整上限或导出事件请联系我们。
控制操作审计
「审计」列出最近 50 条控制操作:时间、操作(方法和路径,回滚另写两个版本和原因)、结果(成功、被拒绝或失败)和操作人的角色。被拒绝的尝试也列在里面,比如只读成员试图退役执行器。
我们的工作人员对你们项目做的操作也记在这里,每条都注明原因编号。
导出到你们的日志系统
有两个只读的增量接口,都按项目隔离,用游标分页:
| 接口 | 内容 |
|---|---|
GET /v1/events/feed | 事件 |
GET /v1/audit/feed | 控制操作审计 |
两者都接受 after(游标)和 limit,viewer 令牌可以读取。preworld-guard siem-export 把两者拉到一个只追加的 NDJSON 文件里,并记住上次停在哪里:
PREWORLD_GUARD_TOKEN="$GUARD_VIEWER_TOKEN" preworld-guard \
--endpoint https://guard.example.com --project-id "$PREWORLD_GUARD_PROJECT_ID" \
siem-export --output /var/lib/preworld-guard-siem/events.ndjson \
--state /var/lib/preworld-guard-siem/cursor.json- 它先写入并落盘新的行,再保存游标。两步之间崩溃可能会重复几行:按
kind+project_id+record_id去重。 - 同一时间只运行一个导出任务。
- 它不直接推送到某个 SIEM 产品。让你们现有的日志采集器读这个 NDJSON 文件即可。
--limit(默认 500)和--max-pages(默认 20)限制一次运行拉取的量。
GET /v1/assets 汇总事件里出现过的 Agent、工具、目标地址和防护点。它只能反映经过 Guard 的动作。从没经过 Guard 的,要对照你们的工具、MCP 和网络配置另行盘点。
导出文件的保护
导出的内容没有参数值和返回值,但资源名、目标地址、Agent ID 和主体 ID 仍可能敏感。按你们的日志管理要求保护这些文件和它们的备份。