Creating a Custom Metric Family › Understanding the Metric Family XML Structure › ItemReconciliation

ItemReconciliation

Important! ItemReconciliation is a new section that will likely change to support future, complex metric family structures. Its use is discouraged.

The following information defines the item reconciliation logic that is used in item discovery. The logic determines whether the system has already discovered an item or not. Based on this determination, an existing item is updated or a new item is created. Item reconciliation is similar to component reconciliation. However, item reconciliation is used for items that are not components, such as virtual hosts. The ItemFacets are added to any new items or to any matching items (if the facets do not exist).

Example:

<ItemReconciliation>

<SourceAgentScopedReconciliation>

<MatchAlgorithms>
   <ExactMatch>
      <MatchAttribute name="{http://im.ca.com/inventory}SourceAgentInfo.SourceAgentIndexes" />
   </ExactMatch>
</MatchAlgorithms>

</SourceAgentScopedReconciliation>
<GlobalScopedReconciliation matchDevices="true" />

</ItemReconciliation>

SourceAgentScopedReconciliation

Defines the match algorithms that are used to reconcile items.

Can be updated: Yes

Effect of updating: Changes the item reconciliation logic.

When does the update take effect: Rediscovery

Required actions for updates to take effect: Update the metric family or change the vendor certification priority.

GlobalScopedReconciliation

Defines the match algorithms that are used when items could not be reconciled for the source agent. The GlobalScopedReconciliation algorithms are used to locate items that have been created for other agents but match the potential new items. If the matchDevices property is set to true, the system default (built-in, not visible in XML) ComponentReconciliationInfo match algorithm is used. The match algorithm is based on the device primary IP address and host name.

Can be updated: Yes

Effect of updating: Changes the item reconciliation logic.

When does the update take effect: Rediscovery

Required actions for updates to take effect: Update the metric family or change the vendor certification priority.

More information:

ItemFacets

MatchAlgorithms