Insigh Sharp日志解析工具使用指导书(更新版本).docx

文档名称文档密级： Insight Sharp日志解析工具使用指导书1.介绍Insightsharp V100R002C00SPC100继承了V100R001C00版本所有功能，但是V100R001C00版本的适配包和Insightsharp V100R002C00SPC100不兼容，需要使用Insightsharp V100R002C00SPC100配套的XML2DLL工具重新生成适配文件。2.Insight Sharp工具安装路径1）Insight Sharp工具版本InsightSharp V100R002C00SPC100工具获取及安装请参考Insightsharp V100R002COOSPC100 软件安装指南.doc。2）日志配置文件由BSC6900版本发布时配套发布，可以通过访问/网站获取对应版本的日志配置文件，存放目录如下：SoftwareOthertoolsLog Tools2G日志配置文件cfgfile3.Insight Sharp工具配置文件设置Insight Sharp工具安装后，会自动生成如下目录：C:Program FilesInsightsharpV12InsightsharpV12data1）如果是第一次配置Insight Sharp工具：需要在data目录下新建两级目录MBSCBSC6900V9R12C01B073(文件夹可以随意命名)，MBSC代表产品；BSC6900V9R12C01B073指示版本；将data文件夹中的InsightSharp_Product.ini文件拷贝到新建的BSC6900V9R12C01B073文件夹里；2）将BSC6900版本发布时对应的日志配置文件都拷贝到新建的BSC6900V9R12C01B073文件夹里。日志配置文件获取路径请参考2.2描述。注意：1）Insight Sharp工具配置过一次后，以后每次版本发布时，只要直接使用发布的配置文件替换BSC6900V9R12C01B073文件夹中的文件即可；2）大家也可以根据自己的需要和喜好，在C:Program FilesInsightsharpV12InsightsharpV12dataMBSC目录下建立多个文件夹，放置不同版本的配置文件，但一定记住，需要同时拷贝一个InsightSharp_Product.ini文件放至文件夹里。4.Insight Sharp工具工程创建步骤1）双击Insight Sharp工具的可执行文件ECHR.exe打开Insight Sharp工具，会跳出工程管理窗口，需要新建工程； 2）点击“新建”按钮，新建工程l “名称”需要设置；l “描述”可以不用设置；l “配置版本”需要设置，设置方法参考下面的第3）步“配置版本如何设置”；l “保存到”路径可以不用设置，使用默认即可；l “工程文件”需要增加，增加需要一起解析的日志文件即可；3）“配置版本”如何设置打开日志文件后会跳出“版本配置”窗口（如下图所示）需要选择配套的“产品”、“版本”、“配置文件”和“编码解释文件”l “产品”选择“MBSC”l “版本”选择放置配置文件的文件夹名称，例“BSC6900V9R12C01B073”l “配置文件”选择工具安装目录如下目录中的GSM DEBUG.xml文件：C:Program FilesInsightsharpV12InsightsharpV12dataMBSCBSC6900V9R12C01B073注意：打开的日志类型不一样，打开的配置XML文件不一样；打开DEBG日志选择GSM DEBUG CFG.xml文件；打开GCSR日志选择GSM BSC GCSR CFG.xml文件；打开GCHR日志选择GSM BSC GCHR CFG.xml。l “编码解释文件”选择工具安装目录如下目录中的GBSC CHR.dat文件：C:Program FilesInsightsharpV12InsightsharpV12dataMBSCBSC6900V9R12C01B073版本配置设置完成后，点击“确定”4）“配置版本”设置完成后，“工程文件”增加完成后，点击“确定”，工程创建成功，如下截图：5）工程创建成功后，点击“打开”即可双击“工程导航树”下“工程名称”节点，则会打开该工程下的所有日志双击“工程导航树”下某个日志文件节点，则仅打开该日志文件中的日志若工程导入的日志较多，需要耐心等待工具处理 5. Insight Sharp工具也可以打开单独文件使用“打开”图标或者菜单，可以打开单个日志文件，不需要创建工程6.2G业务相关日志获取路径存储在安装目录.mbscbamcommonfamfamlogfmt下DEBG、GCSR、GPSR、UCHR均在该目录下，GCHR日志在mbscbamcommonfamfamlogfmtgchr下如下截图7.InsightsharpV1R2版本使用FAQ（工具使用者）1)、在用户安装新版本工具之前，必须卸载老版本的Insightsharp工具，然后安装新版本。2)、工具安装过程中，出现“执行设置注册表失败”，无法安装的情况时，是因为安装时用户名称和公司名称包含了标点符号，请去除。3)、在安装完成工具后，启动工具时，出现提示框：“由于应用程序配置不正确.”，是因为没有VC运行环境初始化组件，请运行ECHR.EXE目录中的vcredist_x86.exe文件即可。4)、申请License请参考Insightsharp V100R002COOSPC100软件安装指南2.2.1章节。申请时在填写从网站上下载的License申请EXCEL模板时，请遵照软件安装指南填写。Produce Name一项固定选择MAINEX Insightsharp。并在增加量（add）处填写1.5)、InsightsharpV1R2版本需要配合相关版本的适配包使用才可解析对应版本的数据文件，老版本的适配包不能兼容，需要从产品接口人处获取InsightsharpV1R2的适配包（2010年4月以后生成的）。6)、在使用工具分析无结果或提示“加载XML文件失败”时，请确认:a).使用的工具是否是老版本工具（新版本工具已经在SUPPORT网站发布）。 b).适配包版本号与分析日志的实际版本是否匹配（精确到SPC版本）。 如果是老版本工具请下载新版本工具使用。同时适配包文件也需要与新工具配套。如果没有配套的新适配包文件，请联系相关产品开发人员或工具部门获取。7)、如果确认工具分析有问题，请将有问题的日志数据文件、分析用的适配包文件（整个文件夹）全部压缩打包反馈，并注明制式，详细版本号，和问题现象。反馈给工具研发接口：00128538李磊，00128555杨建荣。 8)、工具分析规格问题：由于Insightsharp不依赖外部数据库，因此分析较大数据量时，可能会无法支撑分析。 工具可支撑多大日志量的分析，与您日志的数量，日志结构复杂程度，设置的显示字段数量和单个日志文件中包含的有效日志数量有关。 根据反复测试的结果，按照一般情况衡量，1GB内存的计算机能可靠支撑350MB解压缩后的文本日志分析，具体可分析的日志多少，与您计算机的虚拟内存有关。