(選用) 新增 <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 相符的項目，下列條件將產生這些結果：
- 如果少於兩個屬性相符，則將建立新的元件項目。
- 如果至少兩個屬性值相符，但是其他屬性值不同，則將以新的屬性值更新現有元件項目。
  附註：其中一個相符的屬性值必須是必要的屬性。
對於名稱屬性，「必要的」金鑰是設定為「true」。這表示，名稱屬性必須是三個相符屬性的其中一個。

重新調整定義包含 BestOf 比對演算法時，將產生下列結果：

如果搜索結果僅符合一個現有元件項目，該結果即為相符項目。
如果搜索結果符合多個現有元件項目，將考慮相符屬性數。最符合屬性的現有元件將被視為搜索結果的相符項目。
附註：如果多個元件的相符屬性數相同，將隨機選擇相符元件項目。因此，karaf 記錄將記錄此情況的警告。

您可以將多個比對演算法新增至重新整理定義。新增多個比對演算法時，這些演算法有比對優先順序。 MatchAlgorithmList 最上方的比對演算法具有最高的優先順序。最下方的比對類型具有最低的優先順序。

重新調整定義包含多個比對類型時，將產生下列結果：

如果搜索結果僅符合一個現有元件項目，這個即為相符項目。演算法優先順序不構成影響。
搜索結果比對出多個現有元件項目時，最高優先順序的演算法將優先適用。符合最高優先順序演算法的元件項目將進行比對。
例如：

由於 algorithm1 的優先順序較高，因此 Discovery Result A 會比對出 Component1。
多個搜索結果比對出一個現有元件項目時，最高優先順序的演算法將優先適用。符合最高優先順序演算法的元件項目將進行比對。
例如：

由於 algorithm1 的優先順序較高，因此 Discovery Result A 會比對出 Component1。

例如：

在此範例中，Discovery Result B 比對出 Component 1，而且屬性數超過 Component 2. Discovery Result A 比對出 Component 1，因為這是以較高優先順序的演算法進行比對。因此，Component 1 的比對由 Discovery Result A 進行，而 Discovery Result B 比對出 Component 2.

附註：如果未定義重新調整演算法，Data Aggregator 將使用 Item.Name 屬性比對元件。

更多資訊：

建立自訂度量系列 XML 檔