第五十六章 历史监视器

History Monitor 维护性能和系统使用指标的历史数据库。其主要目的是：

• 提供性能基准并帮助分析性能问题。
• 帮助分析一段时间内的系统使用情况以进行容量规划。

该数据库在 SYS.History 类包中定义并保存在 %SYS 命名空间中。数据库结构的所有细节都在那里发布，并且可以通过 SQL 或正常的持久对象访问访问数据。 SYS.History 中的类文档还包含对所有可用的单个属性、方法和查询的描述。

数据通常分为性能（请参阅 SYS.History.Performance）和系统使用情况（请参阅 SYS.History.SystemUsage）数据。性能指标旨在以较短的时间间隔（默认情况下为 30 秒）进行采样，系统使用数据以较长的时间间隔（默认情况下为 5 分钟）进行采样。在每天开始时，将各个时间间隔样本作为平均值、最大值、最小值、标准偏差、中值和总计汇总到每小时和每天的表格中。可以选择为每个度量类保留哪些汇总函数（如果有）。间隔和每小时数据可能会在定义的天数（默认分别为七 (7) 天和 60 天）后自动清除；每日摘要用于长期分析，可以手动清除。

基本指标

所有收集的指标都在 SYS.History 的四个 %SerialObject 类中定义。

第五十五章 使用 ^mgstat 监控性能 - Seizes、ASeizes 和 NSeizes

第五十四章 使用 ^mgstat 监控性能

本章介绍 ^mgstat 实用程序，它是一种用于收集基本性能数据的工具。

注意：此实用程序可能会在不同版本之间更新。 ftp://ftp.intersys.com/pub/performance/下载 newmgstat.xml 的信息。

必须从 %SYS 命名空间调用 ^mgstat，并且可以使用以下位置参数：

第五十三章 使用 ^SystemPerformance 监视性能 - InterSystems IRIS Linux 平台性能数据报告

• %SS - 使用 ALL^%SS 命令在运行过程中采集了四个样本。

• Configuration * - 来自服务器的 IRIS 实例名称和主机名、完整的 IRIS 版本字符串、许可客户名称和许可订单号。

• cpf file * - 当前活动配置文件的副本。

• irisstat -c - 使用命令 irisstat cache -p-1 -c-1 -e1 -m8 -n2 -N127 在运行过程中以均匀的间隔采集四个样本。以下是对每个参数的简要说明：

  • -p-1: 对进程表进行采样以包括进程和全局状态信息。
  • -c-1: 对共享内存的计数器部分进行采样以显示日志、锁、磁盘和资源使用统计信息。
  • -e1: SYSLOG 错误表。
  • -m8: 文件表，其中包括所有 IRIS.DAT 文件及其属性。
  • -n2: 网络结构表，包括本地到远程数据库的映射。
  • -N127: 客户端和服务器连接的 ECP 统计信息。

• irisstat -D - 使用命令 irisstat cache --f1 -D10,100 在运行过程中以均匀的间隔采集八个样本。以下是对每个参数的简要说明：

  • -fl: 基本标志。

第五十二章 使用 ^SystemPerformance 监视性能 - IBM AIX® 平台的 InterSystems IRIS 性能数据报告

• %SS - 使用 ALL^%SS 命令在运行过程中采集了四个样本。

• AIX info * - oslevel 的输出。 uname -a、prtconf 和 lspv 命令

• Configuration * - 来自服务器的 IRIS 实例名称和主机名、完整的 IRIS 版本字符串、许可客户名称和许可订单号。

• cpf file * - 当前活动配置文件的副本。

• cpu type * - 有关安装的处理器以及是否启用 SMT 的信息； lsattr -El proc0 的输出。

• irisstat -c - 使用命令 irisstat cache -p-1 -c-1 -e1 -m8 -n2 -N127 在运行过程中以均匀的间隔采集四个样本。以下是对每个参数的简要说明：

  • -p-1: 对进程表进行采样以包括进程和全局状态信息。
  • -c-1: 对共享内存的计数器部分进行采样以显示日志、锁、磁盘和资源使用统计信息。
  • -e1: SYSLOG 错误表。
  • -m8: 文件表，其中包括所有 IRIS.DAT 文件及其属性。
  • -n2: 网络结构表，包括本地到远程数据库的映射。
  • -N127: 客户端和服务器连接的 ECP 统计信息。

