Zenova 文档

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

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

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

本章内容:本章给出一份可以照着逐项确认的上线检查清单,说明试点转正式时需要确认哪些状态、稳定运行期按什么节奏巡检、出现异常时按什么顺序处置,以及管理交接时应交付哪些材料、怎样在平台内完成权限接管。读者是即将把平台从试点转入正式运行的管理员与项目负责人。

36.1 运行部署验收

适用场景:安装或升级完成后,在开放给成员之前先确认部署本身是健康的。

前提:平台管理员账号。

操作步骤

  1. 进入「平台控制台 › 系统维护 › 部署配置」,找到「最近一次验收」卡片。
  2. 点「立即验收」,等待「验收运行中…」结束。
  3. 查看汇总「通过 N/M,阻断 N,警告 N」,逐项展开阻断与警告项,按处理建议修正后重新验收。
  4. 在「运行监控 › 总览」确认网关节点、控制面进程与依赖都没有异常,「正在告警」中没有未处理的告警(第 33.1 节)。

你会看到:从未运行过时卡片显示「尚未运行过验收」;结果超过有效期时提示「验收结果已过期,请重新触发验收。」

注意:控制台无法打开时,部署管理员可在主机上执行 zenova doctor 做同类自检,执行 zenova status 查看各服务状态。有阻断项时不要开放给成员。

36.2 上线检查清单

适用场景:把访问入口开放给更大范围之前,逐项确认下表。每一项都能在产品界面中得到结论。

平台与授权

检查项在哪确认通过标准
:--:--:--
部署健康平台控制台 › 系统维护 › 部署配置 › 最近一次验收无阻断项,警告项已评估
可选能力就绪平台控制台 › 系统维护 › 系统更新本次上线需要的能力(智能体运行环境、知识库、文档解析等)为「已启用」
授权模块完整管理后台 › 系统设置 › 全局设置 ›「授权许可」页签「高级模块」区所需模块均已开通,授权状态为「授权有效」或符合预期的社区版
备份就绪平台控制台 › 系统维护 › 备份与恢复上线前已有一份成功的备份,且已在隔离环境演练过恢复

模型与能力

检查项在哪确认通过标准
:--:--:--
模型供应商可用管理后台 › 模型供应商关键供应商健康状态正常,「可用性探查」近期有成功记录
模型分组已发布管理后台 › 组织与权限 › 模型分组面向试点的分组处于已发布状态,有近期成功调用
可用范围正确模型分组详情 › 可用范围与配额试点成员或部门在列表内,范围外账号确认不可见
配额与预算合理同上额度不为 0(额度 0 会阻断全部调用),周期符合预算
密钥与调用方就绪模型分组 › API 密钥管理试点密钥状态可用,接入配置已交付到调用方
MCP 与 API 服务管理后台 › 能力已发布、可用范围正确,临时授权设置了截止日期

员工与智能体

检查项在哪确认通过标准
:--:--:--
工作空间管理后台 › 组织与权限 › 工作空间试点工作空间的成员、角色与模型分组已配置
员工对话成员账号登录工作台 › 新对话能选到授权的模型或智能体并得到回复
文件与知识工作台 › 文件、知识库常用文件能上传、预览,知识库能检索到授权范围内的内容,范围外的不可见
智能体运行管理后台 › 智能体 › 智能体运营试点智能体服务状态正常,无「运行时落后」标记
工具审批用试点智能体触发一次需审批的工具审批请求按预期到达,批准与拒绝都得到正确结果

治理与观测

检查项在哪确认通过标准
:--:--:--
流量规则已生效管理后台 › 流量 › 流量规则关键规则为启用状态,「确认并应用」已完成
护栏按需启用管理后台 › 护栏 › 护栏规则需要的检测类型已配置并绑定到流量规则;依赖全局默认模型的能力已配好模型
请求记录可查管理后台 › 运行总览 › 请求能按接入凭据筛出试点调用,状态与耗时正常
审计可用管理后台 › 审计与合规 › 操作审计近 24 小时有配置变更记录,完整性校验可执行
告警与通知就绪管理后台 › 运行与排障 › 告警规则关键规则已启用;订阅了「告警」的通知渠道已确认收到测试消息,页面顶部没有通知渠道提示;平台渠道覆盖一般告警、严重告警与紧急通知
文档入口可达账号菜单 › 帮助能打开产品文档
图 36-1 授权许可:高级模块的开通状态与许可来源说明

注意

  • 清单中任何一项不通过,都不要扩大开放范围。先在小范围内修正并重新验证该项,再继续。
  • 安全相关的检查不能只用管理员账号完成。至少用普通成员、业务管理人员与管理员三类账号,核对界面可见性与直接打开地址的结果。
  • 同时用敏感数据、风险内容、无权限资源、无效参数与额度耗尽等场景各验证一次错误提示是否清晰。

36.3 稳定运行期的巡检节奏

适用场景:转入正式运行后,按固定节奏巡检,不需要持续盯着页面。

每日

  • 平台状态页与「运行总览」的指标卡、请求列表,重点看成功率与失败原因分布。成功率下降时先看失败原因分项:属于上游故障还是调用方问题,处置方式完全不同。
  • 「运行总览 › 告警」中正在发生的告警,以及平台控制台「运行监控 › 告警」中尚未认领的告警。
  • 「智能体运营」中服务状态异常或有「最近错误」的智能体。

