Viewing Vendor Certification assignment by Device or Component item

Document ID : KB000126689
Last Modified Date : 11/02/2019
Show Technical Document Details
Introduction:
It can be helpful to determine supported Vendor Certifications per Device or Component. Comparing these outputs device to device across similar devices can reveal missing or incorrect certification support for devices.

Normally this is done through the Performance Management (PM) Performance Center (PC) web UI but it can be difficult to compare devices. Is there a way to obtain this information outside of the UI for easier analysis and comparison efforts?
Background:
Provides REST methods to obtain Vendor Certification support per Device or Component without having to use the UI.
Environment:
All supported Performance Management releases.
Instructions:
The following Data Aggregator (DA) based REST calls will show how to extracted Vendor Certification support for Devices or Components.
 
Devices


For device items we use this REST URL:

<DA_Host>:8581/rest/tenant/<TENANTID>/devices/metricfamilysupporthistory/<DA_deviceItemID>

We can use the following URL to determine the necessary <TENANTID> to use. I see in that output for example the Default Tenant ID is 1. 

<DA_Host>:8581/rest/tenants 

I then obtained a a Device ID. I used the REST URL <DA_Host>:8581/rest/devices/manageable to find the ID. I placed it at the end of the URL: 

<DA_Host>:8581/rest/tenant/1/devices/metricfamilysupporthistory/<DA_deviceItemID>

Reviewing the information returned we see both supported Vendor Certification and Metric Families where no Vendor Certification support was found.

This is an example of a Metric Family where no Vendor Certification was found to support. This one is for the Metric Family NormalizedPoolConnectionPoolMemberPVAInfo. 

<ConsolidatedMetricFamilyList> 
<MetricFamilyID> 
{http://im.ca.com/normalizer}NormalizedPoolConnectionPoolMemberPVAInfo 
</MetricFamilyID> 
<Status>NOT_SUPPORTED</Status> 
<PollRate>STOPPED</PollRate> 
<LastDiscoveryTime>Thu Jan 31 9:22:02 2019 -0500</LastDiscoveryTime> 
</ConsolidatedMetricFamilyList> 

This is an example of a Vendor Certification that was found as supported. It is for the Metric Family NormalizedPortInfo which resulted in support for the IfXTableMib Vendor Certification.

<ConsolidatedMetricFamilyList> 
<MetricFamilyID>{http://im.ca.com/normalizer}NormalizedPortInfo</MetricFamilyID> 
<VendorCertID>im.ca.com-certifications-snmp-IfXTableMib</VendorCertID> 
<VendorCertDisplayName>High Speed Interface</VendorCertDisplayName> 
<Status>SUPPORTED</Status> 
<PollRate>MULTIPLE</PollRate> 
<LastDiscoveryTime>Thu Jan 31 9:22:13 2019 -0500</LastDiscoveryTime> 
</ConsolidatedMetricFamilyList> 

 

 

Components


For Component items use this REST URL: 

<DA_Host>:8581/rest/devices/components/<DA_ComponentItemID> 

As an example I reviewed an Interface item. In the results we see the following. It shows that the interface supports the IfTableMib Vendor Certification. 

<CertificationFacetTypesList> 
<CertificationFacetTypes>{http://im.ca.com/certifications/snmp}IfTableMib</CertificationFacetTypes> 
</CertificationFacetTypesList> 

This page will also list supported Metric Families in these entries: 

<SourceFacetTypesList> 
<SourceFacetTypes>{http://im.ca.com/normalizer}NormalizedPortInfo</SourceFacetTypes> 
</SourceFacetTypesList>