VM应用和开发问题排查及异常收集工具

0 阅读6分钟

1.VM问题采集助手

1.1 软件说明

  VM问题采集助手集多项功能于一体,目的是帮助客户快速定位和修复环境类问题,降低在非代码类、功能性问题上的沟通成本,提高问题排查效率。

  首先检测VM安装环境或VM SDK开发环境是否正常,软件提供一键修复功能。然后,若修复环境后,仍然不能解决问题或定位问题具体原因,则利用软件调整日志等级(一般调整为Debug等级),软件运行时底层将打印更详细的日志信息。

  最后,利用软件日志收集功能,获取系统和软件版本信息、VM日志、算子日志和dump文件等研发排查问题所需文件的压缩包。

  用户将日志压缩文件、问题现象和出现问题的时间点及时反馈给研发,以防日志发生覆盖。

  适用VM版本:VM4.0及以上;   其中日志调整功能适用版本:VM4.2及以上。   针对VM4.0-VM4.2,下载链接:   VM知识荟萃   针对VM4.3/4.4,获取方式如图所示: 在这里插入图片描述

1.2 VM环境检测

   检测VM版本,VM系统环境变量,用户权限,python版本,加密驱动,相机驱动,软件运行依赖库,算子版本等等。

在这里插入图片描述

1.3 SDK引用

在这里插入图片描述

1.4日志调整

  当无法定位问题原因时,需要调整日志等级(一般调整到Debug级别),收集更详细的日志信息。

  注意:当前版本只适用于自动调整VM4.2及以上版本日志等级,其它版本需手动增加文件。

在这里插入图片描述   切换等级完成的是在指定文件夹下增加相应的文件(也可以根据下面描述手动增加文件,新建一个txt,根据下面描述命名,然后去掉后缀),例如将日志等级调整到Debug级别(级别简写:i,t,d,e)。   还原等级则是删除所增加的文件。

1. 4.1 针对VM4.2:

  \Applications路径下增加文件:sdk_log_d;   \Applications\Server路径下增加文件:server_log_d;   \Applications\VmModuleProxy\x64路径下增加:proxy_log_d,vmframe_log_d,module_log_d。

1.4.2 针对VM4.2 SDK:

  项目exe生成路径下增加文件:sdk_log_d;所以需要在上一步中输入项目exe生成路径。

1.4.3 针对VM4.3和VM4.3 SDK:

  \Applications路径下增加文件:sdk_log_d;   \Applications\Server路径下增加文件:server_log_d;   \Applications\VmModuleProxy\x64路径下增加:proxy_log_d,vmframe_log_d,module_log_d。

1.4.4 针对VM4.0和VM4.0 SDK:

  需要手动增加文件来达到调整日志文件效果,复现问题后,需要手动删除所增加的文件。

  VM SDK:在VisionMaster.exe或目EXE生成路径的同级目录,新建一个文件夹,重命名为sdk_debug(日志等级调整为debug)或sdk_trace(日志调整为最低等trace);

  Server:在VM安装目录\Applications\Server中建一个文件夹,重命名为server_log_d(日志等级调整为debug)或server_log_t(日志等级调整为最低等trace);

  模块框架:在VM安装目录\Applications\VmModuleProxy\x64中建一个文件,重命名为vmframe_log_d(日志等级调整为debug)或vmframe_log_t(日志等级调整为最低等trace)。

1.5 日志收集

在这里插入图片描述   VM应用问题,则勾选VM应用问题日志;

  VM SDK问题,则勾选VM SDK问题日志,项目exe生成路径可以根据提示选择文件夹路径。

  勾选VMSDK问题日志时,会默认同时收集VM日志和项目exe生成路径下的日志。根据下面描述,也可以根据路径手动收集日志。比如,算法SDK开发问题,则只需要手动收集算子日志即可,其中算子版本可以查看C:\Program Files (x86)\MVDAlgorithmSDK\ReferencedAssemblies\Algorithms中MVD_Algorithm.Net.dll的属性-详细信息页-产品版本。

1.5.1 VM应用问题

需要收集的信息:   1).VM版本:VisionMaster\Applications路径下VersionInfo.config;   2).VM日志:VisionMaster\Applications路径下log文件夹;   3).VM Dump文件:VisionMaster\Applications路径下所有文件中的后缀为dmp的文件,包含Application及Application所有的文件夹中;   4).算子日志:C:\Windows\Temp路径下MVDSDKLog文件夹;   5).系统信息:此工具自动收集到BaseInfo.txt中;   6).系统日志:此工具自动收集到SystemEventLog.txt中。

1.5.2 VM SDK问题

需要收集的信息:   1).VM版本:VisionMaster\Applications路径下VersionInfo.config;   2).VM日志:VisionMaster\Applications路径下log文件夹;   3).VM Dump文件:VisionMaster\Applications路径下所有的后缀为dmp的文件,包含Application及Application所有的文件夹中;   4).算子日志:C:\Windows\T\emp路径下MVDSDKLog文件夹;   5).系统信息:此工具自动收集到BaseInfo.txt中;   6).系统日志:此工具自动收集到SystemEventLog.txt中。   7).VMSDK日志:项目exe生成路径同级目录下的log文件夹和dump文件,此工具将全部收集到Development文件夹中。

2.VM常见开发问题排查

2.1 问题排查工具可通过资料荟萃链接进行下载

  FAQ&排查手册&工具:FAQ&排查手册&工具

  VM应用&开发资料荟萃:VM应用&开发资料荟萃

2.2 VM开发问题排查工具使用步骤

  1.加载项目配置文件(CSharp配置文件后缀csproj,C++配置文件后缀vcxproj)后自动触发检测。

开发环境检测项

  1).VM版本和补丁:检测当前VM版本及补丁是否正确及最新;   2).项目名称、平台、框架、引用:检测项目名称、平台类型、.netFramework框架版本、引用库属性是否正确;   3).加密狗:检测加密狗版本及是否插上;   4).本机权限:检测电脑是否管理员权限(需管理员权限运行);   5).GAC程序集:可手动执行,确保GAC安装成功。

  2.等待检测完成,根据检测项状态查看提示或进行修复。   3.除环境类的其他类问题,可根据提示进行相关排查。 在这里插入图片描述

2.3 VM安装路径中开发手册路径

  1.VM SDK开发手册:VisionMaster4.X.0\Development\V4.x\Documentations   2.算子SDK开发手册:C:\Program Files (x86)\MVDAlgorithmSDK\Documentations

3.资料链接

  1.VM的AI助手   使用方法,请参考: 秒懂VisionMaster!「VM助手」上线   2.VisionMaster软件在线手册   3.【V社区】:机器视觉交流平台,可进行提问和发表文章。   4.【大话视觉】:CSDN平台推出的博客,涉及VM应用、开发和案例等专栏。   5.【VM服务管家】:为微信小程序,可以直接用手机搜索小程序“VM服务管家”并进行使用。 在这里插入图片描述   其中,资料荟萃中包含资料如图所示,下载链接:资料荟萃