|
|
Log_Visualizer 是一个命令行实用程序,被设计为辅助应用程序 HostMonitor.
Advanced_Host_Monitor 的专业版和企业版许可证已包含 Log_Visualizer 的许可证。
Starter 或 Professional 许可证的持有者可以单独购买 Log_Visualizer 的附加许可证。 |
介绍
用法
设置配置文件
系统要求
价格
HostMonitor可以将测试结果存储在日志文件(DBF、HTML、文本)中,也可以使用用户指定的数据库来保存测试结果的历史记录。
Log_Visualizer的目的是按需可视化某些测试项目的测试结果。
该应用程序解析日志文件的内容,并将一段时间内的测试结果显示为各种图表。
Log_Visualizer 和有什么区别 Log_Analyzer?
- Log_Analyzer提供有关日志中列出的所有测试项目的信息; 它为一组测试创建报告。 Log_Visualizer 为特定测试项目创建图表。
- Log_Analyzer 可以用作 GUI 应用程序和命令行实用程序,而 Log_Visualizer 是命令行实用程序; 它被设计为由 HostMonitor 或您自己的自制脚本启动(尽管它也提供了一些简单的 GUI)。
- 当您需要图表进行单一测试时,最好使用 Log_Visualizer,因为它针对此类任务进行了优化。
Log_Visualizer 使用特殊格式的文件(存储库)来存储按每小时、每天、每周和每月的测试项目分组的中间数据。
这个技巧可以帮助应用程序显着提高生产力和执行速度。
当您需要大量测试项目的图表报告时,Log_Analyzer 可能更合适。
Log_Visualizer 创建图表,显示指定时间段(日、周、月等)内的测试结果。 根据命令行参数,图表可以存储在指定的文件(GIF 格式)中,也可以在屏幕上显示相同的图表。
使用 Log_Visualizer 您可以:
- 定期使用 Log_Visualizer 创建的图表撰写您自己的文档; 例如 您可以创建包含图像链接的 HTML 模板,并使用调度程序启动 Log_Visualizer 定期更新图像(例如,每个午夜)
- 在桌面上为特定测试项目创建快捷方式; 然后您可以通过简单的点击操作调出图表进行测试;
- 另外,如果您安装了 Log_Visualizer,HostMonitor 将通过“测试信息”对话框窗口提供其他选项。 HostMonitor 将显示按钮,允许您调出测试项目的图表
LogVisualizer 可以利用所有类型的日志文件:HTML、文本和 DBF 日志文件。 它还能够利用通过 ODBC 接口存储在各种数据库中的日志记录。
使用方法及输入参数
当您使用 HostMonitor 启动 Log_Visualizer 时,HostMonitor 会检查 logvisualizer.ini 文件,调整参数(例如 ODBC 数据源参数)并利用必要的命令行开关以免维护模式启动实用程序。
因此,您只需单击一个按钮即可查看指定测试项目的图表。
当您手动启动 Log_Visualizer 或需要创建自己的脚本来启动该实用程序时,请使用以下命令行语法:
logvisualizer.exe -testid:<testID> -logprofile:<profile_name> [-inputfile:<log_filename>] [-outputimage:<image_filename>]
[-period:<chart_period>] [-daysback:<number_of_days> | -starttime:<mm/dd/yyyy>]
[-setmax:<upper_limit>] [-setunits<unit_specificator>]
前 2 个参数是必需的:
-testid | testID - 应分析和可视化的测试的 ID。 您可以使用HostMonitor的测试信息对话框来查找某些特定测试项目的ID。
如果您需要知道所有测试项目的ID,您可以使用
Custom HTML report 和 %TestID%
macro variable 在模板中。 |
-logprofile | profile_name - 包含应用程序设置的文件的名称。
看 设置配置文件 部分了解详细信息。
当配置文件位于当前目录时,您可以指定不带路径的文件名 (例如 -logprofile:logvisualizer.ini), 否则你应该提供文件的路径 (例如 "-logprofile:c:\program files\hostmon\lv2.ini") |
其他参数可选: |
-inputfile | log_filename - HostMonitor 的日志文件(HTML、TXT 或 DBF)。 当未指定inputfile时,Log_Visualizer将检查ODBC日志设置。 如果指定了ODBC日志,则将使用它来进行分析。 |
-outputimage | image_filename - GIF 文件的名称。 如果指定此参数,Log_Visualizer 将创建带有图表图像的 GIF 文件。 应用程序不会在屏幕上显示任何内容。 |
-period | chart_period 参数指定应显示的时间范围长度和图表的精度。 有多种可视化级别可用:
- DayByHours - 基于过去 48 小时的每小时图表
- WeekByHours - 基于 1 周数据的每小时图表
- WeekbyDays - 基于 1 周数据的每日图表
- MonthByDays - 基于 1 个月数据的每日图表
- MonthByWeeks - 基于 1 个月数据的每周图表
- YearByWeeks - 基于 1 年数据的每周图表
- YearByMonths - 基于 1 年数据的月度图表
|
-daysback |
此参数允许您将图表使用的时间间隔移动一定的天数。 默认情况下,回溯时间设置为 0。
这意味着图表边界是相对于当前日期计算的。 如果您将日期设置为 1,图表边界将从昨天开始计算,依此类推。
注意:您还可以为 daysback 参数指定负值。 与仅将图表边界向后移动的正值不同,负值具有取决于图表周期参数的预定义含义。
有一个特殊值列表:
如果图表周期设置为 WeekByHours 或 WeekByDays,您可以使用以下数字作为日回参数
-3 图表的开头将与本周的第一天对齐
-4 图表的开头将与上周的第一天对齐
-10 两周轮班,与一周的第一天对齐
-11 三周轮班,与一周的第一天对齐
如果图表周期设置为 MonthByDays 或 MonthsByWeeks,您可以将 daysback 参数设置为使用以下值:
-5 初始图表边界将与本月的第一天对齐
-6 初始图表边界将与上个月的第一天对齐
-9 两个月班次,与该月的第一天对齐
如果图表周期设置为 YearByWeeks 或 YearByMonths,您可以使用以下数字作为 daysback 参数
-7 左侧图表边界将与今年的第一天对齐
-8 左侧图表边界将与去年的第一天对齐 | -starttime |
有时您可能需要可视化特定时间段的日志数据,而不是显示最后一天/一周/一个月的测试结果。
在这种情况下,您可以使用 -starttime:mm/dd/yyyy 命令行参数而不是 -daysback 参数。 |
-setmax |
<upper_limit> 指定垂直轴的上限。 您可以使用此参数以不同的比例显示测试的“回复”值。
例如,对于 CPU 使用率测试,您可以使用 -setmax:100 选项将纵坐标轴设置为 100(%)。
<upper_limit> 可以指定为整数或数字和特殊后缀:Kbit、Mbit、Gbit、KB、MB、GB。
当您使用后缀时,请用引号将参数结束,例如“-setmax:50 MB”。
注意:如果某些测试结果大于指定限制,Log_Visualizer 将调整限制,以便所有测试结果都可见。 |
-setunits | 您可以使用以下单位之一作为“setunits”参数:
- KB - MB - GB - TB - Kbit - Mbit - GBit |
启动Log_Visualizer的命令行的几个示例:
logvisualizer -testid:1520 -logprofile:C:\HM\lv_profile.ini "-setmax:500 Gb" -setunits:MB
logvisualizer -testid:1520 -logprofile:C:\HM\lv_profile.ini -inputfile:C:\HM\Logs\log.htm
logvisualizer -testid:1520 -logprofile:C:\HM\lv_profile.ini -period:MonthByDays -outputimage:C:\HM\Images\daily_115645.gif
logvisualizer -testid:1520 -logprofile:C:\HM\lv_profile.ini -daysback:30 -outputimage:C:\HM\Images\daily_115645.gif
logvisualizer -testid:1520 -logprofile:C:\HM\lv_profile.ini -starttime:01/15/2009
批处理模式
如果您将 HostMonitor 设置为定期(每周、每月等)更改日志文件,并且您有一段时间没有使用 Log_Visualizer,则可能需要使用以下命令行以批处理模式启动应用程序:
logvisualizer.exe -batch_mode -logprofile:<profile_name> -inputfile:<log_filename> [-clear_repository]
-batch_mode | 此参数告诉应用程序分析指定的日志文件(请参阅 -inputfile 参数)并更新存储库,而不显示 GUI,也不为测试项创建 GIF 图像 |
-logprofile | profile_name - 包含应用程序设置的文件的名称。 看
设置配置文件 部分了解详细信息。 当配置文件位于当前目录时,您可以指定不带路径的文件名 (例如 -logprofile:logvisualizer.ini),
否则你应该提供文件的路径 (例如 "-logprofile:c:\program files\hostmon\lv2.ini") |
-inputfile | log_filename -HostMonitor 的日志文件(HTML、TXT 或 DBF) |
-clear_repository | 当指定此可选参数时,Log_Visualizer 在处理日志文件之前从存储库中删除所有记录 |
批处理模式允许您一一分析多个日志文件并创建最新的存储库,而无需花费时间进行手动设置。
例如,如果您使用“每月自动更改日志”选项设置 HostMonitor,HostMonitor 每年会创建 12 个文件:012007-log.htm、022007-log.htm、
032007-log.htm,...,122007-log.htm。 然后您可以创建简单的 BAT 文件来分析 2007 年的所有日志文件:
for /L %i in (1,1,9) do logvisualizer.exe -batch_mode -logprofile:logvisualizer.ini "-inputfile:c:\hostmon7\logs\0%i2007-log.htm"
for /L %i in (10,1,12) do logvisualizer.exe -batch_mode -logprofile:logvisualizer.ini "-inputfile:c:\hostmon7\logs\%i2007-log.htm"
注意:您应该按正确的顺序分析日志文件,即四月的日志文件应该在五月的日志文件之前分析。
设置配置文件
要设置配置文件,请使用以下命令行
logvisualizer.exe -setupprofile:<profile_name>
-setupprofile 参数告诉应用程序加载指定的配置文件(特殊格式的文本文件)并打开“配置文件设置”对话框窗口。
当配置文件位于当前目录时,您可以指定不带路径的文件名(例如 -setupprofile:logvisualizer.ini),
否则你应该提供文件的路径 (例如 "-setupprofile:c:\hostmon\lv2.ini").
注意#1:如果您指定不存在的文件,应用程序可能会在用户确认后创建新文件。
注意#2:HostMonitor 可能会修改 logvisualizer.ini 文件。 如果您计划将 Log_Visualizer 与您自己的脚本一起使用,我们建议您创建另一个配置文件来满足您的需求。
您可以使用“配置文件设置”对话框窗口来设置多个配置文件。
不同的配置文件可能描述不同的 ODBC 日志和各种图表设置。 这样您就可以轻松生成各种图表。
图表设置
Type
此选项允许您选择图表的类型。 有四种图表类型可用:Area series, Bar series, Line series, Point series
Size
该参数指定图表图像的宽度和高度
Display min series
Display max series
图表始终显示每个时间间隔(小时、天、周等)的平均结果(测试项目的回复)。
除了平均回复之外,Log_Visualizer 还可以显示最小值和最大值。
这两个选项允许您启用此类系列。
ODBC 日志
Log_Visualizer可以分析存储在各种数据库中的日志记录。
在使用此类日志之前,您应该使用配置文件的“ODBC logs”部分描述数据库参数。
对于每个日志,您应该指定以下参数:
Data source
从显示系统上安装的所有 ODBC 数据源列表的下拉列表中选择数据源。
注意:要安装或配置数据源,请单击 Windows 开始按钮,指向设置,然后单击控制面板。
双击管理工具,然后双击数据源(ODBC)。
Table name
提供包含日志记录的表的名称
Login/Password
提供数据库访问的登录名和密码(如果需要)
Following fields named in the log table as
该选项定义存储测试结果的表中的实际字段 (HostMonitor's ODBC 记录 可以通过不同的方式进行配置)。
|
Date / Time
提供存储有关事件日期和时间的信息的字段名称。
如果表的单个字段包含有关日期和时间的信息,请为两个选项键入相同的名称。
字段的类型可以是 Date, DateTime, TimeStamp (日期、日期时间、时间戳) 或者它可以是文本字段(不推荐).
TestID
存储测试的唯一 ID 的字段名称。 TestID 在 HML 文件中始终是唯一的。
Test name
指定存储测试名称的字段名称。
Status
提供带有状态信息的字段名称。 它可以是将状态存储为文本的文本字段,例如 “Host_is_alive”、“No_answer”等。也可以是数字字段,其中数字代表某种状态:
00- Not Tested 01- Host is Alive 02- No Answer 03- Unknown 04- Not Resolved |
05- Checking 06- Resolving 07- Ok 08- Bad 09- Disabled |
10- Bad Contents 11- WaitForMaster 12- OutOfSchedule 13- Paused 14- Warning 15- Normal |
Reply
指定存储测试回复值的字段名称。 它可以是文本或数字字段。
Test method
您可以选择(我们建议这样做)提供存储有关测试方法的信息的字段的名称。
|
Use fixed date&time format
默认情况下,Log_Visualizer 在启动时获取当前的 Windows 区域设置,并使用这些参数来处理数据/时间变量。
您可以使用此选项来定义日期和时间。 时间格式(例如 DD/MM/YYYY h:mm:ss AMPM)。
在这种情况下,Log_Visualizer 将使用指定的格式覆盖系统设置。
顺便说一句:更改日期格式不会影响 DBF 和 HTML 日志文件的分析。
无论日期和时间设置如何,Log_Visualizer 都能够正确分析这些日志文件。
但是,此选项对于分析由旧版本 HostMonitor 创建的文本日志文件或 html 日志文件非常有用。
最低系统要求
- Windows XP SP2, Windows 7, 8, 10 or Windows 11
- Windows Server 2003 SP2, Server 2008 SP2/R2, Windows Server 2012, 2016, 2019, 2022
- Internet Explorer 5.5 或更高版本(应用程序可以在没有 IE 的情况下运行,需要帮助系统)
- 2 MB 可用磁盘空间
- 最小屏幕分辨率:800 x 600
它要多少钱?
当您购买 Advanced_Host_Monitor 专业版或企业版时,您将免费获得 Log_Visualizer 的许可证。
否则 Log_Analyzer 和 Log_Visualizer 的许可证费用为 45 美元。
您可以使用信用卡、Switch 和 Solo 借记卡、支票/汇票或电汇来订购 Log_Visualizer。
细节..
|