Integrating with TrueSight Operations Management
Before you begin
Ensure that you have downloaded and installed the connector. Without downloading the connector, you cannot proceed with the integration.
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 TrueSight Operations Management tenant (realm).
- 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 Monitoring and managing events.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 Managing models.
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 |