在上一篇文章中，我们看到了最常用的HL7消息类型之一--ADT（入院、出院、转院）的结构，以及ADT^A04的例子和它所有字段的描述。现在让我们来看看另一个数据流，它与测试订单的订购和履行有关。我说的是ORM（从2.5版本开始，你应该使用特定的消息来订购测试，如OMG、OML、OMD、OMS、OMN、OMI和OMP），ORL和ORU消息。在一个非常简化的情况下，数据的交换可能看起来像这样。

让我们更详细地看一下这些消息。

第五十章 使用 ^SystemPerformance 监视性能 - Microsoft Windows 平台的 InterSystems IRIS 性能数据报告

Microsoft Windows 平台的 IRIS 性能数据报告

• %SS - 使用 ALL^%SS 命令在运行过程中采集了四个样本。

• Configuration * - 来自服务器的 IRIS 实例名称和主机名、完整的 IRIS 版本字符串、许可客户名称和许可订单号。

• cpf file * - 当前活动配置文件的副本。

• irisstat -c - 使用命令 .\bin\irisstat -s -p-1 -c-1 -e1 -m8 -n2 -N127 在运行过程中以均匀间隔采集四个样本。以下是对每个参数的简要说明：

  • -p-1: 对进程表进行采样以包括进程和全局状态信息。
  • -c-1: 对共享内存的计数器部分进行采样以显示日志、锁、磁盘和资源使用统计信息。
  • -e1: SYSLOG 错误表。
  • -m8: 文件表，其中包括所有 IRIS.DAT 文件及其属性。
  • -n2: 网络结构表，包括本地到远程数据库的映射。
  • -N127: 客户端和服务器连接的 ECP 统计信息。

• irisstat -D - 使用命令 irisstat cache --f1 -D10,100 在运行过程中以均匀的间隔采集八个样本。

第四十九章 使用 ^SystemPerformance 监视性能 - 复制配置文件

复制配置文件

可以使用以下 API 命令将现有配置文件复制到具有不同名称的文件：

set rc=$$copyprofile^SystemPerformance("sourceprofilename","targetprofilename")

必须指定：

• sourceprofilename - 现有配置文件的名称
• targetprofilename - 要创建的配置文件的名称。这必须用双引号引起来。

如果成功，该函数返回 1。如果不成功，它返回一个 0 后跟一个 carat 和任何错误的原因。

其中 sourceprofilename 是现有配置文件的名称，targetprofilename 必须是唯一的并且不能包含空格或空白字符。

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

我很高兴地宣布 ObjectScript 包管理器 ZPM 的生命周期中的一个里程碑。包管理器使开发人员能够以一种方便的方式巧妙地打包 ObjectScript 代码和部署配置设置以及版本信息。在过去的几年里，它已经发展成为许多开发工作流程中不可或缺的一部分。

事实证明，InterSystems 决定使用它来打包我们自己的组件非常重要，这促使我们决定将 GitHub 存储库从社区移至我们的公司存储库，并将其重命名为InterSystems Package Manager (IPM) 。 IPM 仍将是开源的。社区成员将能够审查代码并提交拉取请求。但这种变化使我们能够以非员工能够直接对代码库进行更改的方式确保软件的安全性。更高级别的安全性和信任对于可以将代码与您的数据一起安装的软件来说至关重要。

所以请和我一起庆祝 ZPM 的生命，欢迎 IPM 的诞生，并感谢贡献者——尤其是 Nikolay Soloviev 和@Dmitry Maslennikov，他们再次展示了对开发人员需求的惊人洞察力，以及技能和奉献精神构建出色的软件！

---

https://github.com/intersystems/ipm

第四十一章 使用^%SYS.MONLBL检查例程性能 - 逐行监控报告示例

本节包含 ^%SYS.MONLBL 例程生成的各种报告的示例：

Line-by-line Detail Report

