第五十四章 使用 ^mgstat 监控性能
本章介绍 ^mgstat 实用程序，它是一种用于收集基本性能数据的工具。
注意：此实用程序可能会在不同版本之间更新。 ftp://ftp.intersys.com/pub/performance/下载 newmgstat.xml 的信息。
必须从 %SYS 命名空间调用 ^mgstat，并且可以使用以下位置参数：
| Argument | Description |
|---|---|
| sample time | 此参数指定采样计数器的频率（以秒为单位）。如果未指定，默认值为 2 秒。注：如果指定的采样时间大于 10 秒，^mgstat 会将其减少到 10 秒。请参阅此表中的样本参数数量。 |
| number of samples | 此参数指定要获取的最大样本数。如果未指定，则默认为 10 次迭代。 注：如果 ^mgstat 减少了采样时间，它会增加指定的样本数以确保运行的持续时间（采样时间 * 样本数）实际上与没有修改任何参数时的持续时间相同。 |
| filename | 此参数指定 ^mgstat 生成的 .mgst 文件的文件名，相对于 install-dir\mgr。如果未指定，则默认文件名为 ServerName_InstanceName_Date_Time.mgst。 |
| page length | 如果以交互方式运行 ^mgstat，此参数指定在重复标题行之前要显示的行数。默认为0，即在页面开头显示一次页眉；如果指定的值少于 5 行（0 除外），^mgstat 会将其增加到 5。注：当将 ^mgstat 作为后台作业运行时，将忽略此参数。 |
例如，如果将 ^mgstat 作为后台作业运行，要指定每 5 秒获取一次文件样本，直到获得 17280 个样本（在终端中，从 %SYS 命名空间），请输入以下内容：
%SYS>JOB ^mgstat(5,17280)
或者，如果以交互方式运行 ^mgstat，要指定相同的采样在每 10 行数据后重新显示标题，请输入以下内容：
%SYS>DO ^mgstat(5,17280,,10)
默认情况下，^mgstat 会根据服务器名称、配置名称以及日期和时间生成一个文件名，并带有“mgst”扩展名，该扩展名可由用 Microsoft Excel 编写的有助于数据图形化的分析工具识别。默认情况下，该文件位于 IRIS® 数据平台实例的 install-dir\mgr 目录中；但是，如果通过 ^SystemPerformance 实用程序更改了输出目录，^mgstat 将使用该输出目录。
注意：运行 ^SystemPerformance 实用程序时也会生成 mgst 文件，并包含在 HTML 性能报告中。
为确保对系统性能的影响最小，^mgstat 实用程序从共享内存中提取各种计数器信息。如果该实用程序正在运行并且出现明显的性能问题，则可以使用数据来帮助调查问题；如需分析方面的帮助，请联系 全球响应中心 (WRC)，可以提供自动运行 ^mgstat 和清除文件的任务。
除下表中注明的数据外，大多数报告数据均以每秒值计算平均值。生成的输出文件采用可读的逗号分隔值 (CSV) 格式，更易于使用 Microsoft Excel 等电子表格工具进行解读。文件的第一行是标题行，其中包括文件名和实用程序版本，以及有关缓冲区分配和被监视产品版本的信息。数据的列数取决于产品的版本：前两列是日期和时间；其余列是：