股票
板块
用户
资讯
首页
天眼
自选
发现
开户
首页
天眼
自选
发现
我的

V5升级日志分析智能体:不用找研发也能自助解决问题啦!

致远互联 · 运维知识
V5升级日志分析实战:
报错看不完?4 个案例见真章
?? 适用提示
适用产品:致远协同 V5(版本升级场景)
适用场景:升级前后的升级日志分析
关键字符:all.log / upgrade.log
难度指数:★☆☆☆☆(会上传文件就能用)
每到版本升级,最让人头疼的往往不是升级本身,而是升级日志——几千行 INFO 里混着 ERROR,一行行往下翻,翻到眼花也不敢说“看全了”。
现在这个活儿可以交给工具了:V5 升级日志分析。上传标准升级日志,自动提取升级版本、升级路线及需要关注的异常信息,报错分级、解决方案一并给出。
它到底有多能打?我们挑了 4 个真实案例,从“4 个报错”到“上千个报错”,一次看全。
一、先认识一下这个工具
打开工具页面,介绍只有一句话:上传标准升级日志,自动提取升级版本、升级路线及需要关注的异常信息。上传完成后,分析结果自动生成,还能从历史分析记录里随时回看。
使用要点
仅支持 all.log 或 upgrade.log 文件
文件会在浏览器中压缩后上传,上传完成后自动生成分析结果
历史分析记录可下拉回看,无需重复分析
工具地址在这里(直接点击或复制到浏览器打开):
https://xtctools.seeyon.com/v5_log_analysis/log_analysis/upgrade_log/
也可以从两个常用入口进入:
? 协同云入口(https://cloud.seeyon.com/):赋能中心——协同云AI门户——AI交付助手——V5升级日志分析
?? 截图 · 协同云入口 · 协同云AI门户
?? 截图 · 协同云入口 · AI交付助手→V5升级日志分析
? 开放平台入口(https://open.seeyoncloud.com/):首页——CoMi一搜——V5升级日志分析
?? 截图 · 开放平台入口 · 首页 CoMi一搜
?? 截图 · 开放平台入口 · V5升级日志分析
日志从哪里找?工具页面已经标注得清清楚楚:
? 标准升级完成后:logs/all.log
? 标准升级过程中:data/tlib/all.log
? 信创升级工具:deploytools/upgrade.log
?? 截图 · 工具首页:上传升级日志
二、什么时候需要使用V5升级日志分析

1)所有能登录访问AI交付助手的人员均可免费使用V5升级日志分析智能体。

2)所有非信创、信创升级场景(测试升级、正式升级)都必须使用V5升级日志分析智能体进行一次分析兜底,提前发现修复问题,避免后续返工。

三、案例一:4 个报错,3 个同一问题


