第四十五章 使用 ^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>