（可选）添加 <ComponentReconciliation> 部分

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

（可选）添加 <ComponentReconciliation> 部分

您可以在 <ComponentReconciliation> 部分中为您的自定义度量标准系列定义调整算法。调整算法用于支持受监视设备的配置更改。设备对给定度量标准系列的支持情况可视为设备的配置。例如，接口的数量以及接口的配置表示设备对接口度量标准系列的支持情况。在对设备的接口进行更改时，Data Aggregator 必须更新对这些接口的表示，以帮助确保监视是最新的。在此配置更新期间会应用调整算法。

为了支持某些度量标准系列，在 Data Aggregator 中创建了各个组件项。这些组件项表示支持给定度量标准系列的设备配置。以接口度量标准系列作为示例，Data Aggregator 创建端口组件项来表示设备的每个网络接口。

通过设备集合将监视配置文件应用于设备时，将进行组件项的初始发现和创建。为了支持受监视设备上的更改，会根据需要进行后续的组件发现。在进行后续组件发现之后，便会应用调整算法，以确定更新组件项的集合所需进行的更改。

当设备的配置发生更改时，有四种情况需要评估：

新组件－设备已更改，因此 Data Aggregator 中需要新的组件项。
未更改的组件－设备配置更改未改变某些现有组件，因此，这些组件项未更改。
更改的组件－设备配置改变了一些组件，但是它们仍然存在。 Data Aggregator 的组件项必须更新，以反映新的配置。
删除的组件－设备发生更改，因此有一个或多个组件在设备中不再存在。这些组件项可以删除或报废。

调整算法定义了可在现有组件项与新发现结果之间比较的一组属性。通过对属性值进行比较来确定哪些新发现结果与现有的组件项匹配，哪些表示新组件或更改的组件。此比较将产生以下结果：

如果发现结果不与任何现有组件项匹配，会创建一个新组件项。
如果发现结果与现有组件项的所有属性都匹配，则组件项未更改。
如果发现结果发现匹配，但有些属性值不同，将用任何新属性值更新现有组件项。
有时，发现结果会确定有些现有组件项不以任何方式与新结果匹配。在这种情况下，可确定设备中不再存在这些组件，可将其删除或报废。

您可以在调整算法中定义两种匹配类型：ExactMatch 和 BestofMatch。

ExactMatch: 指示发现结果必须与组件项的所有指定属性匹配。

示例：ExactMatch 调整算法

以下示例显示定义 ExactMatch 匹配类型的调整算法：

<ComponentReconciliation>
     <MatchAlgorithmList>
          <MatchAlgorithm>
               <AlgorithmType>Exact</AlgorithmType>
               <MatchAttributeList>
                    <MatchAttribute>
                         <Name>{http://im.ca.com/core}Item.Name</Name>
                    </MatchAttribute>
                    <MatchAttribute>
                         <Name>{http://im.ca.com/inventory}Process.Path</Name>
                    </MatchAttribute>
                    <MatchAttribute>
                         <Name>{http://im.ca.com/inventory}Process.Arguments</Name>
                    </MatchAttribute>
               </MatchAttributeList>
          </MatchAlgorithm>
     </MatchAlgorithmList>
</ComponentReconciliation>

此算法表示发现结果必须匹配现有组件项的所有三个属性，以便完全匹配。如果找不到完全匹配，以下条件会生成下列结果：

如果三个属性值中的任一值不同，便会创建新组件项。
如果三个属性值都匹配，但其他属性值不同，便会用新属性值更新现有组件项。

BestofMatch: 指定最少的属性数量，这些属性必须与现有组件项中的相同数量的属性匹配。每个属性都包括一个“必需”键。如果“必需”键设置为“true”，该属性必须是匹配的属性之一。

示例：BestofMatch 调整算法

以下示例显示定义 BestofMatch 匹配类型的调整算法：

<ComponentReconciliation>
     <MatchAlgorithmList>
          <MatchAlgorithm>
               <AlgorithmType>BestOf</AlgorithmType>
               <LeastMatchCount>2</LeastMatchCount>
               <MatchAttributeList>
                    <MatchAttribute>
                         <Required>true</Required>
                         <Name>{http://im.ca.com/core}Item.Name</Name>
                    </MatchAttribute>
                    <MatchAttribute>
                         <Name>{http://demo/custom}Process.Path</Name>
                    </MatchAttribute>
                    <MatchAttribute>
                         <Name>{http://demo/custom}Process.Arguments</Name>
                    </MatchAttribute>
               </MatchAttributeList>
          </MatchAlgorithm>
     </MatchAlgorithmList>
</ComponentReconciliation>

此算法指定以下要求：

发现结果必须与现有组件项至少匹配所列属性中的二个，才是匹配。如果找不到 BestofMatch 匹配，以下条件会生成下列结果：
- 如果匹配的属性少于二个，便会创建新组件项。
- 如果至少二个属性值匹配，但其他属性值不同，便会用新属性值更新现有组件项。
  注意：匹配的属性值之一必须是必需的属性。
对于 Name 属性，“必需”键设置为“true”。这表示 Name 属性必须是匹配的三个属性之一。

在 BestOf 匹配算法包含在调整定义中时，会有以下结果：

如果发现结果仅与一个现有组件项匹配，则结果匹配。
如果发现结果与多个现有组件项匹配，会考虑匹配属性的数量。会将匹配属性最多的现有组件视为发现结果的匹配项。
注意：如果多个组件的匹配属性数相同，会随机选择匹配组件项。因此，karaf 日志会记录一条关于此条件的警告。

可向调整算法中添加多个匹配算法。添加了多个调整算法时，它们将匹配优先级。 MatchAlgorithmList 顶端的匹配算法有最高优先级。底部的匹配类型优先级最低。

当调整算法中包括多个匹配类型时，会有以下结果：

如果发现结果只与一个现有组件项匹配，则该项为匹配项。算法优先级无关紧要。
当发现结果与多个现有组件项匹配时，则优先采用具有最高优先级的算法。匹配将转向由优先级最高的算法生成的组件项。
例如：

由于算法 1 的优先级较高，因此发现结果 A 与组件 1 匹配。
当多个发现结果与一个现有组件项匹配时，则优先采用具有最高优先级的算法。匹配将转向根据优先级最高的算法认定匹配的组件项。
例如：

由于算法 1 的优先级较高，因此发现结果 A 与组件 1 匹配。

例如：

在此示例中，发现结果 B 与组件 1 匹配的属性多于与组件 2 匹配的属性 2.发现结果 A 与组件 1 匹配，因为它使用优先级较高的算法来匹配。因此，组件 1 的匹配会转至发现结果 A，发现结果 B 匹配组件 2. 2

注意：如果未定义调整算法，Data Aggregator 将使用 Item.Name 属性匹配组件。

详细信息：

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