Integrating with TrueSight Operations Management

TrueSight Operations Management is a software that enables you to monitor performance and availability of the infrastructure and applications that comprise your services; monitor events coming from the infrastructure devices; and monitor transactions from the applications that enable the services they deliver. As a tenant administrator, you use BMC Helix Developer Tools to add, edit, and delete integrations with TrueSight Operations Management.

Enabling, disabling, or deleting integrations

Troubleshooting the TrueSight Operations Management integration

Event slot update

BMC Helix Developer Tools gets data updates that come in from the third-party products. If the data is updated in the third-party products, the changes are also applied in BMC Helix Developer Tools. For example, if data for an event is updated in a third-party product, the changes are applied in BMC Helix Developer Tools and event slots get overwritten in BMC Helix Operations Management.

Before you begin

Ensure that you have downloaded and installed the connector. Without downloading the connector, you cannot proceed with the integration.

Important

Download the script on a docker-enabled Linux server.
Confirm that the TrueSight Operations Management host is accessible from your docker-enabled Linux server.

To integrate with TrueSight Operations Management

Log on to BMC Helix Portal, and click Launch on BMC Helix Developer Tools.
Click Available integrations.
On the TrueSight Operations Management tile, click Configure.
Enter the following source details:
- Integration Name: Provide a name for the integration.
- Select Connector: Select the connector you have downloaded. If you didn't download the connector earlier, click Add Connector to download and install the connector.
- User Name and Password: Enter the administrator credentials for the product to be integrated.
- API URL: Add the following information:
  - If TrueSight Operations Management is deployed in a high-availability environment, enter the URL of the TrueSight Presentation Server load balancer.
  - If TrueSight Operations Management is not deployed in a high-availability environment, enter the TrueSight Presentation Server URL.
- Tenant Name: Enter the name of the tenant where TrueSight Operations Management is installed.
- Refresh Time For Event In Seconds: Enter the time interval in seconds to refresh the event data.
- Refresh Time For CI In Hours: Enter the time interval in hours after which the TrueSight Operations ManagementCI is refreshed.
- Select entities to be registered: Select one or all of the available entities to view their data. You can view the data in BMC Helix Dashboards .
Click Configure.
The added integration appears in the Configured Integrations tab with the integration status as CONFIGURING. After the integration is configured completely, the status changes to CONNECTED.

To view the configured integration

You can view the configured integrations on the Configured Integrations tab, as shown in the following example:

The configured integration shows the following details:

The name of the integration with its build number.
The incoming data. In this example, 25 CIs and 1,572 events have been received.
The name of the user who modified the integration along with the time of the modification. In this example, it is the admin user.
The connector status. In this example, the status is Active.

To validate the TrueSight Operations Management integration

Ensure that the status of the integration is CONNECTED.
From BMC Helix Operations Management, go to Events to ensure that you can see events in BMC Helix Operations Management.
For more information, see Event monitoring .
From BMC Helix Discovery, go to Explore > Data, and then click <number> Import Records in the Miscellaneous section to ensure that you can see the records from the source (host) in BMC Helix Discovery. Use these records further to create a business service model for the source depending on your use case requirements in BMC Helix Discovery. For more information, see Creating a model .

TrueSight Operations Management event slot mapping

The following table shows the event slot mapping between TrueSight Operations Management and BMC Helix Operations Management.

Event slots in TrueSight Operations Management	Corresponding event slots in BMC Helix Operations Management
`event_handle`	`_handle`
`mc_ueid`	`_identifier`
`mc_host_address`	`source_address`
`mc_host`	`source_hostname`
`mc_location`	`location`
`TSOM,<integration_ID>,mc_host`	`source_identifier`
`mc_object`	`object`
`mc_object_class`	`object_class`
`pn_object_id`	`object_id`
`mc_event_category`	`category`
`mc_event_subcategory`	`sub_category`
`date_reception`	`creation_time`
`mc_priority`	`priority`
`mc_long_msg`	`details`
`mc_owner`	`user_assigned`
`repeat_count`	`_repeat_count`
`mc_notes`	`_notes`
`mc_operations`	`_operations`
`mc_smc_id`	`_ci_id`
`mc_smc_alias`	`alias`
`mc_object_owner`	`_tenant_id`
`mc_using_organization`	`_tenant_name`
`mc_bad_slot_names`	`_badslot_names`
`mc_bad_slot_values`	`_badslot_values`
`mc_abstraction`	`_abstraction`
`mc_abstracted`	`_abstracted`
`mc_associations`	`_associations`
`mc_cause`	`_cause`
`mc_effects`	`_effects`
`mc_event_relations`	`_relations`
`mc_relation_source`	`_relation_source`
`mc_timeout`	`_timeout`
`p_agent`	`p_publish_hostname`
`pn_thresh_above`	`al_thresh_above`
`pn_baseline_type`	`al_baseline_type`
`pn_end_time`	`al_end_time`
`pn_last_time`	`al_last_time`
`pn_object_class_id`	`object_class`
`mc_parameter`	`al_parameter_name`
`mc_parameter_value`	`al_parameter_value`
`mc_parameter_unit`	`al_parameter_unit`
`pn_thresh_duration`	`al_thresh_duration`
`pn_thresh_id`	`al_thresh_id`
`pn_thresh_type`	`al_thresh_type`
`pn_extremeness`	`al_extremeness`
`pn_alarm_id`	`al_alarm_id`
`pn_highest_severity`	`al_highest_severity`
`pn_is_predicted`	`al_is_predicted`
`pn_old_severity`	`al_old_severity`
`pn_predict_to_occur_time`	`al_predict_to_occur_time`
`pn_predicted_severity`	`al_predicted_severity`
`pn_avg_value`	`al_avg_value`
`pn_baseline_daily_high`	`al_baseline_daily_high`
`pn_baseline_daily_low`	`al_baseline_daily_low`
`pn_baseline_hourly_high`	`al_baseline_hourly_high`
`pn_baseline_hourly_low`	`al_baseline_hourly_low`
`pn_baseline_weekly_high`	`al_baseline_weekly_high`
`pn_baseline_weekly_low`	`al_baseline_weekly_low`
`pn_event_score`	`al_event_score`
`pn_pts_exceeded`	`al_pts_exceeded`
`pn_pts_total`	`al_pts_total`
`mc_parameter_threshold`	`al_parameter_threshold`
`pn_device_name`	`al_agent_name`

TrueSight Operations Management enum mapping

The following table shows the enum mapping between TrueSight Operations Management and BMC Helix Operations Management.

enums in TrueSight Operations Management	Corresponding values in BMC Helix Operations Management
`MC_EVENT_CATEGORY`	`CATEGORY`
`MC_PRIORITY`	`PRIORITY`
`MC_EVENT_SUBCATEGORY`	`SUB_CATEGORY`
`APM_APP_SEVERITY`	`SEVERITY`
`array`	`name`