使用 Web 服务 › 如何创建自定义度量标准系列 › 创建自定义度量标准系列 XML 文件 › 添加 <AttributeList> 部分

添加 <AttributeList> 部分

<AttributeList> 部分定义了您希望为度量标准系列收集的配置度量标准或性能度量标准。 即使许多属性对于某一设备类型可用，您也要仔细规划哪些属性对于监视基础架构重要。 属性数据的三种常见用途如下：

• 报告－这些属性值可以经常更改。 通常，在每个周期中都会轮询这些值，从而提供在报告中使用的易变值，以说明随着时间的推移而进行的变更。 示例包括传入/传出字节数、带宽和 CPU 内存使用率。
• 配置－这些属性提供用于标识项的数据。 该数据很少发生更改。 因此，通常仅在发现期间收集该数据（即，在每个周期中不轮询该数据）。 示例包括名称、说明和 ID。
• 调整－这些属性的用途是检测环境中的配置更改。 检测到的变更会触发发现，以帮助确保您的 Data Aggregator 数据准确。

每个属性可以包括以下标记：

<Name>

该属性的唯一内部名称（限定名称格式）。

<Description>

该文本作为工具提示显示在您的 CA Performance Center 视图中。

<AttributeDisplayName>

该标记用以确定您的属性在报告和 CA Performance Center 显示板中的标识方式。

<Type>

该属性的数据类型。 最常用的数据类型是整数、Long、Double、字符串或对象 ID。

<Polled>

设置为 True 时，Data Aggregator 将在每个轮询周期内收集此度量标准数据。 设置为 False 时，仅在发现一个项目时收集该数据。

<IsList>

该属性提供标量或表数据。 请考虑以下定义：

• 标量属性－这些属性一次返回一个值，此值与设备数据一起存储。 例如，“当前进程数”的属性返回单个值。
• 表属性 -- 这些属性在为表中每行返回一个值。 示例进程度量标准系列使用表属性。 每行对应于单个进程项。

注意：如果此标记对属性为 True，必须为相同属性列表中的每个属性将其设置为 True。 在这种情况下，必须在列表中定义索引（对象 ID 类型）和名称（字符串类型）属性。

<IsDbColumn>

该标记指示存储在数据库表中的属性值。 对于配置度量标准，请将此标记值设置为 False。

<RollupStrategy>

该标记指定计算单个轮询值的总和或平均值。 当 <Polled> 和 <IsDbColumn> 设置为 True 时，需要使用此标记。

<Baseline>

设置为 True 时，将为该属性计算基准值，您可以在 <BaselineList> 部分中添加相应的基准定义。

当包括 <RollupStrategy> 或将 <Baseline> 设置为 True 时，还需要使用以下标记：

基准

表明是否计算此属性的基准。 如果将其设置为 True，则必须存在对应的 BaselineList 定义。

最大值

表明在累加期间是否计算此属性的最大值。 在数据库表中创建“max_”列。

最小值

表明在累加期间是否计算此属性的最小值。 在数据库表中创建“min_”列。

方差

表明在累加期间是否计算此属性的方差。 在数据库表中创建“var_”列。

StandardDeviation

表明在累加期间是否计算此属性的标准偏差。 在数据库表中创建“std_”列。

RollupStrategy

在单独累加轮询值期间，指定执行每个周期的运算符。 该值可以是用于计算总和或平均数的“Sum”或“Avg”

<Filterable>

该标记指示可用于监视配置文件筛选的属性。 在应用筛选时，具有此标记的属性将适用于筛选表达式。

注意：有关每个 XML 标记的详细信息，请参阅 MetricFamily.xsd 和 Component.xsd 文件中提供的行内注释式文档。 有关代码示例，请参阅 ProcessInfoMFWithComponent.xml 文件。 此示例文件定义用于收集进程度量标准的度量标准系列。

详细信息：

创建自定义度量标准系列 XML 文件

AttributeList

“属性列表”列出收集并存储在数据库表中的属性。 下列信息描述了您在“AttributeList”部分中使用的元素：

名称

指定用于命名数据库列的唯一内部名称。 系统指定名称要采用 QName 格式：

{URI}FamilyName.AttrName

注意：绝不能对外公开此名称。 要在用户界面中显示属性名称，请使用 AttributeDisplayName 元素。

AttributeDisplayName

指定运算符和管理员界面中显示的值。 AttributeDisplayName 可以本地化为多种语言。

说明

在用户界面中显示属性说明。 将鼠标指针悬停在属性名称时，说明还会显示在工具提示中。

类型

表明此属性的数据类型。 最常用的数据类型是整数、Long、Double、字符串或 ObjectID。

已轮询

表明该属性是否已轮询。 如果将其设置为 False，则仅可在发现期间访问它。

IsList

如果将其设置为 True，则从表中检索属性。 还可以为表中的每行创建组件项。

注意：在您将任意属性的特性设置为 True 后，则需将存储在数据库中度量标准系统的每个属性的特性都设置为 True。

IsDbColumn

在数据库表中存储其值。 IsDbColumn 通常用于每个周期都轮询且包含于报告中的属性。

注意：如果您尚未使用 ProcessInfoMFWithComponent.xml 但从 http://host:port/genericWS/metricfamilies/<name> 下载了 XML 文件以启用度量标准系列，请删除 RollupExpression 和单位节点，因为它们已被弃用。

常规属性

在下图中，任何度量标准系列都存在 Indexes、Names 和 Descriptions 属性。

任何支持供应商认证可以提供度量标准系列展现的 URI，如：

{http://im.ca.com/normalizer}Name.Indexes

{http://im.ca.com/normalizer}Name.Names

{http://im.ca.com/normalizer}Name.Descriptions

简单属性

在下图中，数据库只存储大多数属性的值。 没有进行进一步的处理（例如基准评估）。

支持的供应商认证必须采用下列格式提供一些度量标准系列公开的 URI：

{http://im.ca.com/normalizer}Name.AttributeName