Accessing User_tag from CA UIM Alerts in SOI

Products

• CA Service Operations Insight (SOI)

Issue/Introduction

Users receiving alerts in SOI that originate from CA UIM need to identify and access the User_tag fields (such as os_user1, os_user2, user_tag1, or user_tag2) within the SOI alert payload for better alert correlation and troubleshooting.

Environment

Product: CA Service Operations Insight
(SOI) Component: UIM Connector

Cause

By default, the UIM connector for SOI does not map custom user tags from the UIM alert payload to specific SOI alert attributes. A manual configuration change in the connector policy is required to enable this mapping.

Resolution

To extract the User tag from the UIM alert payload and display it in the SOI Console, follow these steps to modify the UIM connector policy:

1. Identify the Source Field: Determine which UIM field contains the required tag (e.g., os_user1, os_user2, user_tag1, or user_tag2).
2. Stop the Connector: Stop the CA Catalyst Connector service on the connector server.
3. Locate the Policy File:
   • Standard Path: CA\Catalyst\CatalystConnector\registry\topology\physical\_CatalystConnector\modules\policy\nimsoftconnector_policy.xml
   • IFW Container Path: CA\SOI\resources\Core\Catalogpolicy\nimsoftconnector_policy.xml
4. Modify the XML: Open the nimsoftconnector_policy.xml file and locate the <EventClass name='Alert'> section. Add a mapping entry to link the UIM property to an available SOI attribute (e.g., userAttribute1).
   <EventClass name="Alert">
   
   <Format>
   
   <Field output='userAttribute1' format='{0}' input='user_tag1' />
   
   <Field output='userAttribute2' format='{0}' input='user_tag2' />
   
   </Format>
   
   </EventClass>
5. Start the Connector: Start the CA Catalyst Connector service.
6. Verification: Once a new alert is published from UIM, verify that the tag data appears in the userAttribute1 (or your chosen attribute) column in the SOI Console.

UIM robot shows user_tag_2 is set

SOI Console shows the value of user_tag_2 in userAttribute2