某客户环境A8企业版 从 V8.1SP2 升级到 V10.0SP1 升级程序界面显示升级存在错误,需要取日志分析。升级人员按提示取all.log上传到升级日志分析智能体,30秒不到获得分析结果:升级的版本信息清晰呈现,升级报错被自动分析展示出来:有 3 个必须确认的报错,和 1 个可以忽略的。所幸必须确认的错误只需按智能体的提示自主修复,无需重新升级,升级人员参考分析结果处理,顺利完成升级问题处理。
??  报错总计 4 | 必须确认 3 | 待确认 0 | 可忽略 1
?? 截图 · 案例一 · 分析结果页
?? 截图 · 案例一 · 错误 1 解决方案
错误 1 是典型的数据库字段问题,执行 SQL 报错:
java.sql.SQLException: ORA-01430: 表中已存在要求的列
工具直接给出了解决方案,连各类数据库的修改语句都准备好了:
解决方案要点
1. 检查表[CTP_COMMENT_ALL]的[OPINION_TYPE]字段是否满足以下类型:
Oracle: VARCHAR2(250);
Sqlserver: NVARCHAR(50);
Postgresql/KingBase: VARCHAR(50);
Mysql/Dm/Oscar/GBase: VARCHAR(50)。
如不满足请及时修改数据类型,否则会导致公文无法提交。
2. 字段类型不正确时修改语句可参考下方代码块。
3. 该表字段已存在数据,上述 SQL 无法直接调整字段类型时:重命名原字段(OPINION_TYPE 改为 OPINION_TYPE_BAK),再新增符合类型的字段;原字段数据可以忽略不要。
注意:升级 v10.0 过程所有与 CTP_COMMENT_ALL 表的 OPINION_TYPE 字段相关报错均按照以上方式处理。
-- Oracle
ALTER TABLE CTP_COMMENT_ALL MODIFY OPINION_TYPE VARCHAR2(50);
-- Sqlserver
ALTER TABLE CTP_COMMENT_ALL ALTER COLUMN OPINION_TYPE NVARCHAR(50);
-- Postgresql/KingBase
ALTER TABLE CTP_COMMENT_ALL ALTER COLUMN OPINION_TYPE TYPE VARCHAR(50);
-- Mysql/Dm/Oscar/GBase
ALTER TABLE CTP_COMMENT_ALL MODIFY OPINION_TYPE VARCHAR(50);
? 根据解决方案可以直接处理,无需上报。(可以看到 3 个报错是同一个问题,按提示检查处理即可。)
? 结果链接可直接发给总部看,无需再次分析。
四、案例二:升级中断,AI 点名根因
信创工具升级,分析提示升级中断,且有 2 个必须处理的报错。工具把状态直接标成“升级中断或未开始”,报错也定位到了日志末尾——导致中断的报错就在那里。
??  报错总计 9 | 必须确认 2 | 待确认 0 | 可忽略 7
日志末尾的原始报错长这样:
?? 截图 · 案例二 · 日志末尾导致中断的报错
? 根据提示处理后重新升级即可。
?? 截图 · 案例二 · 升级中断或未开始
?? 截图 · 案例二 · AI 深度分析与解决方案
?? 截图 · 案例二 · 参考文档
只看堆栈很难看出所以然,但点开“AI 深度分析”,根因直接被点名:
AI 深度分析
本次升级中断的根本原因是 DEE 数据迁移过程中发生主键冲突。
日志显示插入 dee_global_parameter 表时批量执行失败,数据库报错 duplicatekeyvalueviolatesuniqueconstraint "PK_DEE_GLOBAL_PARAMETER",明细为 Key (PARAM_NAME)=(a8Url) alreadyexists。
具体来说,客户环境的 DEEH2 数据库 base/dee/dee.mv.db 中存在 2 条 PARAM_NAME = 'a8Url' 的重复数据,而新版本创建的数据库表 dee_global_parameter 中 PARAM_NAME 是主键,迁移插入时主键冲突导致插入失败,进而使升级程序中断。
解决方案要点
方式一(推荐,适用于非信创环境):升级前清理重复数据
1. 还原至升级前的数据库,OA、注册表。
2. 升级前提前用数据库工具打开 base/dee/dee.mv.db,删除 PARAM_NAME = 'a8Url' 中重复的数据。
3. 删除完成后重新执行升级。
方式二(适用于信创环境):修改升级脚本去掉主键约束
1. 先修改 SQL 脚本中的建表语句,去掉 DEE_GLOBAL_PARAMETER 表的主键约束。
2. 升级完成后再删除重复数据,并补上主键约束。
以 A8N-2 金仓数据库为例,可到对应产品线下查找(如 deploytools/cfgHome/sql/A8N-1),执行 grep -ril dee_global_parameter 查到对应文件后,再在该文件中查找建表语句。
参考文档:DEE数据迁移异常导致升级中断
五、案例三:报错自动合并,不易漏
这个案例最能体现“量大”下的价值:合并整理同类报错。换成人工,需要核对上千个报错,容易漏;工具把相似报错归到一起,只看代表性的那几条。
??  报错总计 38 | 必须确认 7 | 待确认 0 | 可忽略 31
比如错误 2,后面直接标注“相似报错 328 个”——一眼就知道这不是一个报错,而是一类报错:
?? 截图 · 案例三 · 相似报错合并
点击查看解决方案,可以看到工具给出的具体办法,并非所有错误都可以根据解决方案自行修改,有时还得需要咱的研发大佬。
?? 截图 · 案例三 ·查看解决方案
六、案例四:全部可忽略,安心收工
有报错不等于有问题。下面这次升级,报错总计 13 条,但分级结果全是“可忽略”:全部可忽略,表明升级没有问题。如果靠人工一条条判断,这 13 条足够磨上半天;现在扫一眼分级,就能放心结束工作。
??  报错总计 13 | 必须确认 0 | 待确认 0 | 可忽略 13
逐条看,这些报错也都是“熟面孔”,比如重复插入已存在的记录:
错误: 重复键违反唯一约束"pk_cap_feature"
Detail: 键值(id)=(77) 已经存在。
?? 截图 · 案例四 · 全部可忽略
图:四个真实案例速览
写在最后
升级日志不是用来“硬啃”的,是用来“上传”的。
回到这 4 个案例本身:案例一是典型的“少而难”——报错只有 4 个,但不确定该不该上报;案例二是典型的“难而不解”——堆栈看得懂,但根因说不清;案例三是典型的“多而漏”——上千个报错逐条核对,怎么都会看花眼;案例四则是“有却心里没底”——有报错,不知道算不算升级成功。而这四种情况,恰好对应了工具的四重价值:
四个案例,四重价值
① 分级明确,不用猜:报错自动分为必须确认、待确认、可忽略三级,该处理的处理、能放行的放行,不再靠经验拍板。
② 根因直给,不用翻:关键报错直接定位到日志末尾,AI 深度分析把中断根因一句话说清,连各类数据库的修改语句都准备好了,根据提示处理后重新升级即可。
③ 同类合并,不易漏:相似报错自动合并整理,上千个报错只看代表性的几条,人工核对易漏的问题交给工具兜底。
④ 结果直达,不用跑:分析结果链接可直接发给总部看,无需再次分析;历史分析记录随时回看,现场与总部看到的是同一份结论。
一次上传,版本、路线、异常、方案一次拎清——从升级前的风险预判,到升级中的定位排障,再到升级后的结果确认,它都能接得住。下次升级,不妨先把日志交给它,把时间留给更重要的事。

