Skip to content

告警中心(租户)

菜单:监控与告警 → 告警中心(/alerts)· 权限:tenant.alerts.read(查看)/ tenant.alerts.manage(确认与人工恢复;auditor 只读) 设计权威:F25;规则口径详见 平台版手册

租户管理员会看到什么

只展示本租户的告警(平台基础设施类告警由平台运维处置,不打扰租户):

  • Agent 运行:失败率过高、P95 耗时异常 → 「去排查」进运行监测。
  • 运行实例不健康 → 智能体托管环境。
  • 定时任务连续失败(已被系统自动停用,需处理后恢复;摘要附带最近一次失败的错误信息)→ 「去排查」直接打开该任务详情,内含「最近运行记录」(状态/触发方式/耗时/错误摘要)。
  • 计费类:钱包冻结、积分不足、配额达 90%/100%、订阅到期 → 「订阅与配额」页对应 Tab。

概览页「待办事项」也会出现「未处理告警 N」入口;顶栏铃铛显示本租户待处理数。

操作说明

  • 确认:告知团队"有人在跟进";不会关闭告警。
  • 标记恢复:问题确认解决后使用,必填原因并写入审计;异常若仍存在会重新告警。
  • 异常自动消除(如充值后余额恢复)时告警会自动恢复,无需手工操作。

Webhook 接收格式

在「组织同步」配置了 webhook 的租户会收到告警事件推送:

  • Header:X-Zhiban-Event-Type: notify.alert.fired(或 notify.alert.resolved)+ X-Zhiban-Signature(HMAC-SHA256,同 org 事件签名算法)。
  • Body(JSON):alert_uuid(告警标识)、alert_type(规则标识)、severity(warning/critical)、statustitle/summary(中文描述)、resource_kind/resource_uuid(关联资源)、first_triggered_atoccurrence_count
  • 投递失败自动重试,重试耗尽落死信;不包含会话正文或密钥类内容。

常见问题

  • 看不到告警菜单:需要 tenant.alerts.read(admin/operator/auditor 预置角色已带)。
  • 配额告警从哪来:与「订阅与配额 → 配额水位」同口径(生效限额含覆写,已用值与平台计数一致)。
  • 积分不足为什么没告警:平台未配置低额预警阈值(low_credit_warning_threshold)时该规则不启用。

© 知办AI Team — 开发者公开文档. 平台运维 / 内部架构文档见内部 wiki.