test

Sun Java Enterprise System 5 监视指南

子命令

start

启动 Monitoring Framework 节点代理及其关联的组件产品模块，而不停止 Common Agent Container。

此操作首先在 Common Agent Container 中部署节点代理，然后部署关联的组件产品模块。此工具是一种包装器，其优先级高于 cacaoadm 实用程序的 lock 和 undeploy 子命令。

start 子命令仅启动与 Monitoring Framework 关联的节点代理和 Java ES 组件模块。组件模块的前缀为 com.sun.cmm。

安全性：start 子命令只能由启动了 Common Agent Container 的用户来运行。否则，将会显示类似以下内容的错误消息：


Error occured in mfwkadm
Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1.
Stdout/Stderr: This command must be run by user: [root].
stop

停止 Common Agent Container 中的 Monitoring Framework 节点代理及其关联的 Java ES 组件模块。

此操作将首先停止 Common Agent Container 中部署的所有 Java ES 组件模块，然后停止节点代理。此工具是一种包装器，其优先级高于 cacaoadm 的 lock 和 unlock 子命令。

stop 子命令仅停止与 Monitoring Framework 关联的那些 Java ES 组件模块，然后停止节点代理本身。组件模块的前缀为 com.sun.cmm。

安全性：stop 子命令只能由启动了 Common Agent Container 的用户来运行。否则，将会显示类似以下内容的错误消息：


Error occured in mfwkadm
Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1.
Stdout/Stderr: This command must be run by user: [root].
restart

重新启动 Common Agent Container 中的 Monitoring Framework 节点代理及其关联的 Java ES 组件模块。

此操作将尝试先停止 Common Agent Container 中的节点代理及其关联模块，然后再启动它们，其方式与 stop 和 start 子命令相同。

安全性：restart 子命令只能由启动了 Common Agent Container 的用户来运行。否则，将会显示类似以下内容的错误消息：


Error occured in mfwkadm
Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1.
Stdout/Stderr: This command must be run by user: [root].
list-params

列出与 Monitoring Framework 节点代理相关的所有配置参数。

安全性：此命令不存在任何用户限制。

list-modules

显示实现通用监视模型 (Common Monitoring Model, CMM) 以及加载到 Common Agent Container 中的那些组件产品模块的列表。此子命令还将列出每个已安装的 Java ES 组件的所有正在运行的实例。每个组件都可以拥有零个、一个或多个正在运行的实例。

安全性：对于非启动 Common Agent Container 的用户，已安装的 Java ES 组件列表不包括组件实例。

info runningInstance

显示有关指定 runningInstance 的信息。runningInstance 必须与 list-modules 子命令输出中列出的正在运行的实例匹配。

显示的信息包括：

  • 对于每种监视作业，显示与正在运行的实例关联的所有可观察对象（按其类名排序）。可观察对象即可以分别使用 pm-job、opstat-job 或 thrsh-job 子命令对其创建性能监视作业、操作状态作业或阈值监视作业的对象。

  • 对于每类可观察对象，显示其所有可观察属性，包括每类对象的名称和类型。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何信息。

性能监视

pm-job observable-classes

显示可为其创建性能监视作业的对象的所有当前可观察类列表。

pm-job observable-objects [class= objectC lass] [domain=objectDomain]

显示可以创建性能监视作业的所有当前可观察对象的列表。默认情况下，将会列出所有可观察类的所有对象以及每个域中的所有对象。对象列表按其类名排序。

class=objectClass

指定可选的 objectClass 可将输出限制为该特定类的可观察对象。objectClass 必须为通过 pm-job observable-classes 子命令列出的类之一。

domain=objectDomain

指定可选的 objectDomain 可将输出限制为该域中的可观察对象。对象的域为对象的名称中冒号 (":") 字符前面的字符串。

pm-job observable-attributes class=objectClass

显示指定的 objectClass 的所有可观察属性的列表。将显示属性及其名称和类型。objectClass 必须为支持性能监视作业的类（使用 pm-job observable-classes 子命令可以列出这些类）之一。

pm-job list

显示所有当前定义的性能监视作业的列表。作业将针对具有定义的性能作业的每个对象列出，并且对象按其类名排序。显示的有关每个作业的信息与通过 pm-job info 子命令显示的信息相同。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何作业。

pm-job info jobName

