Creating a Custom Vendor Certification › Understanding the Vendor Certification XML Structure

Understanding the Vendor Certification XML Structure

A vendor certification maps vendor- and device-specific data to performance metrics and configuration data defined in a metric family. Mapping this data from various sources to the "normalized" metric family values helps Data Aggregator uniformly report on this data, regardless of the device vendor.

Here is an example of a custom vendor certification XML that supports our Frame-Relay PVC example. Notice how our example custom metric family, frPVCInfo, is included in the ExpressionGroup section (in bold, for example purposes):

<?xml version="1.0" encoding="UTF-8" ?> 
<!-- Auto-generated by the type catalog local manager.--> 
<DataModel namespace="http://im.ca.com/certifications/snmp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="SNMPCertificationFacet.xsd"> 
  <FacetType name="frPVCInfoCustom" descriptorClass="com.ca.im.core.datamodel.certs.CertificationFacetDescriptorImpl"> 
    <Documentation>Frame Relay PVC Vendor Certification</Documentation> 
    <FacetOf namespace="http://im.ca.com/core" name="Item" /> 
    <AttributeGroup name="AttributeGroup" external="true" list="true"> 
      <Documentation /> 
      <Attribute name="INDEX" type="ObjectID"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.4</Source> 
      <IsIndex>true</IsIndex> 
      <IsKey>false</IsKey> 
      <NeedsDelta>false</NeedsDelta> 
    </Attribute> 
    <Attribute name="frCircuitReceivedBECNs" type="Long"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.5</Source> 
      <IsIndex>false</IsIndex> 
      <IsKey>true</IsKey> 
      <NeedsDelta>true</NeedsDelta> 
    </Attribute> 
    <Attribute name="frCircuitSentFrames" type="Long"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.6</Source> 
      <IsIndex>false</IsIndex> 
      <IsKey>true</IsKey> 
      <NeedsDelta>true</NeedsDelta> 
    </Attribute> 
    <Attribute name="frCircuitSentOctets" type="Long"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.6</Source> 
      <IsIndex>false</IsIndex> 
      <IsKey>true</IsKey> 
      <NeedsDelta>true</NeedsDelta> 
    </Attribute> 
    <Attribute name="frCircuitReceivedFrames" type="Long"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.8</Source> 
      <IsIndex>false</IsIndex> 
      <IsKey>true</IsKey> 
      <NeedsDelta>true</NeedsDelta> 
    </Attribute> 
    <Attribute name="frCircuitReceivedOctets" type="Long"> 
      <Documentation /> 
      <Source>1.3.6.1.2.1.10.32.2.1.9</Source> 
      <IsIndex>false</IsIndex> 
      <IsKey>true</IsKey> 
      <NeedsDelta>true</NeedsDelta> 
    </Attribute> 
  </AttributeGroup> 
  <Protocol>SNMP</Protocol> 
  <DisplayName>Frame Relay PVC Certification</DisplayName> 
  <Expressions> 
    <ExpressionGroup destCert="{http://im.ca.com/normalizer}frPVCInfo" name="frPVCInfoDS"> 
      <Expression destAttr="Indexes">INDEX</Expression> 
      <Expression destAttr="Names">"Frame Relay " + INDEX</Expression> 
      <Expression destAttr="FECNIn">frCircuitReceivedFECNs</Expression> 
      <Expression destAttr="BECNIn">frCircuitReceivedBECNs</Expression> 
      <Expression destAttr="FramesIn">frCircuitReceivedFrames</Expression> 
      <Expression destAttr="FramesOut">frCircuitSentFrames</Expression> 
      <Expression destAttr="BytesIn">frCircuitReceivedOctets</Expression> 
      <Expression destAttr="BytesOut">frCircuitSentOctets</Expression> 
    </ExpressionGroup> 
  </Expressions> 
  <MIB>RFC1315-MIB</MIB> 
 </FacetType> 
</DataModel>