在当前页:
生成快照
要生成快照,需要使用应用程序编辑器中的“执行”选项卡:
然后将显示一个向导,允许您根据需要设置各种日期和命名选项:
点击放大
- 初始常规信息向导页面允许您选择:
- 捕捉日期 — 默认情况下,将预先选择当前日期。如果要提前或推迟快照的日期,请在日历中选择正确的日期。请注意,您也可以使用日期选择器下面的字段选择时间(24小时制适用)。完成后,捕捉日期将显示如下:DD/MM/YY HH:MM
- 标签 — 默认情况下,标签将由CAST Management Studio根据打开向导的日期和时间预先确定。但是,您可以输入自己的标签 — 但请记住,标签显示在CAST仪表盘中。请注意,如果更改捕捉日期,标签将不会自动更新 — 如果希望保留基于标签的日期,则需要手动更新它。
- 应用程序版本 — 默认情况下,CAST Management Studio将输入当前版本名,但是如果需要,您可以自由更改此名称。
- 填写完所有字段后,单击“下一步”继续。然后将显示执行选项屏幕:
- 此页面允许您选择:
- 如果在应用程序启动期间生成第一个快照,CAST建议您停用将快照上传到测量服务(如果已配置)选项。 这将避免将不需要的或不正确的信息上传到健康仪表盘。
- 如果此初始快照生成成功,您可以手动将结果上传到测量服务,而无需重新生成快照:请参阅下面标题为将快照数据上载到测量服务的部分。
- 单击完成。
- 然后,CAST Management Studio将自动为当前应用程序生成快照。
- 完成后,您应该在对话框中看到操作进程的逐步列表:
请注意,CAST支持在同一工作站(是否通过GUI/CLI)上同时生成快照,条件如下:
快照当前正在进行中
当快照失败时,或者当快照运行时通过单击“取消”按钮取消快照时,这意味着仪表盘服务架构将处于不一致状态。下次使用“获取快照”选项时,将显示一个弹出窗口,询问您是要继续还是删除正在进行的快照:
您应按以下步骤进行:
- 如果快照因错误而中断,则必须确保不勾选“继续执行当前正在运行的快照”选项,然后单击“完成”。这将删除中断的快照。
- 如果由于在快照运行时单击了“取消”按钮而中断了快照,请确保勾选了“继续执行当前正在运行的快照”选项,然后单击“完成”。这将继续处理中断的快照。
快照警告
“应用程序X”需要在拍摄快照之前进行分析
如果在尝试生成快照时收到上面显示的警告,则有两种可能:
- 如果这是您第一次生成快照,并且作业以前没有进行过分析,则“跳过分析作业”选项(在生成快照时显示的选项向导中可用)将意味着生成快照时没有首先运行分析。这可能导致不完整的结果。 如果之前没有单独分析作业,请确保取消勾选“跳过分析作业”。
- 如果您收到此警告,且作业之前进行过分析,那么LISA、LTSA和日志首选项(在分析中使用)可能已更改。 如果您在完全不同的工作站上运行CAST Management Studio,则可能会发生这种情况。 如果是这种情况,那么CAST Management Studio将考虑配置已更改,并将分析作业视为以前未运行过。在这种情况下,CAST建议您在继续生成快照之前取消勾选“跳过分析作业”选项。
检查快照结果
检查快照生成结果的最简单和最快速的方法是打开工程仪表盘并查看结果。 如果您还没有设置一个(或您的许可协议不允许您安装一个),您可以通过单击CAST仪表盘服务编辑器中的打开工程仪表盘选项来调用“即时”工程仪表盘 :
使用该选项时,系统将提示您输入访问仪表盘的凭据:admin/cast(区分大小写)。请注意,此用户只有管理员身份 — 参阅ED - 配置用户身份验证。
检查结果的提示
检测任何第三方库、生成的代码或未由项目维护的代码
- 影响:这个源代码对项目不重要,因为项目不能做任何与其相关的事情。最好把它排除在外。
- 修正:从仪表盘中排除此源代码。它应该由应用智能平台进行分析,但不应该出现在仪表盘中。
- 细节:大多数情况下,第三方库非常复杂,而文档不是。
- 提示:例如,您可以在顶部的圈复杂性选项卡中查看它。或者您可以搜索一些特定的字符串模式,如“gen”、“test”……
检查模块重量
- 影响:模块聚合不好,评估质量不好。
- 修正:通常,良好的聚合是通过工件的聚合完成的。
- 细节:默认情况下,在整个应用程序上测量成绩
- 提示:整合模式在CAST Management Studio的评估模型中定义:
检查死代码/未引用的函数或方法
- 影响:一些处理未引用对象的规则具有很高的权重,这些规则对于项目帮助识别源代码中快速失效的代码非常有用。
- 原因:未引用的对象可能是由于未正确管理特定框架而导致的配置错误。
- 修正:检查配置并再次运行分析。
- 提示:在工程仪表盘中,您可以查看以“未引用的XXX”开头的规则。
检查命名约定(如果已配置)
- 影响:默认参数通常是错误的,处理命名规格的规则通常很低。
- 修正:评估评估模型并更改这些规则的参数。
- 提示:小心这些类型的变化,影响非常低,因为它处理的是文档、可转让性……人们更关注性能或健壮性。其次,为了保持一个良好的基准线,并且能够比较苹果和苹果,有时候最好不要纠正它。
点击放大:
检查文件卷
- 影响:确保在卷方面,在输入(在源文件夹中)和输出(工程仪表盘)中有相同范围的文件。
- 修正:如果某些文件丢失,您可能需要重新分析应用程序。
- 提示:存在一些开放源码工具(如cloc),帮助您计算源代码文件夹中的文件数。
点击放大:
删除快照
如果初始快照不满意,请将其删除 — 这将从仪表盘服务和测量服务中删除它(如果您选择将结果上传到测量服务):
- 选择快照
- 单击下面突出显示的“删除”按钮
- 现在,您需要进行所需的任何配置更改,然后重新生成快照。
将快照数据上传到测量服务以便在CAST健康仪表盘中查看
如果快照现在包含您期望的信息,则可以将其上传到测量服务:
请注意,健康仪表盘可以正式支持最多200个应用程序的上传。 CAST建议您只从业务角度选择最关键的应用程序 — 即需要由CIO和管理人员以高可视性监控的应用程序。
手动上传
您可以手动加载刚刚生成的快照到测量服务,以便在健康仪表盘中显示:
自动上传
当您为应用程序的后续版本生成快照(即您已经登录的版本),且您确信快照生成的结果是正确的(即新的源代码更改相对较小),则您可以使用快照生成向导中的加载快照到测量服务(如果已配置)选项,在快照生成期间自动将快照数据上载到测量服务:
在健康仪表盘中查看结果
将快照数据加载到测量服务后,CAST建议您在健康仪表盘中查看结果。 但是,您可能首先需要重新加载健康仪表盘缓存,以便正确显示结果:
重新加载健康仪表盘缓存
健康仪表盘具有数据缓存功能,以提高仪表盘中显示数据的速度。这意味着当请求数据时,健康仪表盘可能直接从缓存返回数据,而不是从度量服务获取数据。 这意味着仪表盘中显示的数据可能不是最新的 — 特别是如果您最近生成了快照并将数据加载到测量服务,并且希望看到此新数据。
要重新加载缓存,请参阅HD-ED - 重新加载缓存
查看结果
浏览健康仪表盘,登录并检查结果:
http://server[:port]/CAST-Health/