第四十五章 使用 ^SystemPerformance 监视性能 - Abort ^SystemPerformance
Abort ^SystemPerformance
如果要停止正在运行的配置文件，可以中止数据收集，并可选择使用 $$Stop^SystemPerformance(runid) 命令删除配置文件的所有 .log 文件。例如，要中止由runid20111220_1327_12hours 标识的报告的数据收集并删除到目前为止写入的所有 .log 文件，请在终端的 %SYS 命名空间中输入以下命令：
do Stop^SystemPerformance("20111220_1327_12hours")
要在不删除日志文件的情况下停止作业并从这些日志文件生成 HTML 性能报告，请输入：
do Stop^SystemPerformance("20111220_1327_12hours",0)
有关此命令的更多信息，请参阅以编程方式运行 ^SystemPerformance 小节中的 $$Stop^SystemPerformance("runid")。
注意：必须有权停止jobs和删除文件。
以编程方式运行 ^SystemPerformance。
可以使用启动、收集、预览和停止功能的入口点以编程方式运行 ^SystemPerformance 实用程序，如下表所述：
注意：可以同时运行多个配置文件。
$$run^SystemPerformance("profile")- 启动指定的配置文件。如果成功，返回runid；如果不成功，则返回0。$$literun^SystemPerformance("profile")- 与$$run^SystemPerformance("profile")相同，只是它不包括操作系统数据。
注意：此命令适用于运行多个 IRIS 实例的服务器，其中操作系统数据将被复制。
$$Collect^SystemPerformance("runid")- 为指定的runid生成可读的 HTML 性能报告文件。如果成功，返回1和报告文件名；如果不成功，返回0后跟一个克拉和失败的原因。$$Preview^SystemPerformance("runid")- 为指定的runid生成可读的 HTML 临时（不完整）性能报告文件。如果成功，则返回1，后跟carat和文件位置。如果不成功，则返回0，后跟carat和失败的原因。
$$Stop^SystemPerformance("runid",[0]) - 停止（中止）^SystemPerformance 收集指定 runid 的数据，并默认删除实用程序生成的关联 .log 文件。要在不删除 .log 文件的情况下停止数据收集并从这些日志文件生成 HTML 性能报告，请在 runid 后面包含 0 参数。如果不成功，该函数返回 0，后跟一个 carat 和失败的原因；如果成功，它返回：1:2:3:4_1:2:3:4。 “成功”状态由下划线分隔的两部分组成：特定于操作系统和特定于 IRIS；在每个部分中，以冒号分隔的值指定：1.成功停止的作业数 2.停止失败的作业数 3.成功删除的文件数 4.未删除的文件数
$$waittime^SystemPerformance("runid")- 报告指定runid的最终HTML文件完成之前的时间。如果runid完成，则返回ready now，否则返回XX小时YY分钟ZZ秒形式的字符串。
在以下示例中，由 ^SystemPerformance 实用程序创建的 runid 以编程方式获取，然后进行测试以确定是否已生成完整报告或临时报告。
尚未创建完整报告，因为配置文件尚未完成（返回“0^not ready”），但已创建临时报告（“返回 1”）。根据这些信息，知道已经生成了一个 HTML 文件。
%SYS>set runid=$$run^SystemPerformance("30mins") %SYS>set status=$$Collect^SystemPerformance(runid) SystemPerformance run 20181004_123815_30mins is not yet ready for collection. %SYS>write status 0^not ready %SYS>set status=$$Preview^SystemPerformance(runid) %SYS>write status 1^c:\intersystems\iris\mgr\USER_IRIS_20181004_123815_30mins_P1.html %SYS>
