Add a New Filter to a Vendor Certification

This self-certification workflow is an example of a real use case that you may encounter. Use this workflow as a model to help you with self-certification:
capm250
This self-certification workflow is an example of a real use case that you may encounter. Use this workflow as a model to help you with self-certification:
HID_Add_Filter_to_Vendor_Cert
In this example, you add a filter to the IfTableMib vendor certification to prevent items with ifType 53 (propVirtual) from being discovered.
After the filter is applied, you can expect the following results:
  • In
    Performance Center
    , if you go to
    Administration
    ,
    Monitored Devices
    ,
    Polled Metric Families
    , the interface appears as
    Not Available
    or 
    Not Present
    and
    Not Polled
    .
  • In
    Performance Center
    , if you go to
    Administration
    ,
    Monitored Devices
    ,
    Filter Report
    , the filter report is unaffected. The report shows only the filters from the monitoring profile. The report excludes the filter from the vendor certification.
  • The interface is still available through REST on the Data Aggregator.
  • The interface is unavailable through OpenAPI.
After the next sync, you can expect the following results in
Performance Center
:
  • If you go to
    Inventory
    ,
    Interfaces
    , the interface is removed.
  • The interface is removed from all dashboards and context pages.
Follow these steps:
  1. Make a GET REST call to export existing extensions for the vendor certification.
    http://
    da-hostname
    :8581/typecatalog/certifications/snmp/extension/
    Vendor_Certification_Name
    For example:
    http://
    da-hostname
    :8581/typecatalog/certifications/snmp/extension/IfTableMib
    To retrieve the name of the vendor certification in the UI, go to the Vendor Certification page. Click the downward arrow on any column, hover over
    Columns
    , and click
    Internal Name
    .
  2. Find the metric definition in the XML file.
    <ExpressionGroup name="PortNRMDS" destCert="{http://im.ca.com/normalizer}NormalizedPortInfo">
  3. Enter the metric filtering expression inside a Filter tag.
    <Filter>(ifType!=24) &amp;&amp; (ifType!=1) &amp;&amp; (ifType!=53)</Filter>
  4. Make a PUT REST call to import the new XML file.
    http://
    da-hostname
    :8581/typecatalog/certifications/snmp/extension/IfTableMib
    After you import the vendor certification, the Data Aggregator resumes polling using the new extended vendor certification.
  5. Click the
    Update Metric Family
    button on Metric Families page.
    The vendor certification no longer monitors interfaces of ifType 53.
  6. To verify that the filter is added, click
    Admin
    ,
    Monitored Devices
    .
  7. Click
    Polled Metric Families
    .
    In the list of Components, the Status of the filtered interfaces is changed to
    Not Available
    or
    Not Present
    , and the
    SNMP Poll Rate
    is changed to
    Not Polled
Example
The following example shows how to define the metric filtering expression in the IfTableMib vendor certification:
<?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">
  <Author>CA</Author>
  <Version>2.02</Version>
  <FacetType name="IfTableMib" descriptorClass="com.ca.im.core.datamodel.certs.CertificationFacetDescriptorImpl">
    <FacetOf namespace="http://im.ca.com/core" name="Item" />
    <Expressions>
      <ExpressionGroup destCert="{http://im.ca.com/normalizer}NormalizedPortInfo" name="PortNRMDS">
         <Filter>(ifType!=24) &amp;&amp; (ifType!=1) &amp;&amp; (ifType!=53)</Filter>
      </ExpressionGroup>
     </Expressions>
  </FacetType>
</DataModel>