Add Metrics to Existing Metric Families

In this workflow, add a BitsRateCustom metric that is based on collected MIB objects to the Interface metric family.
In this workflow, you add a BitsRateCustom metric that is based on collected MIB objects to the Interface metric family.
You can report data on the metrics that you add by creating a view for them.
For more information, see Manage Dashboards.
In this article:
2
Update the Metric Family with the Metric
Follow these steps:
  1. Export existing extensions for the Interface metric family by making the following GET REST call:
    http://
    da_hostname
    :8581/typecatalog/metricfamilies/extension/NormalizedPortInfo
    The current extensions are returned. If you have not defined any extensions, the following XML is returned:
    <DataModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" namespace="http://im.ca.com/normalizer" xsi:noNamespaceSchemaLocation="IMDBCertificationFacet.xsd"> <Author>CA</Author> <Version>2.03</Version> <FacetType name="NormalizedPortInfo" descriptorClass="com.ca.im.core.datamodel.certs.NormalizedFacetDescriptorImpl"> <FacetOf namespace="http://im.ca.com/core" name="Item"/> </FacetType> </DataModel>
  2. Define the
    BitsRateCustom
    attribute in the extension XML file:
    <DataModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" namespace="http://im.ca.com/normalizer" xsi:noNamespaceSchemaLocation="IMDBCertificationFacet.xsd">
    <Author>CA</Author>
    <Version>2.03</Version>
    <FacetType name="NormalizedPortInfo" descriptorClass="com.ca.im.core.datamodel.certs.NormalizedFacetDescriptorImpl">
    <FacetOf namespace="http://im.ca.com/core" name="Item"/>
    <AttributeGroup name="PortInfoPollable" list="true" external="true">
    <Attribute name="BitsRateCustom" type="Double">
    <Documentation/>
    <IsDbColumn>true</IsDbColumn>
    <Baseline>false</Baseline>
    <Minimum>true</Minimum>
    <Maximum>true</Maximum>
    <RollupStrategy>Sum</RollupStrategy>
    <StandardDeviation>false</StandardDeviation>
    <Variance>false</Variance>
    <Percentile>95</Percentile>
    <Percentile2>0</Percentile2>
    <Percentile3>0</Percentile3>
    <ProjectionPercentile>0</ProjectionPercentile>
    <Polled>true</Polled>
    <Units>BitsPerSecond</Units>
    </Attribute>
    </AttributeGroup>
    </FacetType>
    </DataModel>
  3. Import the extensions for the Interface metric family by making the following PUT REST call:
    http://
    da_hostname
    :8581/typecatalog/metricfamilies/extension/NormalizedPortInfo
The Interface metric family is updated with the BitsRateCustom metric.
Update the Vendor Certification with the Metric
Follow these steps:
  1. Export the extensions for the vendor certification by making the following GET REST call:
    You can retrieve the name of the vendor certification using
    DX NetOps Performance Management
    . From the
    Monitoring Configuration
    menu for your data aggregator data source, click
    Vendor Certifications
    , click the downward arrow on any column, hover over
    Columns
    , and then click
    Internal Name
    .
    http://
    da_hostname
    :8581/typecatalog/certifications/snmp/extension/
    cert_name
  2. Add an expression for calculating the
    BitsRateCustom
    attribute:
    <?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">
    <Expression destAttr="BitsRateCustom">((ifInOctets+ifOutOctets)*8)/_rspDuration</Expression>
    </ExpressionGroup>
    </Expressions>
    </FacetType>
    </DataModel>
  3. Import the extensions for the vendor certification by making the following PUT REST call:
    http://
    da-hostname
    :8581/typecatalog/certifications/snmp/extension/
    cert_name
The vendor certification is updated.
DX NetOps Performance Management
resumes polling and uses this extended vendor certification.
The BitsRateCustom metric becomes available 10 minutes after you import the extensions for the vendor certification.
(Optional) Add the Metric to Monitoring Profiles Configured to Select Collected Metrics
Add the metric to those monitoring profiles that are configured to select collected metrics (the monitoring profile has assigned metric families).
For more information:
Validate the Metric
Data that
DX NetOps Performance Management
polls for the BitsRateCustom metric appears in views after 3 poll cycles (15 minutes).
Follow these steps:
  1. Hover over
    Administration
    ,
    Data Sources
    , and then click a data aggregator data source.
    The data aggregator Admin pages open.
  2. Under
    Monitoring Configuration
    , click
    Metric Families
    .
    The
    Metric Families
    tab appears.
  3. Verify that the BitsRateCustom metric appears.
    For more information about how to view data aggregator health monitoring information, see View Health Monitoring Information.