Interface Metrics display data in Octets or Bytes

Document ID : KB000095233
Last Modified Date : 09/05/2018
Show Technical Document Details
Introduction:
How can CA Performance Management be set to display Interface Metric data in Octets or Bytes?
Background:
Sometimes it is more useful to see actual data points rather than calculated percentages or averages.
Environment:
All supported CA Performance Management releases
Instructions:
CA Performance Management comes with sample files that can be used to extend the Interface Metric Family Certifications.

These over-ride out of the box functionality. The results in the display of Interface Metrics as Octets or Bytes.

Two methods exist for implementation of this functionality.
  1. REST API using the XML code from the sample files as the body.
  2. Certification Installer directed to the XML sample file(s)
The simple solution is the Certification Installer which is what these instructions will focus on.
 

Important! Enabling Bytes metrics for the interface metric family may affect system performance.

Support strongly recommends testing in a non-production environment before going live with changes.


To download the Certification Installer:

Follow these steps:

  1. To verify that you have the latest version, download the certification installer from the following URL:
    http://da_host:8581/cert/install.htm

    Important! If you do not use the latest version, an error message appears when you try to install the certification.

    To run the Certification Installer on a Microsoft Windows system, log in as the Administrator, or run the installer as the administrator.

  2. Select a language for the installer.
  3. Specify the following information when the corresponding prompts appear:
    • DA Hostname
    • DA REST port
  4. To specify the type of installation, select Certification or Extension.
  5. Select one of the following options:
    • Install a single certification or extension.
    • Install a collection (ZIP) of certifications or extensions.
    • Install all the certifications or extensions in a directory.

      Note: The certification installer does not search subdirectories.

  6. Click Install.
    The installer checks the version of each certification or extension during the installation process. If the Data Aggregator indicates that a certification or extension is already installed, the installer tries to update the certification or extension.
    The installer imports the vendor certification or extension. If the installer fails to upgrade the certification or extension, an error appears to specify the reason for the failure. Review the error details in the log files that the installer creates in the Home directory of your computer.
To download the XML sample files:

Enable Bytes Metrics

To enable the Bytes, Bytes In, and Bytes Out metrics for individual vendor certifications, extend the certification. The XML to enable the metric is included in the following directory:

/opt/IMDataAggregator/examples/vendorCertification/

Select the file appropriate for your intended use.
Standard Speed Interface Vendor Certification? Use the bytes_ext_IfTableMib.xml
High Speed Interface Vendor Certification? Use the bytes_ext_IfXTableMib.xml

When the Certification Installer and required XML file are downloaded run the installer to import the extension.
Additional Information:
Certification Installer instructions: 
https://docops.ca.com/ca-performance-management/3-5/en/building/self-certification/create-or-extend-vendor-certifications 

Enable Bytes Metrics instructions: 
https://docops.ca.com/ca-performance-management/3-5/en/release-notes/metric-family-changes#MetricFamilyChanges-InterfaceMetricFamily