Sun Java Enterprise System 5 监视指南

阈值监视

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 suspendthrsh-job resume 子命令可以更改阈值监视作业的运行状态。

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

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

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

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

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

  • 触发报警的阈值。

  • 在达到阈值时将触发报警的值的变化方向(RISINGFALLING)。

  • 阈值的容错偏移。如果方向为 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 listthrsh-job observable-objects 子命令显示的对象。

granularity=integerValue

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

attributeName=attributeName

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

attributeType=attributeType

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

thresholdValue=thresholdValue

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

thresholdOffset=offsetValue

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

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 的用户来运行。