学习目标

当遇到EAS整体性能问题时，学会需要收集什么日志进行分析
当遇到服务异常或宕机，学会如何收集日志

一、整体性能需要收集的日志

收集至少一个单点慢功能的RPC日志；
收集服务端和客户端线程堆栈日志；
问题发生时收集客户端eassupport日志；
问题发生时收集服务端eassupport日志；
若是Oracle数据库，收集数据库AWR、ADDM报告；
对EAS进行云巡检。

1.1收集RPC日志信息

RPC日志可通过客户端集成的【服务工具平台】进行收集，也可以手工收集。

1.1.1使用服务工具收集rpc日志

当业务操作出现操作慢的现象，可以重新打开客户端登录，进入【系统平台】-【系统工具】-【工具平台】-双击打开【服务工具平台】
点击我的工具中的【【emoji】】按钮，在工具列表中搜索【日志】，将搜索出来的日志工具下载添加到我的工具中
点击日志收集工具，会出现收集日志选项界面，选择收集RPC日志
打开日志收集工具后，，点击【开启rpc日志开关】会提示设置需要记录日志的操作执行视觉（毫秒），默认为5000毫秒，1秒=1000毫秒
打开一台客户端，操作慢的功能点，并记录问题功能点操作的起始时间。（如果是整体性能问题，可操作几个典型的功能点，并记录时间即可）；在同一台电脑上再打开一台客户端，打开RPC日志收集开关后进行收集RPC日志即可；收集完毕后请关闭RPC日志开关。
待rpc日志收集完成后，会返回日志收集成功信息，且有显示日志收集后的路径位置
1.1.2手工收集RPC日志

当没有服务工具平台可以自动进行收集RPC性能日志时，我们可以通过手工收集RPC性能日志，集群环境中，服务端会存在多个实例，本文档已指定其中主实例server1来做为日志收集的实例。

若不知道客户端访问的是哪个实例，可通过administrator登录EAS客户端，进入【应用】→【企业建模】→【安全管理】→【系统监控】→【用户监控】，找到登录的用户，查看【服务器url】字段中访问的是哪个实例的RPC端口，收集RPC日志时取该实例的http端口即可（若无法查看到http端口，可联系集团EAS运维管理员进行获取）

打开服务器端RPC性能日志开关，在浏览器中输入http://eas服务器ip:http端口号/easportal/tools/jmx.jsp，eas服务没有启动则运行不了；输入用户名密码界面 admin/admin
使用admin/admin登录进去后，进入如图-18所示界面，在该界面按ctrl+F搜索invokeCounter
点击invokeCounter进入RPC日志开关界面，找到RpcSqlOn,SqlPlanOn,KsqlOn分别设置为True; RPCSqlFilterTime和SQlPlanFilterTime置为false，点击左下角的Apply应用
打开操作的客户端RPC日志开关，进入客户端安装目录eas\client\deploy\client下，使用文件编辑工具打开PerfLog_Client.properties文件，将rpc=off改为rpc=on,请将filter_time=on改为filter_time=off，修改完成后需重新打开客户端操作功能点慢的业务。
重新登录客户端，操作性能慢的功能点，操作前可删除所有的客户端日志（\client\logs）；收集日志中过程记录，可用word记录下操作开始及结束时间，操作截图等，全部测试完成后，会在以下目录下产生性能日志文件，收集生成的rpc日志，注意，若下面文件的大小为0，则说明没有收集到，请检查上述过程是否有遗漏。
日志路径产生在以下路径：
服务器端：eas\server\profiles\server*\logs下的SqlPlanD.V60SP1.log，RpcSqlD.V60SP1.log
客户端：eas\client\logs下的rpcD.V60SP1.log

1.2收集服务端和客户端线程堆栈日志

当操作业务时遇到功能点卡慢，卡死且操作不成功，导致业务受到影响时，可收集线程堆栈日志提单到对应的业务模块进行分析；

1.2.1服务工具平台收集线程堆栈日志

