Zentrix Gateway 文档

26. 上线检查、稳定运行与管理交接

完整版章节。内容按 2026.10 主线代码与运行环境界面核对;具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容:本章给出一份可直接照着走的上线检查清单,说明试点转正式时需要确认哪些状态、日常值守关注哪些指标,以及项目交接时应当交付哪些材料与责任划分。读者是即将把系统从试点转入正式运行的管理员与项目负责人。

26.1 上线检查清单

在把访问入口开放给更大范围之前,逐项确认下表。每一项都能在产品界面里找到结论,不需要额外工具。

检查项在哪确认通过标准
:--:--:--
授权模块完整管理后台 › 系统设置 › 全局设置 ›「授权许可」页签「高级模块」区所需模块均为已开通。社区版不设到期时间,页面会明确标注许可来源
模型供应商可用管理后台 › 模型供应商关键供应商「健康」列为正常,「可用性探查」近期有成功记录
模型分组已发布管理后台 › 组织与权限 › 模型分组面向试点的分组处于已发布状态,「调用情况」有近期成功调用
可用范围正确模型分组详情 › 可用范围与配额试点成员或部门在列表内,范围外账号确认不可见
配额与预算合理同上 › 配额编辑额度不为 0(额度 0 是硬墙,会阻断全部调用),周期设置符合预算
密钥与调用方就绪管理后台 › API 密钥管理试点密钥状态为可用,接入配置已交付到调用方
流量规则已生效管理后台 › 流量规则关键规则状态为启用,「确认并应用」已完成;列表顶部无「最近一次配置发布失败」提示
护栏按需启用管理后台 › 护栏规则需要的检测类型已配置并绑定到流量规则;依赖全局模型的能力已配好对应模型
请求记录可查管理后台 › 运行总览 › 请求能按接入凭据筛出试点调用,状态与耗时正常
审计可用管理后台 › 操作审计近 24 小时有配置变更记录,完整性校验可执行
告警与通知就绪管理后台 › 告警规则关键规则已启用,通知渠道已通过测试消息验证
文档入口可达账号菜单 › 帮助能正常打开产品文档站

注意:检查清单里任何一项不通过,都不要扩大开放范围。先在小范围内修正并复测该项,再继续。

图 26-1 授权许可:高级模块的开通状态与许可来源说明

26.2 稳定运行期关注什么

转入正式运行后,按下面的节奏查看即可,不需要持续盯着。

每日:运行总览的指标卡与请求列表,重点看交付成功率与失败原因分布。成功率下降时先看「按原因分项」——属于上游故障还是调用方问题,处置方式完全不同。

每周:用量与成本页面的趋势、消耗排行里的高消耗凭证、告警规则的触发记录。发现某把密钥或某个部门的消耗异常增长,先确认是业务增长还是密钥外泄。

按需:网关节点与组件状态、可用性探查历史、审计完整性校验。计划内的配置变更前后各看一次。

26.3 管理交接要交付什么

项目交接时,除了账号与密码,更需要交付的是「谁负责什么」和「出了问题怎么查」。建议按下表准备。

交接项内容
:--:--
账号与角色平台管理员、租户管理员、安全管理员、审计员各自的账号与责任人;临时账号已清理
授权与许可许可来源、到期安排、模块清单
模型接入清单供应商、账号归属、模型、模型分组与可用范围的对象清单
流量与安全策略已启用的流量规则、护栏规则、限流的阈值与理由
配额与预算各服务、各部门的额度设置与调整流程
观测与告警告警规则的接收人、通知渠道、升级路径
日常运维备份方式与周期、升级窗口、变更审批流程、回滚手段
支持渠道提交支持时需要提供的信息(见第 27 章)

注意:交接清单里的「已启用的策略」要连同「为什么这样配」一起交接。只交接阈值不交接理由,下一位管理员不敢改也不敢删。

26.4 发现异常时的处置顺序

  1. 先止血:确认影响面(哪些服务、哪些调用方),必要时停用相关流量规则或密钥,而不是急着重启服务。
  2. 再定位:用「运行总览 › 请求」按时间和调用方筛出失败请求,打开请求详情看「路由与改写 › 命中记录」与错误码。
  3. 后修复:定位到具体对象(供应商账号、规则、配额、证书)后只改这一项,改完观察一轮真实流量。
  4. 留记录:把时间、对象、现象、处置写进变更记录,便于后续追溯与交接。

能力说明

不提供的能力替代做法
:--:--
容量规划工具与安装前的内核参数、操作系统发行版识别安装前的磁盘空间检查会在空间不足时阻断安装并给出候选挂载点;其余容量规划需按实际业务量估算,建议先用试点流量观察一段时间再决定扩容。具体安装要求见产品安装文档
定期配置巡检报告当前只提供规则的单次「验证规则」,没有定期巡检与优化建议报告(第 24 章)
一键式运行状态总览导出通过「运行总览」逐页查看,或用报表导出的调用与用量数据自行汇总(第 22 章)

---

上一章:25. 分阶段上线 · 下一章:27. 联系支持所需信息