Line-by-line Summary Report

Line-by-line Delimited Output Report

Line-by-line Procedure Level Report

Line-by-line Detail Report

以下是报告所选期刊实用程序的最小指标详细信息的示例，包括覆盖率分析。报告被发送到 monlbl_JRN_dtl.txt 文件，其中显示了一部分。

Line-by-Line Monitor
 
1.) Stop Monitor
2.) Pause Monitor
3.) Clear Counters
4.) Report - Detail
5.) Report - Summary
6.) Report - Delimited (CSV) Output
7.) Report - Procedure Level
 
Enter the number of your choice: 4
Include Coverage Analysis summary (Y/N)?

我们刚刚发布了包管理器的一个小更新，如我们11 月宣布，我们已经将 ZPM 重命名为 IPM。现在这个是一个错误修复版本，正确解释 ROBOCOPY 返回代码并修复阻止安装某些包的回归。

在这里获取：

https://github.com/intersystems/ipm/releases/tag/v0.5.2

是否存在返回Global行数量的命令？

例如：

^test(1)="aa"
^test(2)="aa"
^test(3)="aa"
^test(4)="aa"
总行数 = 4

第三十八章 使用^%SYS.MONLBL检查例程性能

例程^%SYS.MONLBL为监视器工具提供用户界面。该实用程序提供了一种方法来诊断在例程中执行选定代码所花费的时间，从而帮助识别特别耗费资源的代码行。它是现有监视器实用程序的扩展，可通过^PerfMon和%Monitor系统程序包类访问。由于这些实用程序共享相同的内存分配，因此一次只能在IRIS实例上运行其中一个实用程序。

调用逐行监视例程

如果在调用^%SYS.MONLBL时监视器没有运行，则例程会显示一条警告消息，并提供启动监视器或检查内存要求的选项。例如：

%SYS>Do ^%SYS.MONLBL
  
  
WARNING ! Starting the line-by-line monitor will enable the
  collection of statistics for *every* line of code executed by
  the selected routines and processes. This can have a significant
  impact on the performance of a system, and it is recommended
  that you do this on a 'test' system.

请问下，项目上数据库用的是cache2010 ，有些文件是部署的，现在想要备份，在cache2016里面可以导出obj为xml，但是cache2010 导出的时候会报错，ERROR #6080: Can not export 'OBJ' type in %RO format for item “xxxxx” 要报错 。

第三十七章 使用 ^PROFILE 监控例程性能 - Using ^PROFILE

• 当显示子例程标签列表（以及每个标签的指标）时，可以指定以下任何一项

当显示代码行时，系统会提示指定下一步要执行的操作。的选择包括：

^PROFILE 示例

以下是在终端中以交互方式运行^配置文件实用程序(从%sys命名空间)的示例：

1. 输入以下命令：

do ^PROFILE

2. 此时将显示以下消息。

第三十六章 使用 ^PROFILE 监控例程性能 - Using ^PROFILE

^PROFILE 实用程序可帮助程序员分析其应用程序例程和类的性能。它分两个阶段完成此任务：

1. 它收集数据，按例程级别分类，以帮助您确定哪些例程最“有效”。
2. 它允许选择要收集的例程并在行级别详细显示数据（子例程、过程和单独的行），以便可以“向下钻取”到可能导致性能问题的各个例程。

默认情况下，^PROFILE 捕获最多 5000 个例程的指标；如果没有足够的共享内存可用于最大数量的例程，该实用程序会显示一条消息，说明监视此集合所需的内存页数和可用页数。然后，该实用程序会捕获尽可能多的例程的指标。

Using ^PROFILE

从 %SYS 命名空间调用 (^PROFILE) 实用程序：

%SYS>do ^PROFILE

当系统提示开始收集数据时，按 Enter。

注意：当系统提示回答（是或否除外）时，可以输入？显示联机帮助。

默认情况下，配置文件显示具有以下指标的例程编号列表；最初，列表按 RtnLine 指标排序：