当业务操作出现长时间卡住无法操作完成，且当前打开的客户端无法点击其他功能页签时，先从任务管理器查询当前javaw进程的进程号并记录，然后在该电脑上重新打开一台客户端登录，进入【系统平台】-【系统工具】-【工具平台】-双击打开【服务工具平台】
勾选收集服务端堆栈，分别选中all threads、http thread、RPC thread，收集次数为3次，间隔时间为120s（间隔时间可自行定义）
待线程日志收集完成后，会返回日志收集成功信息，且有显示日志收集后的路径位置
勾选收集客户端堆栈，选择问题客户端的进程号，收集次数为5次，间隔时间为30s。（间隔时间可自行定义）
选择日志保存目录后点击【确定】收集即可。

1.2.2手工收集服务端线程堆栈日志

收集服务端线程堆栈信息是通过在ie窗口输入以下地址：http://serverIP:http端口号/easportal/tools/threaddump.jsp，登陆eas，重现有问题的功能点，点击Living RPC threads界面，可以间隔一段时间后再次点击红色框中“living RPC threads”，另存网页。一般收集3个即可，间隔时间根据具体问题来定：长时间“卡”住的操作隔4,5分钟收集一次

服务端会存在多个实例，本文档已指定其中主实例server1来做为日志收集的实例进行演示。

若不知道客户端访问的是哪个实例，可通过administrator登录EAS客户端，进入【应用】→【企业建模】→【安全管理】→【系统监控】→【用户监控】，找到登录的用户，查看【服务器url】字段中访问的是哪个实例的RPC端口，收集RPC日志时取该实例的http端口即可（若无法查看到http端口，可联系集团EAS运维管理员进行获取）

1.2.3手工收集客户端线程堆栈日志

使用客户端线程堆栈工具收集，下载客户端线程堆栈工具，解压，把threadstack.bat放到eas目录下（和clientjdk目录在同一级）
出现功能点卡死时，双击运行该工具，选择时间间隔时请根据功能点的耗时来自行定义，若某个功能点预计耗时40秒，可选时间间隔为1秒，运行50次或更多，只要大于预计的时间即可。
等功能点运行结束了，若该工具还在执行，可以关闭即可
工具运行完后，会在当前eas目录下生成client_stack.log文件，将此文件收集即可

收集客户端堆栈工具.zip
将客户端堆栈工具解压，把压缩包里面的threadstack.bat放到eas目录下（和clientjdk目录在同一级）
出现功能点卡时，双击运行该工具，选择时间间隔时请根据功能点的耗时来自行定义，若某个功能点预计耗时40秒，可选时间间隔为1秒，运行50次或更多，只要大于预计的时间即可。

等功能点运行结束了，若该工具还在执行，可以关闭即可
工具运行完后，会在当前目录下生成client_stack.log文件，将此文件收集即可
生成client_stack.log文件，对应客户端线程堆栈，"AWT-EventQueue-0"是主线程，一般分析这个线程的调用变化情况即可，另外若有开启新的线程，一般都是有"RPC-XXX"字样的，分析这些线程即可。

1.3问题发生时收集客户端eassupport日志

进入客户端的配置目录下，找到【eassupport.bat】的windows批处理文件，双击以管理员身份运行该程序，会进入到收集客户端各项日志界面
当eassupport程序收集日志完成后是以压缩包的形式体现，会在当前界面显示信息收集完毕，并在收集日志框末尾显示收集后的日志压缩包名，以及存放路径。

eassupport所收集的日志会包括客户端的EAS运行日志、系统配置、网络诊断信息、当前的线程堆栈等信息，所以收集的日志时间较长，需耐心等待。

1.4问题发生时收集服务器端support日志

进入服务器端安装目录EAS_HOME:\kingdee\eas\server\bin目录下，找到【eassupport.bat】windows批处理程序，以管理员身份运行，
服务端的eassupport日志收集会收集EAS服务器端的相关配置文件、系统配置信息、EAS服务器端的配置文件以及会对EAS进行测试，所以收集日志的时间会稍长，请耐心等待日志收集完毕；日志收集完成后，会在收集日志的界面框显示信息收集完毕，并在收集日志框末尾显示收集后的日志压缩包名，以及存放路径。

若是Oracle数据库，还需收集数据库的AWR、ADDM报告，收集的方法请参考附件《ORACLE数据库(11g或10g)AWR与ADDM报告收集方法》

