OI Connector configuration issue

Products

• CA Performance Management - Usage and Administration
• DX NetOps

Issue/Introduction

I am running the OI connector version 2.1.2.141 with the Out of the box configuration.

I am attempting to add additional metric groups to the OI connector for metric publishing into Dx NetOps Performance Management.

Environment

Dx NetOps Performance Management 21.2 and OI connector version 2.1.2.141

Cause

Config issue

Resolution

So for example - we have this in the config xml:

    <bean id="pmMetricFamilyFilters" class="com.ca.im.oinet.connector.sources.kafka.dao.PMMetricFamilyFilters">
        <constructor-arg index="0">
            <map value-type="java.lang.String">
                <entry key="NormalizedAvailabilityInfo">
                    <ref bean="availability"/>
                </entry>
                <entry key="NormalizedReachabilityInfo">
                    <ref bean="reachability"/>
                </entry>
                <entry key="NormalizedPortInfo">
                    <ref bean="port"/>
                </entry>
                <entry key="NormalizedCPUInfo">
                    <ref bean="cpu"/>
                </entry>
                <entry key="NormalizedMemoryInfo">
                    <ref bean="memory"/>
                </entry>
            </map>
        </constructor-arg>
    </bean>

So for this additional metric family you would want to add another <entry> to that pmMetricFamilyFilters bean

<entry key="Normalized....">
      <ref bean="newbeanname" - choose something />
</entry>

Then you need to define "newbeanname" below.

    <bean id="newbeanname" class="com.ca.im.oinet.connector.sources.kafka.dao.PMMetricFamilyFilter">
        <constructor-arg index="0"><value>metric_family_name</value></constructor-arg>
        <constructor-arg index="1"><value>{http://im.ca.com/normalizer}</value></constructor-arg>
    </bean>

The above would specify that all metrics in metric_family_name be exported

 

If you want to limit the metrics that are reported from the family you can do that too.  For example - here we are limiting the port/interface metric family to just the 7 or 8 specified:

   <bean id="port" class="com.ca.im.oinet.connector.sources.kafka.dao.PMMetricFamilyFilter">
        <constructor-arg index="0"><value>port</value></constructor-arg>
        <constructor-arg index="1"><value>{http://im.ca.com/normalizer}</value></constructor-arg>
        <property name="metricIncludeFilters">
            <set>
                <value>Availability</value>
                <value>BitsIn</value>
                <value>BitsOut</value>
                <value>BitsPerSecondIn</value>
                <value>BitsPerSecondOut</value>
                <value>UtilizationIn</value>
                <value>UtilizationOut</value>
            </set>
        </property>
    </bean>

The addition of the "metricIncludeFilters" property is what lets you specific a specific list of metrics from the family to export.  Without that property it will export all metrics in the family.

The OI connector needs to be cycled to pick up the changes

Additional Information

See: https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/performance-management/21-2/integrating/integrate-with-dx-operational-intelligence/configure-the-oi-connector.html for additional information