国务院于2022年12月19日发布了《中共中央 国务院关于构建数据基础制度更好发挥数据要素作用的意见》（后简称《数据二十条》），如何有效利用数据已经成为下一步的趋势。另一方面，无论是基于数据中台还是数据编织理念，两者也都对如何利用数据提出了构想。因此医疗行业数字化建设的目标已不能再局限于如何收集数据，建立医疗行业数据的流通机制将会是为越来越普遍的需求。

时钟拨回几年前，数据中台概念开始火爆。人们对数据中台的定义、诠释尽管有诸多差异，通过数据中台降低数据共享和利用的成本则是共同的期望。但经过这几年的探索之后，中台已死的观点也在涌现。究其原因，除去中台概念在技术上的不确定，数据流通过程中的责权益的不清晰也是严重的制约因素。毕竟，数据中台自身作为一套技术框架并不能代替法律法规与市场自动将数据转变为商品从而创造出流通价值。

那么，如何能够使数据的流通合规合法，使数据能够如货币和商品一般自由流动，则是我们需要思考和探索的主题，这次《数据二十条》的出现，无疑为医疗信息技术工作者提供了一个明确的思考方向。

Journaling is NOT on. Updates will NOT be journaled
*** Missing previous 1 files that may contain TSTARTs

ERROR: <ZFILE>ScanForOpenTrans+42^JRNRESTB

There is a problem with searching for open transactions in older files.
If you decide to continue, transactions started in files earlier than
the first one to be restored might remain open after the restore.

Do you want to abort? Yes => No

请问什么情况下会触发出现Do you want to abort?

在门户网站查看数据库Global Journal也是勾选上的.

日常工作中，JSON使用越来越多，很多其他的语言里面有成熟的JSON API,但cache 我一直没找到。而同事们使用的基本都是自己写的一些JSON工具。这些小工具，多多少少有些局限。使用ensemble2016后，发现了 Ens.Util.JSON类，他可以处理JSON。翻阅代码后，实际上主要API是 %ZEN.Auxiliary.abstractController。在使用中，我们遇到一个问题，那就是有些JSON的节点名是带有下划线的，这个不太好处理。一般来说，我们把对象转为xml的时候，对象的属性我们是去掉下划线的，带下划线的名字是用 XMLNAME来设置的，于是考虑JSON里面也使用它（如果配置了）作为对象转JSON的时候，JSON的名字。修改 %ZEN.Auxiliary.jsonProvider的 %WriteJSONStreamFromObject方法后，发现ensemble的一些自带的页面的功能受到了影响。因此重新建立了一个副本。这里假定为 Util.JSON Extends %ZEN.Auxiliary.abstractController [ System = 3 ]。

第二十六章 使用系统监视器 - 使用 ^%SYSMONMGR 管理应用程序监视器

如使用 ^%SYSMONMGR 实用程序中所述，^%SYSMONMGR 实用程序允许管理和配置系统监视器，包括应用程序监视器。该实用程序可以在任何名称空间中执行，使用它所做的更改只会影响启动它的名称空间。必须通过在该命名空间中启动 ^%SYSMONMGR 来为配置的每个启动命名空间维护单独的应用程序监视器配置。

注意：在对应用程序监视器配置进行任何更改（例如激活类）之后，必须在进行更改的名称空间中重新启动系统监视器以使更改生效。

要管理应用程序监视器，请在终端中输入以下命令：

%SYS>do ^%SYSMONMGR

然后为管理应用程序监视器输入 5。显示以下菜单：

1) Set Sample Interval
2) Manage Monitor Classes
3) Change Default Notification Method
4) Manage Email Options
5) Manage Alerts
6) Debug Monitor Classes
7) Exit
 
Option?

输入选择的数字或按 Enter 退出 Application Monitor实用程序。

第二十五章 使用系统监视器 - 配置健康监视器类

此子菜单中的选项可让自定义 Health Monitor，如下表所述。

注意：不能在系统监视器运行时使用这些选项来自定义健康监视器；必须先停止系统监视器，然后在进行更改后重新启动它。

第二十四章 使用系统监视器 - 使用 ^%SYSMONMGR 管理运行状况监视器