或社区视频

Oracle数据库addm报告收集 https://vip.kingdee.com/school/87571539914080000

Oracle数据库awr报告收集 https://vip.kingdee.com/school/87572971782356736

ORACLE数据库(11g或10g)AWR与ADDM报告收集方法.pdf下载

当EAS应用出现整体性能问题时，建议对EAS系统进行云巡检

《学习部署、运行云巡检工具》

《云巡检报告解读》

二、宕机需要收集的日志

当遇到实例显示服务异常，或者无人操作状态显示为已停止时，需要分析原因，则需要收集以下日志

检查是否产生宕机日志，若有则收集
实例的jvm_gc日志、apusic.log、server.trace
健康度相关日志：ha.log、admin_cc

2.1确认是否产生宕机日志

若遇到实例异常，某些情况下不会自动产生宕机日志，那么怎么判断是否产生宕机日志，以及没有产生宕机日志该怎么办呢

2.11收集自动产生的宕机日志

宕机日志一般产生在实例的bin目录下：eas/server/profilese/server*/bin

确认是否产生***heapdump***、javacore***.txt文件等文件，如下图的javaheapdump_***.hprof

检查是否有产生hs_err_pid*.log，该日志为java程序异常退出日志

如有产生以上日志，拷贝对应日志文件打包压缩即可，需注意日志产生时间是否与问题发生时间吻合。宕机日志通常比较大无法直接上传到提单中，可参考一招学会EAS Cloud提单日志上传链接，将宕机日志压缩后上传到金蝶的ftp服务器上。

【注】打包前建议检查磁盘空间是否足够，宕机日志一般比较大，如果有历史的宕机日志，不需要分析原因的话或者已分析过，可将历史的宕机日志删除，避免占用过多的磁盘空间。

2.1.2手工收集宕机日志

jvm_gc日志里面频繁的输出了Full GC日志，但是实例没有产生宕机日志该怎么办呢？

若是使用的ibmjdk
heapdump日志：
运行网址http://IP:httpPort/easportal/tools/dump.jsp?type=heapdump
（其中IP为服务器ip地址，httpPort为实例的http端口，可从管理控制台应用服务器页签上获取，这两个值需修改为现场环境实际值。）
core*.dmp日志：
执行 kill -6 <pid> 其中<pid>为实例java进程号，可从应用服务器页签获取。
或运行网址http://IP:httpPort/easportal/tools/dump.jsp?type=systemdump
若是使用的Oraclejdk
Windows系统： jmap –dump:format=b,file=<filename><pid>
Linux系统：jmap –heap:format=b <pid>
需先进入oracle jdk的bin目录下再执行上述命令，其中<pid>为EAS实例进程号，
在管理控制台应用服务器页签获取，<filename>是即将产生的日志文件命名

2.2收集实例的jvm_gc日志、apusic.log、server.trace

实例的jvm_gc日志、apusic.log、server.trace均在实例的logs目录下

路径：eas/server/profiles/server*/logs

jcm_gc日志：每次实例启动都会产生一个，用于记录实例内存回收机制，文件名为实例启动时间。

如果实例频的jvm_gc日志频繁切持续的出下图这种full GC日志，则可判断为实例OOM，内存溢出了。

apusic日志路径：eas/server/profiles/server*/logs

EAS8.6.1更新较新的补丁后，apusic日志文件名会从 apusic.log.* 变成 apusic*.log

server.trace日志：用于记录的实例启动和停止记录Kill server：通过控制台操作停止实例

Stop：执行实例bin目录下的stopserver命令停止

Start：启动实例

Auto kill server：群集控制器通知管理控制台重启实例

2.3健康度相关日志

控制台ha.log和admin_cc日志，路径：eas/admin/logs

相关日志内容解释;

健康度差（ Server‘s health degree is bad ）的原因包含：

①线程死锁（ Thread_dead_lock ）

②数据库连接池泄露（Connection_pool_leakage）

③响应时间超时（网络问题/gc时间过长，累计5次超出10s）

④内存不足

ha.log只有一个，admin_cc按日期区分，需取问题时间点当天的admin_cc日志。

整体性能和宕机日志收集妙招

恭喜您！