Integrate CA Unified Infrastructure Management

Integrate CA Unified Infrastructure Management (CA UIM) using the
DX Operational Intelligence
oi_connector probe to analyze the data and display it in the
DX Operational Intelligence
UI. CA UIM integrates with
DX Operational Intelligence
using the
oi_connector
probe and
apm_bridge
probe.
doi13
ADD_UIM
Integrate CA Unified Infrastructure Management (CA UIM) using the
DX Operational Intelligence
oi_connector probe to analyze the data and display it in the
DX Operational Intelligence
UI. CA UIM integrates with
DX Operational Intelligence
using the
oi_connector
probe and
apm_bridge
probe.
  • The
    oi_connector
    probe collects the following data and sends the data to
    DX Operational Intelligence
    • Metrics and metrics metadata
    • Alarm data
    • UIM groups
  • The
    apm_bridge
    probe collects the Topology data and sends the data to
    DX Operational Intelligence
    .
This integration is for CA UIM On-Prem to
DX Operational Intelligence
The following diagram describes the flow of data from CA UIM to
DX Operational Intelligence
using the
oi_connector
probe.
UIM Integration.png
Terminologies
The Terminology details are as follows:
Terminology
Description
NASS
A metric store that stores time series data which is in the form of attributes metadata.
TAS
An inventory and topology store that stores inventory information such as the data of the objects, database instances discovered in the organization, or hosts, and so on.
Prerequisites for Integration
Before you integrate CA UIM with
DX Operational Intelligence
, CA UIM instance and following probes are required:
  • CA UIM must be installed. For more information, see CA Unified Infrastructure Management.
    • Supported versions:
      9.2.0, 20.1, 20.3. For more information on the supported versions, see Compatibility Matrix. If you want to integrate with the latest UIM version, contact Broadcom Support
    • Download the CA UIM Probes:
      Software
      Version
      Download
      Description
      Notes
      oi_connector
      1.38
      Integrates CA Unified Infrastructure Management (UIM) and DX Operational Intelligence. You can configure the oi_connector probe to send alarms and metrics to Elastic using Jarvis.
      CA UIM 9.2.0
      CA UIM 20.1
      CA UIM 20.3
      apm_bridge
      1.0.4
      Sends CA UIM inventory topology data to the (NextGen) TAS
      • oi_connector probe 1.38
      • apm_bridge 1.0.4
      • UIMAPI 20.30
      • VMware 7.15
oi_connector Probe
The oi_connector probe integrates CA Unified Infrastructure Management (UIM) and DX Operational Intelligence. You can configure the oi_connector probe to send data to DX Operational Intelligence. The oi_connector probe enables you to perform the following actions:
  • Store UIM alarms, metrics (QoS), and UIM groups in DX Operational Intelligence
The oi_connector probe is configurable only through Admin Console and performs the following tasks:
  • Posts alarms, metrics (QoS), and UIM groups to DX Operational Intelligence (organizations or tenants register their analytical applications with metric store (NASS)  for using it as the analytics engine).
  • Creates different queues for UIM alarms and metrics (QoS) on the hub.
For more information, see CA Unified Infrastructure Management.
After you upgrade to the latest version, new metrics such as
net_connect
,
rsp
, and
cdm
get added to the probes and data flows only to the new metrics. All metrics names are now enhanced to display metrics units. For example, previously if the metric name was
Disk Free
, now you would see
Disk Free MB
. The previous metric
Disk Free
becomes obsolete and no metadata flows to this metric after the upgrade, but the metric name would be visible on the UI.
In order to perform the integration of CA Unified Infrastructure Management (CA UIM) using the
DX Operational Intelligence
you need to perform the following two probe configurations:
  • oi_connector
  • apm_bridge
Step 1: Configuring the oi_connector Probe
You can configure the
oi_connector
probe to send data to DX Operational Intelligence. Configuring this probe allows you to import UIM alarms, groups, and QoS to
DX Operational Intelligence
which enables you to monitor this information through the
DX Operational Intelligence
UI.
Required Configuration
Details
Default Tenant ID
You can obtain the Tenant ID from Elastic by using:
http://<elasticsearch-endpoint>/ao_tenants_1_1/_search?size=200&pretty
Jarvis Ingestion Endpoint (Nginx)
If you are using
Openshift
:
oc get routes -n<namespace> | grep nginx
If you are using
Kubernetes
:
kubectl get ingress -n<namespace> | grep nginx
For example,
apmservices-gateway.10.109.32.162.nip.io
NASS URL (apmservices-gateway)
If you are using
Openshift
:
oc get routes -n<namespace> | grep apmservices-gateway
If you are using
Kubernetes
:
kubectl get ingress -n<namespace> | grep apmservices-gateway
NASS Tenant Token
To connect CA UIM with
DX Operational Intelligence
and to monitor CA UIM data, you need to configure the oi_connector probe. To configure the oi_connector probe, see oi_connector Configuration.
Step 2: Configuring the apm_bridge Probe
You can configure the apm_bridge probe to send topology data from the CA UIM probes to DX Operational Intelligence. The apm_bridge probe supports multi-tenancy. After completing the
oi_connector
configuration, you need to configure the
apm_bridge
probe.
Required Configuration
Details
origin
<your-uim-host-hub>
token
host
TAS URL for inventory and topology data. To obtain the TAS URL:
If you are using
Openshift
:
oc get routes -n<namespace> | grep apmservices-gateway
If you are using
Kubernetes
:
kubectl get ingress -n<namespace> | grep apmservices-gateway
useSsl
false
for
http
, and
true
for
https
(based on requirements).
port
80 (port of apmservices-gateway)
. It can be
80
or
443
based on your DXI setup.
To configure the apm_bridge probe, see apm_bridge Configuration
Proxy Configuration (Optional)
After completing the apm_bridge configuration, you need to configure the proxy:
Follow these steps:
  1. Configure the proxy details as shown below:
    UIM Integration.png
  2. Click Run UIM Integration.png icon.
    UIM Integration.png
    The configuration details are updated in the
    Raw Configuration
    entries.
The proxy configuration is complete. For more information, see oi_connector Configuration
Upgrade Process (Optional)
If you want to perform an upgrade:
  1. Click alarm view filter.png icon next to the oi_connector.
  2. In the context menu, click
    Raw Configure
    .
  3. In
    Setup,
    ensure that you see the following two keys, else you need to update them accordingly:
    • ingest_data_to_nass = true
    • doc_type_version_uim_metrics_metadata=2
    UIM Integration.png
    UIM Integration.png
  4. Click
    Update
    .
    After upgrading to the latest version, the older metric chart would not be available for some probes such as net_connect, rsp, cdm and so on.
Troubleshooting
This section provides you with information on troubleshooting, common issues, and best practices while working on the CA UIM integration: