/usr/cluster/bin/cltelemetryattribute -V
/usr/cluster/bin/cltelemetryattribute [subcommand] -?
/usr/cluster/bin/cltelemetryattribute subcommand [options] -v [telemetry-attribute …]
/usr/cluster/bin/cltelemetryattribute disable [-i {- | clconfigfile}] [-t object-type] {+ | telemetry-attribute ...}
/usr/cluster/bin/cltelemetryattribute enable [-i {- | clconfigfile}] [-t object-type] {+ | telemetry-attribute ...}
/usr/cluster/bin/cltelemetryattribute export [-o {- | clconfigfile}] [-t object-type[,…]] [+ | telemetry-attribute ...]
/usr/cluster/bin/cltelemetryattribute list [-t object-type[,…]] [+ | telemetry-attribute ...]
/usr/cluster/bin/cltelemetryattribute print [-b object-instance[,…]] [-a] [-d period] [-u] [-n node[,…]] [-t object-type[,…]] [+ | telemetry-attribute ...]
/usr/cluster/bin/cltelemetryattribute set-threshold -b object-instance [-n node] {-p name=value} [-p name=value] […] -t object-type telemetry-attribute
/usr/cluster/bin/cltelemetryattribute show [-b object-instance[,…]] [-n node[,…]] [-t object-type[,…]] [+ | telemetry-attribute ...]
/usr/cluster/bin/cltelemetryattribute status -b object-instance [-n node] {-p name} -t object-type [+ | telemetry-attribute ...]
此命令配置系统资源的监视。
您可以针对不同类型的对象监视系统资源的使用情况,其中包括以下对象:
磁盘
文件系统
IP 地址
网络接口
节点
Solaris 区域
资源组
您可以监视的系统资源的方面称为遥测属性。
该命令执行以下操作:
启用或禁用遥测属性
设置或修改遥测属性的阈值
显示一个列表,其中包括被监视的属性、应用的阈值以及收集的有关对象的数据
通过标识对应的遥测属性,选择您要监视的系统资源使用情况的方面。要针对某个对象监视系统资源使用情况,请对该类型的对象启用相应的遥测属性。Oracle Solaris Cluster 软件在群集中针对该类型的所有对象收集这些属性的使用情况数据。
对于系统资源,某个特定值可能对群集的性能很关键。可以设置遥测属性的阈值,以便在超过临界值时可以通知您。有关阈值的信息,请参见 set-threshold 子命令和 –p 选项的描述。
仅当 options 是 –? 选项或 –V 选项时,才可以省略 subcommand。
每个选项都有长和短两种格式。在 选项 中给出每个选项的两种格式以及该选项的描述。
clta 命令是 cltelemetryattribute 命令的简短格式。
在完善系统资源监视的配置之前,必须对监视进行初始化。请参见 sctelemetry(1M) 手册页。
仅可以在全局区域中使用此命令。
支持以下子命令:
对指定的对象类型禁用指定的遥测属性。
仅可以在全局区域中运行该子命令。
Oracle Solaris Cluster 软件收集设置为 enabled 状态的系统资源的使用情况数据。如果将某个对象类型的系统资源设置为 disabled 状态,Oracle Solaris Cluster 软件不会收集与该对象实例对应的任何实例的数据。
满足以下两个条件时,cltelemetryattribute 命令也会禁用这些属性的数据收集:
使用 –i 选项指定配置文件。
在输入文件中将遥测属性设置为 disabled。
通过使用 export 子命令创建配置文件。
将遥测属性设置为 disabled 时,其已配置的阈值设置保持不变。
超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。
对指定的对象类型启用指定遥测属性的数据收集。
仅可以在全局区域中运行该子命令。
默认情况下,为选定的对象类型启用选定的属性。
要启用遥测属性的数据收集,请将遥测属性设置为 enabled。
Oracle Solaris Cluster 软件只收集已为其启用遥测属性的对象类型的数据。启用对象类型的属性时,Oracle Solaris Cluster 软件会针对所有节点上该类型的所有对象实例收集该属性的数据。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
将对象类型和对象实例的遥测属性配置导出到一个文件或标准输出 (stdout) 中。
仅可以在全局区域中运行该子命令。
配置包括属性对于某个对象类型是处于启用还是禁用状态。配置还可能包括为阈值配置设置的限制。
通过使用 –o 选项指定一个文件,以将配置信息写入文件。如果不指定 –o 选项,cltelemetryattribute 命令会将配置信息写入标准输出 (stdout)。
export 子命令不会修改群集配置数据。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示可以为指定的对象类型配置的遥测属性。
仅可以在全局区域中运行该子命令。
如果指定详细选项 –v,则 list 子命令显示可将属性应用到的对象类型。
阈值属性的显示格式如下:
Threshold: severity, direction , value, rearm
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示对指定对象实例或对象类型启用的指定遥测属性的系统资源使用情况。
仅可以在全局区域中运行该子命令。
输出包含以下数据:
日期和时间戳
对象实例
对象类型
遥测属性
节点
值
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
针对节点上的指定对象修改指定遥测属性的阈值设置。
仅可以在全局区域中运行该子命令。
使用 –p 选项指定要修改的阈值。也可以使用 –p 选项指定要修改的阈值属性。只能修改 value 和 rearm 阈值属性。
必须为指定的阈值更改这些属性中的至少一个。如果至少配置了一个属性,则运行 status 子命令时将显示输出。
要取消激活阈值,请将 value 和 rearm 指定为空白,如下所示:
-y value=,rearm=
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示为对象类型或对象实例上的遥测特性配置的属性。
仅可以在全局区域中运行该子命令。
这些属性包括是否为对象类型启用系统资源。如果指定详细选项 –v,则 show 子命令会显示为对象实例启用的遥测属性的阈值设置。
阈值属性的显示格式如下:
Threshold: severity, direction , value, rearm
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示在标准输出上配置了阈值的对象类型的当前状态。如果没有至少设置一个属性,则运行 status 子命令时不会显示输出。
仅可以在全局区域中运行该子命令。
在不带参数的情况下使用此子命令可显示当前具有警告或致命严重级别的所有活动阈值状态。可能的阈值输出包括阈值的当前严重级别。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
支持以下选项:
显示帮助信息。
指定此选项时,subcommand 可有可无。
如果没有随该选项指定 subcommand,将会显示所有可用子命令的列表。
如果随该选项指定了 subcommand,将会显示 subcommand 的用法。
如果随该选项指定了 set-threshold 子命令,将会显示所有资源组属性的帮助信息。
如果是与其他选项、子命令或操作数一起指定该选项,将忽略所有这些内容。不会发生任何其他处理。
输出三小时期间内收集的数据的平均值,以及与该平均值关联的标准偏差。
如果一起指定 –a 选项和 –d 选项,则显示在指定 period 中三小时间隔内的平均数据。
如果未指定 –a 选项,则输出的数据为最新数据。
指定要显示其信息,或要为其设置阈值的对象实例。
对象实例始终为特定类型。例如,群集节点 phys-schost-1 是 node 类型的对象实例。仅当为对象类型启用相应的遥测属性时,Oracle Solaris Cluster 软件才监视对象实例的系统资源。
指定要让 Oracle Solaris Cluster 软件收集监视数据的时间段。
为 period 参数指定的日期和时间格式必须符合国际标准化组织 (International Organization for Standardization, ISO) 8601 国际日期格式。
时间段为逗号 (,) 分隔的两个时间之间的时段。
时间段为指定的开始时间与当前时间之间的时段。
时间段为 Oracle Solaris Cluster 软件启动并开始收集数据与指定的结束时间之间的时段。
period 格式示例如下所示:
从 2006 年 4 月 30 日下午 6:00 到 2006 年 6 月 16 日下午 6:00
从 2006 年 6 月 16 日午夜 12:00 起
从 2006 年 7 月 31 日下午 6:00 起
从 Oracle Solaris Cluster 软件启动开始到 2006 年 6 月 16 日下午 6:00
从 2006 年 5 月 31 日午夜 12:00 到 2006 年 6 月 16 日晚上 11:59
只能将该选项与 print 子命令一起使用。
指定您要使用位于 clconfigfile 文件中的配置信息来指定遥测属性和阈值配置。请参见 clconfiguration(5CL) 手册页。
随该选项指定一个破折号 (-) 将通过标准输入 (stdin) 提供配置信息。如果指定了其他选项,则这些选项优先于 clconfigfile 中的选项和信息。
指定 Oracle Solaris Cluster 在其上收集使用情况数据的节点名称。您可以指定一个名称或节点标识符。
对 node 类型的对象实例、资源或资源组指定子命令时,请勿使用 –n 选项。
将遥测属性和阈值配置数据写入文件或标准输出 (stdout)。clconfiguration(5CL) 手册页中描述了该配置信息的格式。
如果您使用该选项指定文件名称,该选项将创建新的文件。然后将配置信息置于该文件中。如果您使用该选项指定 -,则会将配置信息发送到标准输出 (stdout)。命令的所有其他标准输出将受到抑制。
仅可以将此选项与 export 子命令一起使用。
指定 status 子命令的属性列表。
有关您可以使用 set-threshold 子命令来为其设置阈值的属性的信息,请参见 –p name=value 选项的描述。
指定阈值的属性。
允许使用多个 –p name= value 实例。
有关可以使用 status 子命令显示其相关信息的属性的信息,请参见 –p name 选项的描述。
对于每个阈值,必须指定 severity 属性和 direction 属性来标识阈值。设置阈值后将无法修改这些属性。
为每个阈值设置一个 value。还可以为每个阈值设置一个 rearm。使用 set-threshold 子命令来修改 value 和 rearm 属性。可以使用此选项指定的属性和值如下所示:
阈值的严重级别。您可以为该属性设置的可能值是 fatal 和 warning。严重级别为 fatal 的阈值比严重级别为 warning 的阈值更严重。
在 Oracle Solaris Cluster Manager 中,严重级别显示为可视报警。
将应用的阈值的方向。您可以为该属性设置的可能值是 falling 和 rising。通过将 direction 属性设置为 falling,您指定 fatal 严重级别具有比 warning 严重级别低的值。通过将 direction 属性设置为 rising,您指定 fatal 严重级别具有比 warning 严重级别高的值。
您要为遥测属性的阈值设置的值。如果超过该阈值,则遥测属性的严重级别会发生更改。最多可以将四个阈值与对象的特定遥测属性关联。
使用 set-threshold 子命令来设置或修改 value 属性。
清除遥测属性严重级别的方法。通过指定 rearm 值,当遥测特性的值超过与 direction 属性中的设置相反的方向中的 rearm 值时,清除遥测特性的严重级别。如果不指定 rearm 值,则等同于将阈值与 rearm 值设置为相同的值。
通知的频率遵循滞后原则,即,频率由双值函数决定。当函数增加时,应用一个值。当函数与另一个值相同时,应用该值。
设置 rearm 和 value 的值来满足系统需要。如果不指定可选的 rearm 属性,则将 value 视为默认值。但是,如果将 rearm 属性设置为与 value 属性相同的值,或者,如果未将值分配给 rearm,则监视的遥测特性值每次高于或低于为 value 设置的值时,将收到一条通知。为了避免收到大量的通知,请将 rearm 设置为 value 以外的其他值。
如果使用 set-threshold 子命令指定 rearm,则 cltelemetryattribute 命令可确保 rearm 的值符合以下要求:
如果 direction 为 rising,则 value 具有大于或等于 rearm 的值。
如果 direction 为 falling,则 value 具有小于或等于 value 的值。
使用 set-threshold 子命令来更改 rearm。
指定 Oracle Solaris Cluster 软件将收集其使用情况数据的对象类型。所有对象实例都为特定类型。
使用此选项可将子命令的输出限制为指定类型的对象。
您可以为其监视系统资源的对象类型和与每个对象类型关联的遥测属性如下所示:
|
您可以监视的遥测属性如下所示:
|
您并不能监视上表中针对所有对象类型列出的所有遥测属性。使用 list 子命令来显示您可以收集其数据的对象类型,以及可以对每种类型的对象监视的遥测属性。
以国际协调时间 (Coordinated Universal Time, UTC) 或格林尼治标准时间 (Greenwich Mean Time, GMT) 显示与使用情况数据一起显示的日期和时间。通过指定此选项,可以绕过日期和时间与本地日期和时间之间的相互转换。默认情况下,Oracle Solaris Cluster 软件显示本地日期和时间。
只能将该选项与 print 子命令一起使用。
在标准输出 (stdout) 中显示详细信息。
显示该命令的版本。
如果是与其他选项、子命令或操作数一起指定该选项,将忽略所有这些内容。仅显示该命令的版本。不会发生任何其他处理。
支持以下操作数:
需要其使用情况数据的特定遥测属性。
Oracle Solaris Cluster 软件包含可收集其使用情况数据的特定对象类型。对于每个对象类型,您可以启用遥测属性监视。Oracle Solaris Cluster 软件只收集已启用属性的数据。
所有遥测组。
Intro(1CL) 手册页列出了该命令集中所有命令的一整套退出状态代码。
如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
此命令返回下列退出状态代码:
没有错误
您发出的命令已成功完成。
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
参数无效
您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。
权限被拒绝
指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M) 和 rbac(5) 手册页。
遇到内部错误
内部错误表示软件缺陷或其他缺陷。
I/O 错误
发生了物理输入/输出错误。
没有这样的对象
由于以下某个原因,找不到您所指定的对象:
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
对象忙
您尝试将一根电缆从上一个群集互连路径移到一个活动群集节点。或者,您尝试将一个节点从尚未删除引用的群集配置中移除。
对象已存在
您所指定的设备、设备组、群集互连组件、节点、群集、资源、资源类型、资源组或专用字符串已存在。
类型无效
您使用 –t 或 –p 选项指定的类型不存在。
以下命令显示适用于对象类型(在本例中为磁盘)的系统资源。
# cltelemetryattribute list -t disk rbyte.rate wbyte.rate write.rate read.rate示例 2 启用对象类型的遥测属性
以下命令在群集中的所有磁盘上启用指定遥测属性的数据收集。
# cltelemetryattribute enable -t disk rbyte.rate wbyte.rate示例 3 设置对象类型的遥测属性的阈值
以下命令在群集中的磁盘 d4 上设置遥测属性 wbyte.rate 的阈值。rearm 的默认值设置为值 value。因此,当写入磁盘 d4 的字节数超过或低于 100 时,Oracle Solaris Cluster 软件将发出致命通知。
# cltelemetryattribute set-threshold -t disk -b d4 \ -p severity=fatal,direction=rising,value=100 wbyte.rate示例 4 显示已配置遥测属性的非详细列表
以下命令显示在群集中的所有磁盘上配置的遥测属性的非详细列表。
# cltelemetryattribute show -t disk === Telemetry Attributes === Telemetry Attribute: read.rate Unit: read/s Enabled Object Types: disk Telemetry Attribute: write.rate Unit: writes/s Enabled Object Types: disk Telemetry Attribute: wbyte.rate Unit: KBytes/s Enabled Object Types: disk Telemetry Attribute: rbyte.rate Unit: KBytes/s Enabled Object Types: disk示例 5 显示遥测属性的配置的详细列表
以下命令显示在群集中的所有磁盘上配置的遥测属性的详细列表。
# cltelemetryattribute show -v -t disk === Telemetry Attributes === Telemetry Attribute: read.rate Unit: read/s Enabled Object Types: disk Telemetry Attribute: write.rate Unit: writes/s Enabled Object Types: disk Telemetry Attribute: wbyte.rate Unit: KBytes/s Enabled Object Types: disk Telemetry Attribute: rbyte.rate Unit: KBytes/s Enabled Object Types: disk % cltelemetryattribute show -v -t disk === Telemetry Attributes === Telemetry Attribute: read.rate Unit: read/s Enabled Object Types: disk Telemetry Attribute: write.rate Unit: writes/s Enabled Object Types: disk --- Object Instances of Type "disk" --- Object Instance: d4 Thresholds: <Direction, Severity, Value, Rearm> Threshold 1: <rising, fatal, 1000, 500> Telemetry Attribute: wbyte.rate Unit: KBytes/s Enabled Object Types: disk Telemetry Attribute: rbyte.rate Unit: KBytes/s Enabled Object Types: disk示例 6 显示遥测属性的状态
以下命令显示在群集中的所有磁盘上配置的遥测属性的状态。
# cltelemetryattribute status === Telemetry Attributes Thresholds === Attribute Obj-Instance Obt-Type Node Threshold Status Status --------- ------------ -------- ------- --------------------------- ------- mem.used phys-schost-1 node 16-v2-4 <rising, fatal, 1000, 1000> warning
有关以下属性的描述,请参见 attributes(5):
|
cluster(1CL)、Intro(1CL)、sctelemetry(1M)、su(1M)、attributes(5)、rbac(5)、SUNW.SCTelemetry(5)、clconfiguration(5CL)
超级用户可以运行此命令的所有格式。
所有用户都可以运行带有 –?(帮助)或 –V(版本)选项的此命令。
要运行带有其他子命令的 cltelemetryattribute 命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。
|