Files
WebHooker/docs/zh/guide/logs.md
T

2.7 KiB
Raw Blame History

日志

发送日志(send_logs)

每次分发尝试都会记录到 D1 send_logs 表,并可在控制台(日志标签页)查看。字段:

字段 含义
routeId 匹配的路由
groupId 路由所属分组
event 事件类型(如 push、pull_request、custom)
repo 仓库全名(存在时)
target 消息发送到的目标 id
platform discord 或 telegram
ok 发送是否成功
status 平台 API 的 HTTP 状态码(适用时)
error 失败时的错误信息
errorCode 稳定错误码(如 NO_TARGET、NO_TOKEN、RATE_LIMITED)
attempts 含重试在内的发送次数
durationMs 发送耗时
deliveryId Webhook 投递 id(提供时)
messageId 平台消息 id(用于原地编辑)
actor 发送者登录名
action 事件动作(存在时)
detail 附加 JSON 详情(存在时)

控制台的日志标签页列出最近记录(可按分组过滤),并可查看单条完整详情。写入为尽力而为——插入失败不会中断分发。

审计日志(audit_logs)

所有管理员操作都会记录到 D1 audit_logs 表,并可在控制台(审计标签页)查看:登录/登出、分组/路由/成员/邀请变更、Token 撤销、安装绑定等。字段:时间戳、操作者(GitHub id + 登录名)、动作、目标类型/id、分组 id、IP 与详情 JSON。

记录由定时任务在 AUDIT_RETENTION_DAYS(默认 90)后自动清理。与发送日志一样,写入为尽力而为。

Webhook 日志频道

分组还可以在 Discord 频道/子区或 Telegram 群组/话题中接收每条 webhook 的摘要消息——见分组 → Webhook 日志频道。这些摘要是尽力发送的,不会记录到 send_logs。