升级无小事,所有升级项目务必在升级前做好数据备份再操作。升级之后养成习惯让升级日志分析智能体做一次检查,不用依赖研发技术人工支持就能完成确认,提升项目交付效率。

如对升级日志分析中的修改方案有疑问,可发技术服务支持申请单咨询技术老师,我们将持续迭代完善智能体能力。

往期精彩
? 致远OA升级后启动不了?CAP自检没过 3 个救场方法
? V5 环境巡检工具实战
? 取日志不用再登服务器-致远OA日志打包实战
? 致远CAP实战:多个明细表去重拼接?
? 致远CAP实战:填了身份证号还要手填年龄性别?
?? 关于致远互联
? 北京致远互联软件股份有限公司 · 证券代码 688369
? 成立于 2002 年 · 2019 年科创板上市
? AI-COP 数智化协同运营平台
? 服务超 5 万家中大型政企客户
? ?? 服务热线:400-700-8822
? ?? 知识库:support.seeyon.com
关注公众号「致远互联微服务」
定期更新运维知识干货 ?

原文链接
多空观点 观点仅供交流,不构成投资建议
点赞
踩一踩
收藏
分享

评论 (0)

0/200
声明:社区内容仅代表用户个人观点,不构成任何投资建议。投资有风险,入市需谨慎。