1993-2022金蝶国际软件集团有限公司④内部公开请勿外传实体运行监控工具介绍202310金蝶云·苍穹领域模型服务部2④内部公开请勿外传0203背景介绍04功能介绍实例讲解FAQ目录01模拟用户操作复现bug查看错误日志、输出调试信息等方式来定位问题分析问题产生的原因找到问题产生的原因后，可以针对原因进行修复确定问题定位问题分析问题修复问题痛点分析信息对于整体bug修复、问题分析至关重要，拿到信息后，我们要对bug提出猜想，快速论证为大家提供轻量级监控工具，可快速收集调试信息4①常见业务场景5①实体运行监控工具介绍实体运行监控框架数据采集监听分析信息展示对金蝶云苍穹-动态领域模型运行引擎进行监控，收集关键方法的输入、输出参数，以便在问题发生时分析问题。可通过监控界面，实时查看收集上来的数据，在线分析、诊断问题。为了避免陷入信息海洋，使显示的信息更加聚焦，监控框架对信息进行分类，设置了多种监听方案各自关注特定信息。只有启用了特定监听方案，监控界面才会显示此监听方案所属的信息。6①解决方案单据编辑、引入、转换、反写等过程字段值，什么时候被改？改成什么值？字段值改动分录行增删单据分录行什么时候被改、被谁做了增删处理？操作提示单据提交失败，显示提示，此提示从何而来？调用性能消耗在哪里？内部做什么处理？方法执行线上环境出问题，怀疑某方法输入输出参数不正确7①位置&版本•V5.0.12及以上版本（未挂菜单：在开发平台中搜索【实体运行监控】或【bos_entitytraceview】）•V6.0.X以及上版本【系统服务云-日志管理-实体运行监控】(后续规划2023Q4)028功能介绍9①整体操作流程分析结束后，停止监控，避免系统运行损耗返回实体运行监控界面，查看相应日志，分析问题实体运行监控页中，启用监听根据实际场景配置相应监控方案切换回页面界面，复现问题10①页面功能介绍•聚焦追溯：打开信息聚焦界面，把所选行的直系父级调用链及子级调用链按树形结构显示出来，以便分析调用链全过程•引出单据体数据：把信息表格中所选行数据引出，保存在本地④内部公开请勿外传11适用于监听字段改动，追溯调用来源1.字段值改动监听选择监听实体选择实体中对应字段，允许为空，默认监听全部字段④内部公开请勿外传12字段值改动监听-实例分析1234定位到具体插件④内部公开请勿外传13用户点击业务单据的提交操作，长时间没有返回结果，不知道性能消耗在哪里，为什么慢？代码调用耗费监听方案开启后，会监听所有表单服务请求消耗，并记录其内部调用的子方法次数和耗时，最后为每次表单服务请求输出一条性能消耗报告，可基于此报告，找出性能问题点。2.代码调用消耗•单节点耗时监听阈值：默认10ms，只有超过此消耗的子方法，才会被记录调用次数。•单节点参数输出阈值：默认100ms，子方法执行时间超过此阈值，会在性能报告上输出此子方法的执行参数，以便分析问题；•输出性能报告阈值：默认500ms，超过此阈值的表单服务请求，会输出性能报告。•监听类名：可选，指定需监听的类标识，具体类标识可参考表单服务输出的性能报告。默认空白，监听表单服务的性能（表单服务类标识为“FormService”）；•监听方法名：可选，指定需监听的方法名，结合监听类名，就可以指定出需监听的特定类、特定方法，忽略其他无关的表单服务；Tips：调高对应阈值，可忽略消耗不高的子方法，使性能报告更加简洁④内部公开请勿外传14代码调用消耗-实例分析查询数据库的工具类业务只需关注自己的插件④内部公开请勿外传15线上产品出问题时，根据问题现象推测，可能是某个代码方法有问题，需要确认该方法的输入、输出参数，确认是否符合推测，此时可以使用方法执行监听器，指定类和方法，监听其他输入、输出参数。3.方法执行监听•列表取数：可监听列表取数方法，输出取数条件监听方法:list.ListDataProvider.getData•表达式运算：可监听表达式的执行，输出表达式文本、变量值、计算结果监听方法：formula.*•数据保存：可监听单据保存方法，输出保存的数据包内容监听方法：datawriter.*•页面缓存更新：可监听页面缓存更新方法，输出页面缓存数据监听方法：pagecache.*•操作服务：可监听操作服务执行，输出操作参数、数据库、操作结果监听方法：opservice.OperationService.invokeOperation•单据读取：可监听单据读取服务执行，输出取数参数，取出的数据包监听方法：datareader.loadSingle•下达客户端指令：可监听表单向前端下达的全部指令及内容，追溯调用来源监听方法：clientview.*•应用缓存更新：可监听应用缓存（即AppCache）的更新服务，输出缓存内容；监听方法：appcache.*④内部公开请勿外传16方法执行监听-实例分析表达式运算手工指定监听建议：对平台代码非常熟悉，才使用手工方法执行监听。需要加入监听方案，才能被捕捉④内部公开请勿外传17当分录行数不符合预期时，开启此监听方案聚焦于单据分录行的增加、删除操作，能够在线快速定位操作来源4.分录行增删•监听实体：需监听的表单、单据、基础资料•监听分录：许监听的单据体，可以不设置，会监听本单各单据体的增删行•分录操作：指定是监听增行还是删行，可以不设置，会同时监听增行、删行④内部公开请勿外传18分录行增删-实例分析保存后，自动清理空行定位到此方法④内部公开请勿外传19操作提示监听方案可报告出操作提示来源，并给出实际代码调用链（无需额外配置）5.操作提示-实例分析3④内部公开请勿外传20监听运行中的异常，输出执行参数和过程变量值（无需额外配置）6.异常监听领域模型运行引擎内部出现未知异常，或主动抛出异常时，会在后台日志中记录异常代码调用堆栈，部分异常直接通过堆栈就可以分析出问题，另外还有一些异常会和运行参数密切相关，仅仅通过堆栈无法分析出问题，需要结合当时的运行参数一起分析。异常监听方案会在后台运行，全天监听领域模型运行引擎捕获的异常，发现异常后，即时把异常调用链路上收集到的运行参数输出到后台日志。④内部公开请勿外传21业务功能插件开发完成后，可使用插件性能审计监听方案，实测性能消耗。7.插件性能审计0322演示④内部公开请勿外传23演示实例1、字段值监控2、性能监控3、方法执行监听-列表取数0424FAQ④内部公开请勿外传25FAQQ1：方案能否保存、导出?A1：不能，此工具为快速定位问题使用的轻量级工具，不想操作过于复杂Q2：一个账号多人同时使用，是否有影响？A2：按租户+用户+sessionid区分,互不影响Q3：社区帖子，后续有案例会更新A3：https://club.kdcloud.com/article/494819274070829824?productLineId=29&isKnowledge=21993-2022金蝶国际软件集团有限公司④内部公开请勿外传