如使用 ^%SYSMONMGR 实用程序中所述，^%SYSMONMGR 实用程序允许管理和配置系统监视器，包括运行状况监视器。要管理 Health Monitor，请在终端中切换到 %SYS 命名空间，然后输入以下命令：

%SYS>do ^%SYSMONMGR

1) Start/Stop System Monitor
2) Set System Monitor Options
3) Configure System Monitor Classes
4) View System Monitor State
5) Manage Application Monitor
6) Manage Health Monitor
7) View System Data
8) Exit 

Option? 

注意：Health Monitor 仅在 %SYS 命名空间中运行。当在另一个命名空间中启动 ^%SYSMONMGR 时，选项 6（管理健康监视器）不会出现。

为管理运行状况监视器输入 6。

第二十三章 使用系统监视器 - 通知规则

通知规则

如果一段时间内传感器的三个连续读数大于传感器最大阈值，Health Monitor 将生成警报（严重性 2 的通知），如果一段时间内传感器的五个连续读数大于传感器最大阈值，则健康监视器将生成警告（严重性 1 的通知）大于传感器警告阈值。最大值和警告阈值取决于传感器对象中的设置以及适用的图表是由 Health Monitor 生成还是由用户创建，如下表所示。

另请注意：

• 当传感器对象设置了最大值和警告值时，不需要图表，因此不会生成图表，即使禁用 Health Monitor 也会生成通知。
• 当传感器对象设置了最大乘数和警告乘数，或者只有基数时，需要图表；在分析模式下收集到足够的样本以生成图表之前，不会生成任何通知。
• 当存在用户创建的图表时，传感器对象设置是什么并不重要。

第二十二章 使用系统监视器 - 周期

Periods

默认情况下，每周有 63 个重复周期对传感器进行采样。这些期间中的每一个都代表一周中特定日期的以下指定间隔之一：

默认健康监控周期

可以使用 ^%SYSMONMGR 实用程序中的配置周期选项列出、添加和删除周期（请参阅下面的配置健康监视器类部分）。您可以添加每月、每季度或每年的期间以及每周的期间。

注意：季度期间以三个月为增量列出，从指定为开始月份的月份开始；例如，如果指定 5（五月）作为起始月份，则季度循环将在八月 (8)、十一月 (11) 和二月 (2) 重复。

对于用户定义的期间，描述是可选的。

Charts

如果传感器对象的通知阈值未作为乘数给出（或未指定），则 Health Monitor 需要图表来评估这些传感器读数。

第二十一章 使用系统监视器 - 传感器和传感器对象

传感器和传感器对象

Health Monitor 传感器对象表示 SYS.Monitor.SystemSensors 中的传感器之一。每个传感器对象必须提供一个基值，并且可以选择提供一个最大（警报）阈值和一个警告阈值（绝对值或乘数）。 Health Monitor 传感器对象及其默认参数显示在下表中。

一些传感器代表IRIS 实例的总体指标。这些传感器在下表中没有在“传感器项目”列中列出的值。例如，LicensePercentUsed 传感器采样当前正在使用的实例授权许可单位的百分比，而 JournalGrowthRate 传感器采样写入实例日志文件的数据量（以每分钟 KB 为单位）。

其他传感器收集有关特定传感器项（CSP 服务器、数据库或镜像）的信息。例如，DBReads 传感器对每个已安装数据库的每分钟读取次数进行采样。这些传感器指定为 ；例如，DBLatency install-dir\IRIS\mgr\user 传感器对完成对 USER 数据库的随机读取所需的时间（以毫秒为单位）进行采样。

可以使用 ^%SYSMONMGR 实用程序列出和编辑（但不能删除）传感器对象（如下面的“配置健康监视器类”部分所述）。编辑传感器对象允许修改它的一个或所有值。

第二十章 使用系统监视器 - 定义系统监视器组件

SYS.Monitor API 允许定义自己的传感器、订阅者和通知器类。

Sensor Classes

传感器类扩展 %SYS.Monitor.AbstractSensor。 System Monitor 控制器最初调用每个传感器类的 Start() 方法；此后，在每个周期，它都会调用 GetSensors() 方法。 SetSensor() 方法在传感器类中用于设置 SensorReading 属性中的传感器名称/值对，该属性由 GetSensors() 返回并传递给所有订阅者类。

传感器类还可以评估传感器读数，并根据评估结果调用类的 %SYS.Monitor.Email 以根据通知或任何用户定义的警报方法生成电子邮件消息。

Subscriber Classes

订阅者类扩展 %SYS.Monitor.AbstractSubscriber。 System Monitor 控制器最初调用每个订阅者类的 Start() 方法；此后，在每个循环中，它会为循环中调用的每个传感器类调用一次 Receive() 方法，并将从该传感器类接收到的传感器名称/值对传递给 SensorReading 属性。订户类可以评估一个或多个名称/值对，并使用 Notify() 方法设置通知，该方法填充 Notifications 属性。

第十九章 使用系统监视器 - 配置系统监视器命名空间

配置系统监视器命名空间

当一个实例启动时，系统监视器会在每个已配置的启动命名空间中作为一个单独的进程自动启动（默认情况下仅限 %SYS）。所有系统监视器配置和设置都是特定于命名空间的。当使用 ^%SYSMONMGR 进行更改时，更改仅影响启动该实用程序的命名空间。

注意：^%SYSMONMGR 的所有实例都将消息写入同一系统监视器日志。可以从任何命名空间配置启动命名空间。

当在主菜单中输入 3 时，将显示以下菜单：

1) Configure Components
2) Configure Startup Namespaces
3) Exit

输入 2 以显示配置命名空间的选项：

1) List Startup Namespaces
2) Add Namespace
3) Delete Namespace
4) Exit

输入 1 以列出当前配置的启动命名空间。

输入 2 添加启动命名空间。

输入 3 以删除启动命名空间。 （不能删除 %SYS。

第十八章 使用系统监视器 - 设置系统监视器选项

设置系统监视器选项

要更改全局系统监视器设置或将它们恢复为默认值，请停止系统监视器（如果它正在运行），然后在主菜单中输入 2：

1) Set Sample Interval
2) Set Debugging Level
3) Reset Defaults
4) Manage Debug Data
5) Exit

输入 1 设置系统监视器调用每个配置的传感器类的时间间隔；默认值为 30 秒。

输入 2 设置调试级别。默认值为 0（基本），它将系统监视器和运行状况监视器状态和错误消息写入系统监视器日志，并且不保存传感器读数。调试级别 1（记录所有传感器）将传感器读数与消息一起写入系统监视器日志并保存传感器读数，然后可以使用“查看系统数据”菜单的“查看传感器数据”选项查看这些读数。

输入 3 将采样间隔、调试级别和传感器读数的保存重置为其默认值。

输入 4 以设置保存传感器读数的天数；默认值为 5。

更改将在下次启动或重新启动系统监视器时生效。

配置系统监视器组件

如系统监视器中所述，可以通过扩展 %SYS.Monitor.AbstractSensor、%SYS.Monitor.AbstractSubscriber和 %SYS.Monitor.

第十七章 使用系统监视器 - 使用 ^%SYSMONMGR 实用程序

^%SYSMONMGR 实用程序可让管理和配置系统监视器。该实用程序可以在任何名称空间中执行，使用它所做的更改只会影响启动它的名称空间。必须通过在该命名空间中执行 ^%SYSMONMGR 来为配置的每个启动命名空间维护单独的系统监视器配置。在对命名空间的系统监视器配置进行任何更改后，必须在命名空间中重新启动系统监视器才能使更改生效。

重要提示：本节中描述的使用 ^%SYSMONMGR 实用程序的所有手动操作都可以使用 %Monitor.Manager API 中的方法以编程方式执行。

要管理系统监视器，请在终端中输入以下命令：

%SYS>do ^%SYSMONMGR

出现主菜单

%SYS>do ^%SYSMONMGR
 
 
1) Start/Stop System Monitor
2) Set System Monitor Options
3) Configure System Monitor Classes
4) View System Monitor State
5) Manage Application Monitor
6) Manage Health Monitor
7) View System Data
8) Exit

Option?

输入选择的数字或按 Enter 退出该实用程序。