显示有关名为 jobName 的性能监视作业的详细信息。jobName 必须为通过 pm-job list 子命令显示的作业。此子命令显示的信息如下：

  • 性能监视作业的名称。

  • 性能监视作业的类型（“按对象分类”或“按类分类”）。按对象分类的作业监视一个或多个指定的对象实例，而按类分类的作业监视对象类的每个实例。请注意，无法使用 mfwkadm 实用程序创建按类分类的作业。

  • 性能监视作业的状态：活动在工作 (active on-duty)、活动未工作 (active off-duty) 或已暂停(suspended)。活动在工作的作业当前已预定运行并正在收集数据。活动未工作的作业正在运行，但没有收集数据，因为当前时间不在其工作调度内。已暂停的作业没有运行，也没有收集任何数据。使用 pm-job suspend 和 pm-job resume 子命令可以更改性能监视作业的运行状态。

  • 性能监视作业的粒度（以秒为单位）。这是此作业的数据收集时间间隔。

  • 监视作业的报告周期。报告周期乘以粒度等于通知频率。例如，如果粒度周期为 10 秒，报告周期为 6，按事件报告的作业将每 10 秒收集一次数据，并且每 60 秒 (10*6) 发送一个包含 6 份报告的通知。如果该作业同时按文件报告，则还会每 60 秒发送一个包含 6 个所生成文件的位置的事件。

  • 性能监视作业是否在按事件进行报告。这意味着，性能监视作业的结果将以通知方式发送至注册的客户机。

  • 性能监视作业是否在按文件进行报告。这意味着，性能监视作业的报告将写入本地文件，并且包含文件名的通知将发送至注册的客户机。

  • 性能监视作业的报告格式，该格式始终为 XML。

  • 性能监视作业的调度。该调度指定在什么日期和时间，作业处于活动在工作状态或活动未工作状态（收集数据或不收集数据）。

对于按对象分类的作业：

  • 被观察对象的列表，按名称排序。

  • 如果仅指定了可观察属性的子集，将按名称和类型列出被观察对象的被观察属性。

对于按类分类的作业：

  • 被观察类的列表，按名称排序。

  • 如果仅指定了可观察属性的子集，将按名称和类型列出被观察类的被观察属性。这些属性为所有类公用。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何信息。

pm-job create jobName granularity= integerValue object=objectName [object= objectName ...]

在一个或多个对象上创建新的性能监视作业。mfwkadm 命令无法创建按类分类的作业。创建性能监视作业时，可以设置以下参数：

jobName

唯一标识性能监视作业的字符串。jobName 不能已被任何其他性能监视作业使用。

granularity=integerValue

当作业处于活动在工作状态时，连续两次启动测量数据收集之间的指定时间（以秒为单位）。粒度周期示例可以是 300 秒（5 分钟）、900 秒（15 分钟）、1800 秒（每半小时）或 3600 秒（每小时）。在大多数情况下，300 秒的粒度周期就足够了。对于某些测量，采用更大的粒度周期收集数据可能更有意义。

object=objectName [object= objectName ...]

性能监视作业将收集其数据并进行报告的一个或多个可观察对象。objectName 必须为通过 pm-job list 或 pm-job observable-objects 子命令显示的对象。指定多个 object= objectName 参数将会创建一个监视多个对象的性能监视作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

pm-job delete jobName

删除名为 jobName 的性能监视作业。jobName 必须为通过 pm-job list 子命令显示的作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

pm-job suspend jobName

暂停名为 jobName 的性能监视作业。无论已暂停的作业的调度如何，该作业都处于非活动状态并不再收集数据。但是，该作业将保持已定义状态，并且可以通过 pm-job resume 子命令重新激活。jobName 必须为通过 pm-job list 子命令显示的作业之一。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

pm-job resume jobName

恢复名为 jobName 的性能监视作业。恢复的作业将根据其调度开始收集数据并发送报告。jobName 必须为通过 pm-job list 子命令显示的作业之一。此子命令与 pm-job suspend 子命令对应。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

操作状态监视

opstat-job observable-classes

显示可以为其创建操作状态监视作业的对象的所有当前可观察类的列表。

opstat-job observable-objects [class= objectClass] [domain=objectDomain]

显示可以创建操作状态监视作业的所有当前可观察对象的列表。默认情况下，将会列出所有可观察类的所有对象以及每个域中的所有对象。对象列表按其类名排序。

class=objectClass

指定可选的 objectClass 可将输出限制为该特定类的可观察对象。objectClass 必须为通过 opstat-job observable-classes 子命令列出的类之一。

domain=objectDomain

指定可选的 objectDomain 可将输出限制为该域中的可观察对象。对象的域为对象的名称中冒号 (“:”) 字符前面的字符串。

opstat-job observable-attributes class= objectClass

显示指定的 objectClass 的所有可观察属性的列表。将显示属性的名称和类型。objectClass 必须为通过 opstat-job observable-classes 子命令列出的类之一。

opstat-job list

显示所有当前定义的操作状态监视作业的列表。作业将针对具有定义的操作状态作业的每个对象列出，并且对象按其类名排序。显示的有关每个作业的信息与通过 opstat-job info 子命令显示的信息相同。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何作业。

opstat-job info jobName

显示有关名为 jobName 的操作状态监视作业的详细信息。jobName 必须为通过 opstat-job list 子命令显示的作业。此子命令显示的信息如下：

  • 操作状态监视作业的名称。

  • 操作状态监视作业的类型（“按对象分类”或“按类分类”）。按对象分类的作业监视指定的对象实例，而按类分类的作业监视对象类的每个实例。请注意，无法使用 mfwkadm 实用程序创建按类分类的作业。

  • 操作状态监视作业的状态：活动在工作 (active on-duty)、活动未工作 (active off-duty) 或已暂停(suspended)。活动在工作的作业当前已预定运行并正在收集数据。活动未工作的作业正在运行，但未收集数据，因为当前时间不在其工作调度内。已暂停的作业没有运行，也没有收集任何数据。使用 opstat-job suspend 和 opstat-job resume 子命令可以更改操作状态监视作业的运行状态。

  • 操作状态监视作业的粒度（以秒为单位）。这是此作业的数据收集时间间隔。

  • 操作状态监视作业是否在按事件进行报告。这意味着，操作状态监视作业的结果将以通知方式发送至注册的客户机。

  • 操作状态监视作业是否在按文件进行报告。这意味着，操作状态监视作业的报告将写入本地文件，并且包含文件名的通知将发送至注册的客户机。

  • 操作状态监视作业的报告格式，该格式始终为 XML。

  • 操作状态监视作业的调度。该调度指定在什么日期和时间，作业处于活动在工作状态或活动未工作状态（收集数据或不收集数据）。

  • 对于按对象分类的作业，显示被观察对象的列表，按名称排序。

  • 对于按类分类的作业，显示被观察类的列表，按名称排序。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何信息。

opstat-job create jobName granularity= integerValue object=objectName [object= objectName ...]

在一个或多个对象上创建新的操作状态监视作业。mfwkadm 命令无法创建按类分类的作业。创建性能监视作业时，可以设置以下参数：

jobName

唯一标识操作状态监视作业的字符串。jobName 不能已被任何其他操作状态监视作业使用。

granularity=integerValue

当作业处于活动在工作状态时，连续两次启动测量数据收集之间的指定时间（以秒为单位）。

object=objectName [object= objectName ...]

操作状态监视作业将收集其数据并报告的一个或多个可观察对象。objectName 必须为通过 opstat-job list 或 opstat-job observable-objects 子命令显示的对象。指定多个 object= objectName 参数将会创建一个监视多个对象的操作状态作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

opstat-job delete jobName

删除名为 jobName 的操作状态监视作业。jobName 必须为通过 opstat-job list 子命令显示的作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

opstat-job suspend jobName

暂停名为 jobName 的操作状态监视作业。无论已暂停的作业的调度如何，该作业都处于非活动状态并将不再收集数据。但是，该作业将保持已定义状态，并且可以通过 opstat-job resume 子命令重新激活。jobName 必须为通过 opstat-job list 子命令显示的作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

opstat-job resume jobName

恢复名为 jobName 的操作状态监视作业。恢复的作业将根据其调度开始收集数据并发送报告。jobName 必须为通过 opstat-job list 子命令显示的作业。此子命令与 opstat-job suspend 子命令对应。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

阈值监视

thrsh-job observable-classes

显示可以为其创建阈值监视作业的对象的所有当前可观察类的列表。

thrsh-job observable-objects [class= objectClass] [domain=objectDomain]

显示可以为其创建阈值监视作业的所有当前可观察对象的列表。默认情况下，将会列出所有可观察类的所有对象以及每个域中的所有对象。对象列表按其类名排序。

class=objectClass

指定可选的 objectClass 可将输出限制为该特定类的可观察对象。objectClass 必须为通过 thrsh-job observable-classes 子命令列出的类之一。

domain=objectDomain

指定可选的 objectDomain 可将输出限制为该域中的可观察对象。对象的域为对象的名称中冒号 (“:”) 字符前面的字符串。

thrsh-job observable-attributes class=objectClass

显示指定的 objectClass 的所有可观察属性的列表。将显示属性的名称和类型。objectClass 必须为通过 thrsh-job observable-classes 子命令列出的类之一。

thrsh-job list

显示所有当前定义的阈值监视作业的列表。作业将针对具有定义的阈值作业的每个对象列出，并且对象按其类名排序。显示的有关每个作业的信息与通过 thrsh-job info 子命令显示的信息相同。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何作业。

thrsh-job info jobName

显示有关名为 jobName 的阈值监视作业的详细信息。jobName 必须为通过 thrsh-job list 子命令显示的作业。此子命令显示的信息如下：

  • 阈值监视作业的名称。

  • 阈值监视作业的多样性。在此版本中，仅允许使用监视一个对象的一种属性的简单阈值作业。

  • 阈值监视作业的状态：活动在工作 (active on-duty)、活动未工作 (active off-duty) 或已暂停(suspended)。活动在工作的作业当前已预定运行并正在收集数据。活动未工作的作业正在运行，但未收集数据，因为当前时间不在其工作调度内。已暂停的作业没有运行，也没有收集任何数据。使用 thrsh-job suspend 和 thrsh-job resume 子命令可以更改阈值监视作业的运行状态。

  • 阈值监视作业的粒度（以秒为单位）。这是此作业的数据收集时间间隔。

  • 阈值监视作业的调度。该调度指定在什么日期和时间，作业处于活动在工作状态或活动未工作状态（收集数据或不收集数据）。

  • 阈值监视作业的报警配置。此报警将在受监视的属性的被观察值超出定义的阈值时触发。显示内容包括报警的类型和严重性。

  • 阈值监视作业的被观察对象。

  • 对其应用阈值的属性名称。

  • 触发报警的阈值。

  • 在达到阈值时将触发报警的值的变化方向（RISING 或 FALLING）。

  • 阈值的容错偏移。如果方向为 RISING，则直到被观察属性的值小于 thresholdValue-offsetValue 时才会再次触发报警。如果方向为 FALLING，则直到被观察属性的值大于 thresholdValue+offsetValue 时才会再次触发报警。即使该偏移为零，此行为也适用。

安全性：对于非启动 Common Agent Container 的用户，不会显示任何信息。

thrsh-job create jobName object= objectName granularity=integerValue attributeName= attributeName attributeType=attributeType thresholdValue= thresholdValue thresholdOffset=offsetValue thresholdDirection= [RISING|FALLING]

创建监视一个对象的一种属性的新阈值监视作业。创建阈值作业时，可以设置以下参数：

jobName

唯一标识阈值监视作业的字符串。jobName 不能已被任何其他阈值监视作业使用。

object=objectName

阈值监视作业将收集其属性值以便与阈值进行比较的可观察对象。objectName 必须为通过 thrsh-job list 或 thrsh-job observable-objects 子命令显示的对象。

granularity=integerValue

当作业处于活动在工作状态时，连续两次启动属性值观察之间的指定时间（以秒为单位）。

attributeName=attributeName

阈值监视作业将收集其值并与阈值进行比较的属性的名称。attributeName 必须通过 thrsh-job info 或 thrsh-job observable-attributes 子命令列出。

attributeType=attributeType

要监视的可观察属性的类型。attributeType 必须通过 thrsh-job info 或 thrsh-job observable-attributes 子命令列出。

thresholdValue=thresholdValue

导致此阈值作业在按 thresholdDirection 指定的方向超出时触发报警的受监视属性的值。

thresholdOffset=offsetValue

offsetValue 确定在触发连续的报警时阈值作业的容错。offsetValue 必须为零或正值。触发某个报警事件后，直到受监视的属性的值超出 offsetValue 和 thresholdDirection 定义的范围时才会触发新的报警事件。

thresholdDirection=[RISING|FALLING]

如果方向为 RISING，则直到被观察属性的值小于 thresholdValue-offsetValue 时才会再次触发报警事件。如果方向为 FALLING，则直到被观察属性的值大于 thresholdValue+offsetValue 时才会再次触发报警事件。即使 offsetValue 为零，此行为也适用。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

thrsh-job delete jobName

删除名为 jobName 的阈值监视作业。jobName 必须为通过 thrsh-job list 子命令显示的作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

thrsh-job suspend jobName

暂停名为 jobName 的阈值监视作业。无论已暂停的作业的调度如何，该作业都处于非活动状态并将不再收集数据。但是，该作业将保持已定义状态，并且可以通过 thrsh-job resume 子命令重新激活。jobName 必须为通过 thrsh-job list 子命令显示的作业。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。

thrsh-job resume jobName

恢复名为 jobName 的阈值监视作业。恢复的作业将根据其调度开始收集数据并发送报告。jobName 必须为通过 thrsh-job list 子命令显示的作业。此子命令与 thrsh-job suspend 子命令对应。

安全性：此子命令只能由启动了 Common Agent Container 的用户来运行。