每周

  • 用量与成本的趋势、消耗排行中的高消耗凭据与部门。某把密钥或某个部门的消耗异常增长时,先确认是业务增长还是密钥外泄(第 28 章)。
  • 「使用洞察」中新出现的问题(第 31 章)。
  • 告警规则的触发记录,评估是否需要调整阈值、统计窗口或持续时长。

按需

  • 网关节点与依赖状态、可用性探查历史、审计完整性校验。
  • 平台日志容量与清理历史(第 33.7 节)。
  • 计划内的配置变更前后各看一次相关页面(第 34.1 节)。

容量问题的处理顺序

  1. 选定同一时间范围,查看请求量、错误率、响应耗时与排队情况。
  2. 按模型、工作空间、接入凭据或智能体缩小影响范围。
  3. 打开代表性请求,区分是上游响应慢、工具执行慢、排队、治理处理,还是重复调用。
  4. 检查模型分组配额、API 密钥配额、流量保护与智能体运行状态。
  5. 一次只调整一类限制,记录原值与恢复值;用正常业务请求验证恢复,再观察同一时间窗口的变化。

「在线成员数」与「请求并发」是不同的限制:登录或会话问题检查成员会话状态;模型请求拥塞检查并发、排队与流量保护。

36.4 发现异常时的处置顺序

适用场景:收到告警或用户反馈后,需要有条理地止血、定位与修复。

  1. 先止血:确认影响面(哪些服务、哪些调用方、哪些智能体),必要时停用相关流量规则、密钥或智能体,而不是急着重启服务(第 33.10 节)。
  2. 再定位:在「运行总览 › 请求」按时间和调用方筛出失败请求,打开请求详情查看「路由与改写 › 命中记录」与错误码;智能体问题先看「智能体运营」中的最近错误与生命周期事件。
  3. 后修复:定位到具体对象(供应商账号、规则、配额、证书、智能体配置)后只改这一项,改完观察一轮真实流量。
  4. 留记录:把时间、对象、现象与处置写进变更记录;告警详情的「处理备注」中也记录一份(第 32.6 节)。

36.5 管理交接要交付什么

适用场景:项目交接或管理员更换时,准备交接材料。

除了账号本身,更需要交付的是「谁负责什么」和「出了问题怎么查」。

交接项内容
:--:--
账号与角色平台管理员、租户管理员、安全管理员、审计员等各自的账号与责任人;临时账号已清理
授权与许可许可来源、绑定方式、到期安排与模块清单
部署与依赖部署方式、访问地址、数据依赖的提供方与维护方(第 33.6 节)
模型接入清单供应商、账号归属、模型、模型分组与可用范围
能力与智能体MCP 服务、API 服务、知识库、已发布智能体及其负责人、授权范围与工具审批设置
流量与安全策略已启用的流量规则、护栏规则、限流阈值,以及配置理由
配额与预算各服务、各部门的额度设置与调整流程
观测与告警告警规则的接收人、通知渠道及其接收级别、紧急通知渠道与升级路径
日常运维备份频率与转存位置、升级窗口、变更流程、回退手段、最近一次恢复演练结果
支持渠道内部支持联系人与提交支持请求所需信息(第 37 章)

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

36.6 在平台内完成权限接管

适用场景:更换管理员或调整职责,需要确保接任人员拿到所需权限、原管理员的权限按时收回。

操作步骤

  1. 在「组织与权限 › 角色管理」打开与职责相符的角色,在「授予」页签中授予接任人员,范围与原管理员一致;平台管理员在「平台控制台 › 平台账号与登录 › 平台账号」中调整平台级账号。
  2. 让接任人员用自己的账号登录,核对可见菜单与资源范围,同时确认无关页面仍不可访问。
  3. 逐项确认模型、模型分组、API 密钥、MCP、智能体、护栏、告警、审计、备份与运行管理的负责人。
  4. 轮换由原管理员个人保管的凭据(上游供应商密钥、连接凭据、证书私钥等),并验证相关连接与调用仍可用。
  5. 由接任人员完成一次配置变更、一次异常定位与一次备份状态检查。
  6. 确认接管完成后,撤销原管理员不再需要的授予;如原管理员离职,在「成员与部门」中移至已离职。
  7. 在「操作审计」中核对授予、撤销与账号状态变更的记录。

注意:共享管理员账号会破坏审计归属,不应用于多人日常操作。由原管理员个人创建的智能体与 API 密钥,交接前确认新的负责人,避免账号停用后影响业务。

能力说明

不提供的能力替代做法
:--:--
容量规划工具与安装前的内核参数、操作系统发行版识别安装前的磁盘空间检查会在空间不足时阻断安装;其余容量按试点期的实际用量估算后再决定扩容
定期配置巡检报告用部署验收检查部署健康(见 36.1);规则侧用「验证规则」做单次模拟(第 34.4 节)
一键导出运行状态总览通过「运行总览」逐页查看,或用报表导出的调用与用量数据自行汇总(第 32.10 节)
管理员账号的一键交接(资源批量转移)按 36.6 的步骤逐项确认负责人并调整角色,交接前确认个人创建的资源归属

---

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