oi_connector AC Configuration
This article describes how to configure the DX Operational Intelligence Gateway (oi_connector) probe. Using this probe, you can import UIM alarms, groups, and QoS to DX Operational Intelligence which enables you to monitor this information through the DX Operational Intelligence dashboards.
uimpga-ga
oiconnector_AC
This article describes how to configure the DX Operational Intelligence Gateway (oi_connector) probe. Using this probe, you can import
UIM
alarms, groups, and QoS to DX Operational Intelligence which enables you to monitor this information through the DX Operational Intelligence dashboards.The following diagram outlines the process to configure the probe.
Configuing oi_connector on AC

Contents
2
Verify Prerequisites
Verify that the required hardware and software are available and installation considerations are understood before you configure the probe. For more information, see oi_connector (DX Operational Intelligence Gateway) Release Notes.
(Optional) Configure Logging Properties
You can change the default configuration of your probe if these settings do not meet your requirements.
Follow these steps:
- Select theoi_connectornode.TheProbe Informationsection provides information about the probe name, probe version, start time of the probe, and the probe vendor.
- In theoi_connectornode >General Configurationsection, specify from the following level of details that are written to the log file in theLog Levelfield:
- 0 - Logs only severe information (default)
- 1 - Logs error information
- 2 - Logs warning information
- 3 - Logs general information
- 4 - Logs debugging information
- 5 - Logs tracing/low-level debugging information
: Log as little as possible during normal operation to minimize disk consumption, and increase the amount of detail when debugging.
Enable Alarm, Groups, and QoS
Use the following procedure to setup your configuration.
Follow these steps:
- In theoi_connectornode >UIM Configurationsection, update the following information to enable theUIMalarm and inventory subscription by the oi_connector probe:
- Subscribe to UIM Alarm: enables the subscription of UIM alarms based on the severity. If disabled, alarms are not indexed.By default, all the severity types for the alarms are selected, you can unselect the severity types that are not required. If the "Selected" field is blank, no alarms are sent to DX Operational Intelligence (DOI).
- Subscribe to UIM Groups:
- UIM Groups:allows you to select groups for sending data (list of devices, metrics, alarms, and CI) of only the selected groups to DOI. The group names appear in theGroup Name – Parent Group Nameformat. This is an optional field. By default, no groups are selected and all UIM groups data is forwarded to DOI. The following screenshot illustrates the selected UIM groups:
- Subscribe to UIM QoS: enables the subscription of UIM QoS. If disabled, QoS data is not indexed.TheSelected QoS Origins,Selected QoS Hosts, andSelected Qos Probesfields are enabled only when theSubscribe to UIM QoS optionis selected. You can also use regular expressions in these fields. For more information, seeUse Regular Expressions.
- Selected QoS Origins: specifies the origins for which the oi_connector probe enables forwarding of QoS messages to Jarvis. Each origin signifies a hub within the UIM domain. You can also use regular expressions to specify multiple origins. If this field is left blank (.*), the probe enables the forwarding of QoS messages from all the origins to Jarvis.Default: Blank
- Selected QoS Hosts: specifies the hosts for which the oi_connector probe enables forwarding of QoS messages to Jarvis. You can also use regular expressions to specify multiple hosts. If this field is left blank (.*), the probe enables the forwarding of QoS messages from all the hosts to Jarvis.Default: Blank
- Selected QoS Probes: specifies a single probe or a list of probes. The probe enables forwarding of QoS messages from the specified probes to Jarvis. You can also use regular expressions to specify multiple probes. If this field is left blank, the probe enables the forwarding of QoS messages from all the probes to Jarvis.Default: cdm|aws|openstack|docker|azure|nutanix|vmware|logmon|processes|iis
- Synchronize the following data:
- SelectActions > Fetch UIM Groupsto fetch the UIM groups information to the probe configuration.
- In theoi_connectornode >DOI Configurationsection, update the following information that is required to get or post data from the DX Operational Intelligence server.
- Default Tenant ID: specifies the Default Tenant ID at DOI. Each DX Operational Intelligence user can be identified by the Tenant ID.
- For DX Operational Intelligence On-prem environments:
- Obtain and enter the:Tenant ID
- You need to the Tenants IDs from:http://<elasticsearch-endpoint>/ao_tenants_1_1/_search?size=200&prettyPlease note that thesizevalue can be increased as per your requirement by updating the value in the above query. For more information on the default settings in elastic, see Elastic Search.
- For DX Operational Intelligence SaaS environments:
- Obtain theDefault Tenant IDContact theBroadcom SaaS Operationsteam ( ) for the Tenant ID.Example Default Tenant ID,E9DED389-06D3-42BC-B0F5-A3E611373ABC
- : specifies the NginxURL. The probe requires this URL to post alarm, inventory, and metrics data to Nginx.Nginx Ingestion Endpoint(formerly known as Jarvis Ingestion Endpoint)
- For DX Operational Intelligence On-prem environments:
- Obtain and enter theNginx Ingestion Endpoint(formerly known as Jarvis Ingestion Endpoint):For example,http(s)://<Nginx endpoint>/ingestion
- You can obtain the Nginx Ingestion endpoint as follows:
- If you are usingOpenshift:oc get routes -n<namespace> | grep nginxFor example, http://apmservices-gateway.munq001500.abc.com
- If you are usingKubernetes:kubectl get ingresss -n<namespace> | grep nginxFor example, apmservices-gateway.10.109.32.162.nip.io
- For DX Operational Intelligence SaaS environments:
- Obtain and enter theNginx Ingestion Endpoint(formerly known as Jarvis Ingestion Endpoint):https://api.dxi-na1.saas.broadcom.com/ingestion
- Jarvis Elasticsearch URL: specifies the Elasticsearch URL. The probe requires this URL to get the alarm, inventory, and metrics data from Elasticsearch.The probe uses http protocol to communicate with DOI and Elasticsearch. For SaaS environments, the probe uses https protocol with DOI and you need not specify the Elasticsearch URL.
- In theoi_connectornode >Proxy Configurationsection, update the following information that is required to connect to the proxy server. if required.
- Enable Proxy Settings: allows you to enable or disable the network proxy server settings that are used to connect to the DOI platform.Use this option only if proxy information is required to create the connection through a firewall in the network.
- Proxy Server Name: defines the name of the proxy server.
- Proxy Server Port: defines the port to access the proxy server.
- Proxy Username: defines the user name to access the proxy server.
- Proxy Password: defines the password for the specified username.
- SelectActions > Verify Elasticsearchto verify the availability of Elasticsearch URL.
- SelectActions > Verify Jarvisto verify the availability of JarvisURL.
- SelectActions > Verify Tenant IDto verify the availability of the tenant.
- SelectSave.
- In theoi_connectornode >NASS Configurationsection, update the following information that is required to get or post data from the NASS server.
- NASS Urlspecifies the NASS URL. The probe requires this URL to post UIM metrics metadata, metrics values to NASS.
- For DX Operational Intelligence On-prem environments:
- Obtain and enter the NASS URL (apmservices-gateway endpoint)
- You can obtain the NASS URL as follows:
- If you are usingOpenshift:oc get routes -n<namespace> | egrep apmservices-gateway
- If you are usingKubernetes:kubectl get ingress -n<namespace> | grep apmservices-gateway
- For DX Operational Intelligence On-prem environments:
- Enter the NASS URL:https://apmgw.dxi-na1.saas.broadcom.com
- NASS Tenant Tokenspecifies the NASS tenant token. Each NASS user can be identified by the tenant token.
- Obtain Agent/Tenant token.
- Generate an Agent token if you have installed DX APM.
- Generate a Tenant token if you don't have DX APM.
The probe posts the alarm, inventory, and metric data on the DOI at the time interval specified in the probe raw configuration interface.
The probe requires some time to restart on making any changes through the raw configuration interface. We recommend you to restart the probe manually, after waiting for 2-3 minutes.
Enable Multi-tenant Origins
The default probe configuration does not include the option to synchronize your inventory and alarms to multiple tenants in DOI. The probe retrieves the list of origins in your CA UIM environment. You can then map your DOI tenants to CA UIM origins.
Use the raw configure to disable the data ingestion on the default tenant by turning off all alarms, inventory, and subscription before proceeding to enable multi-tenancy.
Follow these steps:
- Open the probe configuration interface.
- In theoi_connectornode >UMP Connection Detailssection, selectConfigure Multitenancyto enable the probe to connect to multiple CA UIM tenants.
- Update the following information to configure identification details of the UMP to retrieve CA UIM origin information.
- UMP Host Name: specifies the hostname of the system where the CA UMP is deployed.
- Username: specifies the CA UIM user that can access the UMP. The probe retrieves the list of origins as applicable for the user.The CA UIM user must be a Bus user with webservices and account administrator permissions.
- Password: specifies the password for the CA UIM user.
- UMP Port: specifies the port of your CA UMP deployment.
- SelectActions>Validate Connectionto verify the connection to the CA UMP deployment.
- Save the configuration.
The probe configuration interface displays the list of all tenants at DOI in the
DOI-Multitenancy Configuration
node. Map Tenants to CA UIM Origins
The probe automatically maps information from your tenants to the primary hub of your CA UIM environment. You can map each tenant to more than one CA UIM origins. However, a CA UIM origin can be mapped only to a single tenant.
If the tenant-origin mapping is available, the probe will not send any data to the default tenant ID and this data is discarded. The UIM group information will always be forwarded to the default tenant ID.
Follow these steps:
- Navigate to theDOI-Multitenancy Configurationnode >DOI-Multitenancy Configurationsection.
- Set or modify the following fields, as required:
- Tenant Id:allows you to select a tenant from the list of tenants. The probe lists tenants that are populated from the DOI server.
- Origins:lets you select the origin from theAvailablelist to theSelectedlist. The probe maps the selected tenant with the origins that are displayed in theSelectedlist.
- SelectActions>Fetch Origin Listto retrieve a list of all CA UIM origins.
- SelectActions>Fetch Tenant Listto retrieve a list of all tenants.You must refresh your browser, after clicking any of the above options from theActionsdropdown to get an updated list.
- Save the configuration.The probe posts data on the DOI server according to the origin-tenant mapping.
DOI SaaS Deployment
The oi_connector probe sends probe metric, alarm, inventory, and group data from CA UIM to DX Operational Intelligence (DOI) SaaS. While sending the CA UIM data to DOI SaaS, consider the following points:
- The DOI Elasticsearch URL field is not mandatory and can be left blank.
- The Verify Tenant ID action does not work.
- The Multi-tenancy configuration is not supported (unless you are using multiple SaaS tenants).
- Use thedxiTenancykey to enable tenant specific data ingestion of all UIM data (alarms, QoS, devices, and CIs) to UIM SaaS through the raw configuration interface. If you enable this key, then multi-tenancy configuration is not required.
Configure Advanced Properties
This section describes advanced configuration settings for the oi_connector probe. These settings let you configure the probe properties using the
Raw Configure
option, which is not possible through standard probe GUI. The following keys are added in the probe Raw Configuration interface
-> Setup
section to improve the probe performance. - uim_device_inventory_sync_interval_in_mins:You can set the value of this key to synchronize the UIM device inventory incremental information to DOI. For example, if you specify theuim_device_inventory_sync_interval_in_minsvalue asinventory information (New / Updated) to DOI every hour.60, the probe synchronizes only last 60 mins deviceDefault: 30 (minutes)
- uim_device_inventory_alive_time_months: You can set the value of this key to synchronize the UIM device inventory information for the last n months to DOI during the startup. For example, if you specify theuim_device_inventory_alive_time_monthsvalueasDOI.Default: 6 (months)12, the probe synchronizes only last 12 months device inventory information to
- process_open_uim_alarms:You can set the value of this key to synchronize the UIM open alarms that are not available in DOI to DOI during the startup. For example, if you specify theprocess_open_uim_alarmsvalue astrue, the Default: trueAfter the synchronization is complete, this flag is disabled to prevent repeated open alarm synchronizations with every start or restart.
- get_ci_attributes: The probe displays the configuration item attributes (docker_id) in the CA UIM Configuration Items Inventory.Default: false
- bulk_size: The probe retrieves alarms and inventory information from the queues present on the hub and sends this information to DOI depending on the bulk size value that is specified for this key. For example, if you specify thebulk_sizevalue as 1000, the probe retrieves a list of 1000 alarms and inventory in one iteration from the hub queue.Default: 500
- dxiTenancy:(UIM SaaS only) Use thedxiTenancykey to enable tenant specific data ingestion of all UIM data (alarms, QoS, devices, and CIs) to UIM SaaS through the raw configuration interface. If you enable this key, then multi-tenancy configuration is not required.
- payload_bulk_size: The probe sub-divides the alarms and inventory information that is received in a bulk into smaller chunks based on the payload bulk size value that is specified for this key. For example, if thebulk_sizevalue is specified as 1000, and thepayload bulk_sizevalue is specified as 500, then the probe retrieves alarms and inventory information in two chunks (of 500 each) from the hub queue and sends this information to DOI.Default: 500
- qos_payload_bulk_size: The probe sub-divides the QoS information that is received in a bulk into smaller chunks based on the payload bulk size value that is specified for this key.Default: 500
- qos_bulk_size: The probe retrieves QoS information from the queues present on the hub and sends this information to DOI depending on the bulk size value that is specified for this key.Default: 500
- task_count: The probe retrieves alarms, inventory, and QoS information from the queues present on the hub by task count. For example, if you specify thetask_countvalue as 50, the probe retrieves a maximum of 50 entries from the hub queue at a time.Default: 100
- schedule_time_minutes: The probe retrieves the Group Cache Data for UIM alarms and inventory according to the value set through this key. For example, if you specify theschedule_time_minutesvalue as 10, the probe retrieves the Group ID and Group Name data for UIM alarms and inventory and updates the cache for the same in every ten minutes.Default: 30
- schedule_time_hours: You can set the value of this key to schedule the synchronization of UIM inventory information to DOI. For example, if you specify theschedule_time_hoursvalue as 4, the probe sends this information to DOI after every four hours.Default: 5 (Minimum time configurable is 1 hour)
- group_using_account:You can set the value for this key as True to enable the probe to filter UIM device groups based on the account.Default: False
- enableServiceAnalytics:You can set the value for this key as True to enable the probe to populate services_impacted in UIM alarm index.Default: False.
- uimTroubleTicketField:ThetroubleTicketvalue for UIM alarms from this field. You can set a value ranging from custom_1 to custom_5 for this field.Default: custom_1
- retention_period:You can set the value for this key to define retention period for all the queue messages. If DOI ingestion remains down for the defined period, the probe starts discarding the messages from the queue.Default: 120 minutes
- axagateway_alarm_severity: You can set the value of this key to define severity of the alarm that is generated by the oi_connector probe. For example,“UIM QoS que is down”. The default severity is 5 (critical).Default: 5
- generate_uim_queue_down_alarm:You can set the value of this key to enable or disable the alarm that is generated by the probe when a queue is down. The default isTrue.False, no queue down alarm is generated.
- generate_doi_monioring _down_alarm:You can set the value of this key to enable or disable the alarm that is generated by the probe when DOI (DOI, Elasticsearch, or tenant) is not available. Default valueTrue. If the value is set asFalse, the probe does not generate any DOI down alarm
Use Regular Expressions
The oi_connector probe uses regular expressions several times during probe configuration. For example, specifying the regular expression cdm|aws|openstack|docker in
UIM Configuration > Selected QoS Probes
field enables the forwarding of QoS messages from the cdm
, aws
, openstack, and
docker
probes to DOI. You can also filter data based on the metric_type, using the following key:
metric_regex = .*
You can customize the key value from the Raw Configure page. For example, if you customize the value as
metric_regex
= 1.6:2|1.6:5|1.6:7|1.6:9|1.5:1|1.5:36|1.1:3|1.1:14 then only the defined metrics are posted to Jarvis based on the metric_type.A regular expression (RegEx for short) is a special text string for describing a search pattern. Constructing regular expression and pattern matching requires meta characters. The probe supports Java Regular Expression, which are enclosed within forward slash
(/)
.You can also use simple text with some wildcard operators for matching the target string. For example,
*test*
expression matches the text test
in target string.