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服务管家”并进行使用。
其中,资料荟萃中包含资料如图所示,下载链接:资料荟萃